Elastic Container Instance:VNodectl を使用してセルフマネージド Kubernetes クラスターに VNode をデプロイする

前提条件

• バージョン 1.16 から 1.30 の Kubernetes クラスターがデプロイされている。

• Kubernetes クラスターがデータセンターにデプロイされている場合は、データセンターと Elastic Container Instance ベースのポッドが属する仮想プライベートクラウド (VPC) が Express Connect、Smart Access Gateway、または VPN Gateway を使用して相互に接続されていることを確認してください。詳細については、以下のトピックをご参照ください。

  • Express Connect とは

  • SAG とは

  • VPN Gateway とは

準備

セルフマネージド Kubernetes クラスターに VNode をデプロイする前に、VNode の作成に必要なパラメータ情報を準備し、クラスターに VNode をデプロイするために必要な権限を理解しておいてください。次の表に、VNode の作成に必要なパラメータを示します。

VNode を作成するには、次の表に示すように、ネイティブ Kubernetes ノードの標準権限と VNode の追加権限を構成する必要があります。

VNodectl のインストール

VNodectl を使用してセルフマネージド Kubernetes クラスターに VNode をデプロイする前に、VNodectl をインストールする必要があります。クラスター環境に基づいてインストール パッケージを入手し、VNodectl をインストールします。

Kubernetes クラスターの Master ノードに VNodectl をインストールすることをお勧めします。 VNodectl をインストールするには、次の操作を実行します。

1. Kubernetes クラスターに接続します。

2. VNodectl のインストール パッケージをダウンロードします。

   wget https://eci-docs.oss-cn-beijing.aliyuncs.com/vnode/vnodectl_0.0.5-beta_linux_amd64.tar.gz -O vnodectl.tar.gz 

3. ダウンロードした VNodectl のパッケージ ファイルを展開します。

   tar xvf vnodectl.tar.gz 

4. 展開したパッケージ ファイルを指定したディレクトリにコピーします。

   cp vnodectl /usr/local/bin/vnode

クラスターの構成

VNode を作成する前に、VNode の kubeconfig 証明書を生成する必要があります。その後、kubeconfig を使用してセルフマネージド Kubernetes クラスターに VNode をデプロイできます。 kubeconfig は、TLS ブートストラップ モードまたは ServiceAccount モードで生成できます。

~/.vnode/config ファイルの構成

~/.vnode/config ファイルには、VNode の構成情報が含まれています。 VNodectl は、実行時にこのファイルを読み取ります。 VNode を作成する前に、このファイルを構成する必要があります。

1. VNode の実行に必要な構成情報を実行します。

   vnode config default

   次の表に、構成情報におけるコンテキストのパラメータを示します。

   パラメータ	必須	説明
   name	はい	コンテキストの名前。
   vnode-name	いいえ	VNode の名前。システムが一意の値を生成できるように、このパラメータを構成しないことをお勧めします。
   region-id	はい	VNode が存在するリージョンの ID。リージョンの選択方法については、このトピックの準備を行うセクションをご参照ください。
   access-key-id	はい	API オペレーションを呼び出すときは、AccessKey ペアを使用して ID 検証を完了する必要があります。 AccessKey ペアは、AccessKey ID と AccessKey シークレットで構成されます。詳細については、「AccessKey ペアを作成する」をご参照ください。
   access-key-secret	はい
   vswitch-id	はい	VNode が関連付けられている vSwitch の ID。複数の vSwitch を指定できます。 vSwitch の作成方法については、このトピックの準備を行うセクションをご参照ください。
   security-group-id	はい	VNode が属するセキュリティグループの ID。セキュリティグループの作成方法については、このトピックの準備を行うセクションをご参照ください。
   resource-group-id	いいえ	VNode が属するリソース グループ。 リソース グループとは、Alibaba Cloud アカウント内のリソースをグループで管理するメカニズムです。各 Alibaba Cloud アカウントには、デフォルトのリソース グループが割り当てられています。詳細については、「リソース管理とは」をご参照ください。 リソース グループを指定しない場合、VNode はデフォルトのリソース グループに追加されます。
   kubeconfig	はい	クラスターに VNode をデプロイするために必要な kubeconfig 証明書のパス。このパスは、クラスターを構成した後に自動的に生成されます。デフォルトでは、kubeconfig 証明書は ~/.vnode/deploy/kubeconfig に保存されます。
   taints	いいえ	VNode にバインドされている taint。
   tags	いいえ	VNode にバインドされているタグ。 タグは分割請求の管理に使用できます。カスタム タグを VNode にバインドした後、料金分析を表示する際に、そのタグを使用して VNode 内のインスタンスの課金料金をフィルタリングできます。詳細については、「タグに基づいて分割請求を表示する」をご参照ください。
   network-type	いいえ	VNodectl がアクセスする Elastic Container Instance のコントロール サービスのネットワーク タイプ。 このパラメータはデフォルトでは空のままです。これはインターネットを指定します。 VNodectl が VPC に属している場合は、このパラメータを vpc に設定します。これは VPC を指定します。

2. 構成情報を ~/.vnode/config ファイルにリダイレクトし、ファイル内のパラメータを構成します。

   vnode config default > ~/.vnode/config
   vim ~/.vnode/config

   ビジネス要件に基づいて ~/.vnode/config ファイルの内容を変更します。次の例では、必要なパラメータのみが構成されています。

   kind: vnode
   contexts:
       - name: default
         region-id: cn-guangzhou
         access-key-id: <yourAccessKeyID>
         access-key-secret: <yourAccessKeySecret>
         vswitch-id: vsw-7xv2yk45qp5etidgf****
         security-group-id: sg-7xv5tcch4kjdr65t****
         kubeconfig: ~/.vnode/deploy/kubeconfig
   current-context: default

3. VNode の実行時に VNode によって読み取られる構成情報を検証します。

   vnode config

4. VNode の実行時に VNode がコンテキスト内の構成を読み込むようにコンテキストを切り替えます。

   vnode config set-context <context-name>

VNode の作成

1. VNode を作成します。

   vnode create

   説明

   VNode は ~/.vnode/config ファイルの構成に基づいて作成されます。 customResources、clusterDNS、clusterDomain を構成するためのパラメータを追加できます。詳細については、「VNode を管理する」をご参照ください。

   次の出力例が返されます。 VirtualNodeId の値は、生成された VNode の ID です。

   {"RequestId":"AB772F9D-2FEF-5BFD-AAFB-DA3444851F29","VirtualNodeId":"vnd-7xvetkyase7gb62u****"}

2. VNode のステータスを表示します。

   vnode list

   次の出力例が返されます。 STATUS 値が Ready の場合、VNode は作成されています。

   VNODE ID                    VNODE NAME                                   CREATED          STATUS    SCHEDULABLE ZONES
   vnd-7xvetkyase7gb62u****    vnode-cn-guangzhou-a-7xvetkyase7gb62u****    2 minutes ago    Ready     cn-guangzhou-a

3. ノードに関する情報を表示します。

   kubectl get node

   次の出力例が返され、VNode がクラスターにデプロイされていることが示されます。

   NAME                                    STATUS     ROLES                  AGE    VERSION
   cn-guangzhou.vnd-7xvetkyase7gb62u****   Ready      agent                  174m   v1.20.6
   vnode-test001                           Ready      control-plane,master   23h    v1.20.6
   vnode-test002                           Ready      <none>                 22h    v1.20.6

DaemonSet が VNode にスケジュールされないようにする

VNode は実際のノードではないため、DaemonSet は VNode 上で実行できません。 VNode を作成した後、kube-proxy の DaemonSet を変更し、nodeAffinity を構成して、DaemonSet が VNode にスケジュールされないようにする必要があります。

1. DaemonSet の構成を変更します。

   kubectl -n kube-system edit ds kube-proxy

2. nodeAffinity を構成します。

   spec.template.spec に次の YAML コンテンツを追加します。

   affinity:
     nodeAffinity:
       requiredDuringSchedulingIgnoredDuringExecution:
         nodeSelectorTerms:
         - matchExpressions:
           - key: type
             operator: NotIn
             values:
             - virtual-kubelet

VNode へのポッドのスケジュール

VNode を作成した後、次のいずれかの方法を使用してポッドを VNode にスケジュールできます。その後、ポッドを VNode 内のエラスティックコンテナインスタンスとして実行できます。

• 手動スケジュール

  nodeSelector パラメータと tolerations パラメータを構成するか、nodeName パラメータを指定して、ポッドを VNode にスケジュールできます。詳細については、「VNode にポッドをスケジュールする」をご参照ください。

• 自動スケジュール

  eci-profile コンポーネントをデプロイした後、Selector パラメータを指定できます。こうすることで、システムは Selector によって指定された条件を満たすポッドを VNode に自動的にスケジュールします。詳細については、「eci-profile を使用して VNode にポッドをスケジュールする」をご参照ください。

参照

• セルフマネージド ECS Kubernetes クラスターに VNode をデプロイして Elastic Container Instance を使用する

• VNodectl の共通コマンド