Elastic Container Instance:VNodectl を使用して自己管理型 Kubernetes クラスターに VNode をデプロイする

前提条件

• バージョン 1.13 から 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 クラスターのマスターノードに 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 Secret で構成されます。詳細については、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 にバインドされているテイント。
   tags	いいえ	VNode にバインドされているタグ。 タグを使用して分割請求を管理できます。カスタムタグを VNode にバインドした後、料金分析を表示するときに、そのタグを使用して VNode 内のインスタンスの課金料金をフィルタリングできます。詳細については、タグに基づいて分割請求を表示するを参照してください。

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: LTAI5tJbBkHcHBUmuP7C****
         access-key-secret: 5PlpKJT6sgLcD4f9y5pACNDbEg****
         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 を設定します。

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

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

VNodeへのPodのスケジュール

VNodeを作成した後、次のいずれかの方法を使用して、PodをVNodeにスケジュールできます。その後、PodをVNode内のElastic Container Instanceとして実行できます。

• 手動スケジューリング

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

• 自動スケジューリング

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

参考資料

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

• VNodectl の一般的なコマンド