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

前提条件

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

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

  • Express Connect とは？

  • Smart Access Gateway（SAG）とは？

  • VPN Gateway とは？

事前準備

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

VNode を作成するには、ネイティブ Kubernetes ノード用の標準権限および VNode 用の追加権限を設定する必要があります。以下に、各権限の内容を示します。

VNodectl のインストール

VNodectl を使用する前に、CLI をインストールしてください。ご利用の環境に応じたインストールパッケージを取得し、VNodectl をインストールします。

VNodectl のインストール先として、Kubernetes クラスターのマスターノードを推奨します。VNodectl のインストール手順は以下のとおりです：

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

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

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

3. パッケージを展開します。

   tar xvf vnodectl.tar.gz 

4. vnodectl をディレクトリにコピーします。

   cp vnodectl /usr/local/bin/vnode

クラスターの構成

VNode は kubeconfig ファイルを使用してクラスターに接続します。VNode を作成する前に、VNode 用の kubeconfig ファイルを生成してください。kubeconfig ファイルは TLS Bootstrap モードまたは ServiceAccount モードで生成できます。

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

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

1. VNode 実行に必要な構成を表示します。

   vnode config default

   以下の表に、構成内の contexts セクションのフィールドを示します。

   フィールド	必須	説明
   name	はい	コンテキストの名前です。
   vnode-name	いいえ	VNode の名前です。このフィールドは設定しないでください。システムが自動的に一意の名前を生成します。
   region-id	はい	VNode が配置されるリージョンの ID です。リージョンの選択方法については、「事前準備」をご参照ください。
   access-key-id	はい	Alibaba Cloud の API 操作を呼び出す際に、本人確認を完了するために AccessKey ペアを使用します。AccessKey ペアは AccessKey ID と AccessKey Secret で構成されます。詳細については、「AccessKey ペアの作成」をご参照ください。
   access-key-secret	はい
   vswitch-id	はい	VNode に関連付けられた vSwitch の ID です。複数の vSwitch を指定できます。vSwitch の作成方法については、「事前準備」をご参照ください。
   security-group-id	はい	VNode が属するセキュリティグループの ID です。セキュリティグループの作成方法については、「事前準備」をご参照ください。
   resource-group-id	いいえ	VNode が属するリソースグループです。 リソースグループは、Alibaba Cloud アカウント内のリソースをグループ化する仕組みです。各アカウントにはデフォルトのリソースグループがあります。詳細については、「Resource Management」をご参照ください。 リソースグループを指定しない場合、VNode はデフォルトのリソースグループに所属します。
   kubeconfig	はい	VNode をクラスターに接続するために必要な kubeconfig ファイルのパスです。このパスは、クラスターの構成後に自動的に生成されます。デフォルトでは、kubeconfig ファイルは ~/.vnode/deploy/kubeconfig に保存されます。
   taints	いいえ	VNode にバインドされる Taint です。
   tags	いいえ	VNode にバインドされるタグです。 タグは、請求額の分割管理に役立ちます。VNode にカスタムタグをバインドすると、コスト分析で VNode に課金されたインスタンス料金をフィルター処理できます。詳細については、「タグによる分割請求額の表示」をご参照ください。
   network-type	いいえ	VNodectl が ECI コントロールサービスのエンドポイントにアクセスする際に使用するネットワークタイプです。 インターネットエンドポイントを使用する場合は、このフィールドを空のままにしてください。 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 config

4. コンテキストを切り替えて、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 への Pod のスケジュール

VNode を作成した後は、以下のいずれかの方法を使用して Pod を VNode にスケジュールできます。その後、Pod を VNode 上で弾性コンテナインスタンスとして実行できます。

• 手動スケジュール

  nodeSelector および tolerations パラメーターを構成するか、nodeName パラメーターを指定することで、Pod を VNode にスケジュールできます。詳細については、「VNode への Pod のスケジュール」をご参照ください。

• 自動スケジュール

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

関連ドキュメント

• VNodectl の一般的なコマンド