Container Service for Kubernetes:ポッドごとに静的 IP アドレス、個別の vSwitch、および個別のセキュリティグループを構成する

ステップ 2: PodNetworking を作成する

Terway では、PodNetworking という名前のカスタムリソース定義 (CRD) を使用してネットワーク構成を記述できます。複数の PodNetworking を作成して、異なるネットワークプレーンを設計できます。

1. ACK コンソール にログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、管理するクラスターを見つけ、その名前をクリックします。左側のペインで、[ワークロード] > [カスタムリソース] を選択します。

3. [カスタムリソース] ページで、[CRD] タブをクリックし、[YAML から作成] をクリックします。

   次のコードブロックは、PodNetworking のサンプルを示しています。

   apiVersion: network.alibabacloud.com/v1beta1
   kind: PodNetworking
   metadata:
     name: example
   spec:
     allocationType:
       type: Fixed # ポッドへの IP アドレスの割り当て方法を記述するポリシー。有効な値: Elastic および Fixed。
       releaseStrategy: TTL # このパラメーターは、PodNetworking が Fixed ポリシーを使用する場合にのみ有効です。 PodNetworking が Elastic ポリシーを使用する場合は、releaseStrategy パラメーターと releaseAfter パラメーターを構成する必要はありません。
       releaseAfter: "1h" # このパラメーターは、releaseStrategy が TTL に設定されている場合にのみ有効です。
     selector:
       podSelector:
         matchLabels:
           foo: bar
       namespaceSelector:
         matchLabels:
           foo: bar
     securityGroupIDs:
     - sg-bpxxxx
     vSwitchOptions:
     - vsw-bpxxxx
   status:
     status: Ready               

   次の表にパラメーターを示します。

   パラメーター		説明
   allocationType (ポッドへの IP アドレスの割り当て方法を記述するポリシー)	type	有効な値: Elastic: エラスティック IP アドレス (EIP) をポッドに割り当てます。 IP アドレスは、ポッドが削除された後に解放されます。 Fixed: 静的 IP アドレスをポッドに割り当てます。 このモードを有効にした後、PodNetworking は固定名を持つポッドにのみ有効になります。デフォルトでは、StatefulSet と ownerReferences のないポッドがサポートされています。カスタムワークロードを構成する必要がある場合は、コンポーネント管理で terway-controlplane を構成します。 説明 Fixed ポリシーを使用する場合、ポッドが再作成されるゾーンが元のゾーンと同じになるように制約が追加されます。
   	releaseStrategy	IP アドレスの解放方法を記述するポリシー。このパラメーターは、type が Fixed に設定されている場合にのみ有効です。有効な値: TTL: IP アドレスは遅延して解放されます。ポッドが削除された後、指定された期間が終了するまで、ポッドの IP アドレスは解放されません。最小値は 5 分です。 Never: IP アドレスは解放されません。 IP アドレスが使用されなくなった場合は、手動で PodENI を削除する必要があります。
   	releaseAfter	ポッド IP アドレスを解放するための遅延。このパラメーターは、releaseStrategy が TTL に設定されている場合にのみ有効です。値は Go time 型である必要があります。単位: 時間 (h) および分 (m)。例: 2h45m または 5m0s。詳細については、「Go time 型」をご参照ください。
   selector (現在の PodNetworking を使用するポッドを選択するために使用されるラベルセレクター)	podSelector	ポッドラベルと一致するために使用されるセレクター。このセレクターと一致するポッドは、現在の PodNetworking を使用します。 podSelector と namespaceSelector の両方が構成されている場合、両方のセレクターと一致するポッドのみが現在の PodNetworking を使用します。 ポッドのラベルが 1 つの PodNetworking ConfigMap の [セレクター] のみに一致することを確認してください。ポッドが複数の PodNetworking ConfigMap と一致する場合、ポッドは任意の PodNetworking ConfigMap のネットワーク構成を使用します。
   	namespaceSelector	名前空間ラベルと一致するために使用されるセレクター。このセレクターと一致するポッドは、現在の PodNetworking を使用します。 podSelector と namespaceSelector の両方が構成されている場合、両方のセレクターと一致するポッドのみが現在の PodNetworking を使用します。 ポッドのラベルが 1 つの PodNetworking ConfigMap の [セレクター] のみに一致することを確認してください。ポッドが複数の PodNetworking ConfigMap と一致する場合、ポッドは任意の PodNetworking ConfigMap のネットワーク構成を使用します。
   vSwitchOptions	-	ポッドが使用する vSwitch を指定します。複数の vSwitch 間の論理関係は OR です。各ポッドは 1 つの vSwitch のみを使用できます。 Terway は、各ポッドに適切な vSwitch を自動的に選択します。 ポッドをスケジュールできるゾーンが、vSwitchOptions パラメーターで指定した vSwitch のゾーンと同じになるように制約が追加されます。 vSwitchOptions の vSwitch のゾーンが、ポッドのスケジュール先ノードのゾーンと同じであることを確認してください。また、これらの vSwitch が十分なアイドル IP アドレスを提供できることを確認してください。そうでない場合、ACK はポッドの作成に失敗します。 説明 ノードの自動スケーリングを有効にしている場合、vSwitchOptions パラメーターを使用して追加されたアベイラビリティーゾーンの制限により、ノードプールがスケールアウトできない場合があります。詳細については、「ノード自動スケーリングに関するよくある質問」をご参照ください。
   vSwitchSelectOptions (使用する vSwitch を決定するポリシー)	vSwitchSelectionPolicy	有効な値: ordered: これはデフォルト値です。 vSwitch は入力された順序で使用されます。 most: 使用可能な IP アドレスが最も多い vSwitch を優先的に使用します。 random: vSwitch はランダムに選択されます。 説明 Terway v1.11.0 以降でサポートされています。
   securityGroupIDs	-	セキュリティグループの ID を指定します。複数のセキュリティグループが同時に有効になります。最大 5 つのセキュリティグループを指定できます。
   eniOptions (ポッドが使用する ENI の種類)	eniType	有効な値: Default: これはデフォルトモードです。 Terway 共有 ENI モードで実行されているクラスターでは、Trunk ENI モードが使用されます。 Terway ENI 排他モードで実行されているクラスターでは、排他的 ENI モードが使用されます。 ENI: 排他的 ENI モードを使用します。 Trunk: Trunk ENI モードを使用します。 説明 Terway v1.11.0 以降でサポートされています。

4. [作成] をクリックします。

   PodNetworking が作成されると、Terway はネットワーク構成を自動的に同期します。 PodNetworking は、PodNetworking の status が Ready に変更された後にのみ、ポッドに有効になります。

   次のコマンドを実行して、リソースステータスが ready かどうかを確認します。

   kubectl describe PodNetworking example # example を実際のカスタムリソース名に置き換えます。

(オプション) ステップ 3: 名前空間にラベルを追加する

PodNetworking をデプロイした後、名前空間にラベルを追加することで、名前空間が PodNetworking ルールと一致するように、指定された名前空間に同じラベルを追加する必要があります。

1. 次のコマンドを実行して、example という名前のテスト名前空間を作成します。

   kubectl create ns example

2. 次のコマンドを実行して、foo=bar ラベルを名前空間に追加します。

   kubectl label namespaces example foo=bar # example を実際の名前空間名に置き換えます。

3. 次のコマンドを実行して、名前空間のラベルをクエリします。

   kubectl get namespace example --show-labels # example を実際の名前空間名に置き換えます。

   予期される出力:

    NAME      STATUS   AGE   LABELS
   example   Active   24s   foo=bar,kubernetes.io/metadata.name=example

(オプション) ステップ 4: ポッドを作成する

ACK がポッドを作成すると、ポッドのラベルが PodNetworking と照合されます。ポッドが PodNetworking と一致しない場合、デフォルトでは、共有 ENI から IP アドレスがポッドに割り当てられます。ポッドが PodNetworking と一致する場合、PodNetworking で指定された構成に基づいて IP アドレスがポッドに割り当てられます。

Terway は、PodNetworking と一致するポッドに対して、PodENI という名前の CRD を自動的に作成します。 PodENI は、ポッドのリソース使用量を追跡するために使用されます。 PodENI は Terway によって管理されます。ポッドラベルの詳細については、「ラベルとセレクター」をご参照ください。

1. 次の YAML テンプレートを使用して、my-nginx.yaml ファイルを作成します。

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: my-nginx # アプリケーションの名前。
     namespace: example # 名前空間名を example として指定します。
     labels:
       app: nginx
   spec:
     serviceName: "nginx-service"  
     replicas: 1    
     selector:
       matchLabels:
         app: nginx 
     template:
       metadata:
         labels:
           app: nginx
           foo: bar # ポッドに foo: bar ラベルを追加します。
       spec:
         containers:
         - name: nginx
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           ports:
           - containerPort: 80  
   
   StatefulSet に永続ストレージが必要な場合は、volumeClaimTemplates パラメーターを設定する必要があります。
   # 例:
   #  volumeClaimTemplates:
   #  - metadata:
   #      name: nginx-storage
   #    spec:
   #      accessModes: ["ReadWriteOnce"]
   #      storageClassName: "my-storage-class"
   #      resources:
   #        requests:
   #          storage: 1Gi

2. 次のコマンドを実行して、my-nginx という名前のサンプルアプリケーションをデプロイします。ポッドがデプロイされたら、構成を確認します。詳細については、「ポッドが PodNetworking ConfigMap で指定されたネットワーク構成を使用しているかどうかを確認する方法」をご参照ください。

   kubectl apply -f my-nginx.yaml