Container Service for Kubernetes:Pod に独立した EIP をアタッチする

アノテーションを使用して指定された Pod に EIP を作成して関連付ける

Pod にアノテーションを指定することで、EIP を作成して Pod に関連付けることができます。アノテーションの詳細については、このトピックの「よくある質問」セクションをご参照ください。

1. アプリケーションを作成し、指定された Pod に EIP を作成して関連付けます。

   Deployment

   次の例を使用してデプロイメントを作成します。帯域幅が 5 Mbit/s の EIP インスタンスが各 Pod に自動的に割り当てられます。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: example
     labels:
       app: example
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: example
     template:
       metadata:
         labels:
           app: example
         annotations:
           k8s.aliyun.com/pod-with-eip: "true"
           k8s.aliyun.com/eip-bandwidth: "5"
       spec:
         readinessGates:
         - conditionType: "k8s.aliyun.com/eip"
         containers:
         - name: example
           image: nginx

   Pod が作成された後、Pod と同じ名前の podeips.alibabacloud.com リソースをクエリして、割り当てられた EIP に関する情報を追跡できます。

   kubectl get podeip -n <namespace> <podname>  -o yaml

   期待される出力:

   apiVersion: alibabacloud.com/v1beta1
   kind: PodEIP
   metadata:
     creationTimestamp: "2023-12-15T04:25:37Z"
     finalizers:
     - podeip-controller.alibabacloud.com/finalizer
     generation: 1
     name: example-xxx
     namespace: default
     resourceVersion: "222800"
     uid: 43xxx-f1xx-4xxx-b3xx-969faxxx
   spec:
     allocationID: eip-2ze2qe8zsxxx
     allocationType:
       releaseStrategy: Follow
       type: Auto
   status:
     eipAddress: 39.102.XX.XX
     internetChargeType: PayByTraffic
     isp: BGP
     networkInterfaceID: eni-2zeagv8f3xxxx
     podLastSeen: "2023-12-15T05:18:47Z"
     privateIPAddress: 192.168.XX.XX
     resourceGroupID: rg-acfmwxxxxxsq
     status: InUse

   StatefulSet

   次の例を使用して StatefulSet リソースを作成します。2 つの Pod が作成され、EIP インスタンスが各 Pod に自動的に割り当てられます。リリースポリシーは、Pod が削除されてから 10 分後に PodEIP を削除するように設定されています。

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: example
     labels:
       app: example
   spec:
     serviceName: "example"
     replicas: 2
     selector:
       matchLabels:
         app: example
     template:
       metadata:
         labels:
           app: example
         annotations:
           k8s.aliyun.com/pod-with-eip: "true"
           k8s.aliyun.com/pod-eip-release-strategy: "10m"
       spec:
         containers:
         - name: example
           image: nginx

   Pod が作成された後、Pod と同じ名前の podeips.alibabacloud.com リソースから割り当てられた EIP 情報を取得できます。

   kubectl get podeip -n <namespace> -o yaml

   期待される出力:

   apiVersion: v1
   items:
   - apiVersion: alibabacloud.com/v1beta1
     kind: PodEIP
     metadata:
       creationTimestamp: "2023-12-15T03:28:01Z"
       finalizers
       - podeip-controller.alibabacloud.com/finalizer
       generation: 1
       name: example-0
       namespace: default
       resourceVersion: "227221"
       uid: 79954xx-17xx-4dxx-b7xx-15b84xxx
     spec:
       allocationID: eip-2ze08metxxx
       allocationType:
         releaseAfter: 10m
         releaseStrategy: TTL
         type: Auto
     status:
       eipAddress: 39.105.XX.XX
       internetChargeType: PayByTraffic
       isp: BGP
       networkInterfaceID: eni-2ze4tkg4xxx
       podLastSeen: "2023-12-15T05:31:34Z"
       privateIPAddress: 192.168.XX.XX
       resourceGroupID: rg-acfmwxxx
       status: InUse
   - apiVersion: alibabacloud.com/v1beta1
     kind: PodEIP
     metadata:
       creationTimestamp: "2023-12-15T03:28:03Z"
       finalizers:
       - podeip-controller.alibabacloud.com/finalizer
       generation: 1
       name: example-1
       namespace: default
       resourceVersion: "227222"
       uid: 1339xxxe7-97xx-46xx-9bxx-537690xxx
     spec:
       allocationID: eip-2zetwhffqxxx
       allocationType:
         releaseAfter: 10m
         releaseStrategy: TTL
         type: Auto
     status:
       eipAddress: 39.105.XX.XX
       internetChargeType: PayByTraffic
       isp: BGP
       networkInterfaceID: eni-2zeagv8f3wxxx
       podLastSeen: "2023-12-15T05:31:34Z"
       privateIPAddress: 192.168.XX.XX
       resourceGroupID: rg-acfmwqnwxxx
       status: InUse
   - apiVersion: alibabacloud.com/v1beta1
     kind: PodEIP
     metadata:
       creationTimestamp: "2023-12-15T04:25:37Z"
       finalizers:
       - podeip-controller.alibabacloud.com/finalizer
       generation: 1
       name: example-5bxxx-9xx
       namespace: default
       resourceVersion: "227220"
       uid: 43cdfxxx-f1xx-42xx-b3xx-969fxxx
     spec:
       allocationID: eip-2ze2qe8zsmnxxx
       allocationType:
         releaseStrategy: Follow
         type: Auto
     status:
       eipAddress: 39.102.XX.XX
       internetChargeType: PayByTraffic
       isp: BGP
       networkInterfaceID: eni-2zeagv8f3wxxx
       podLastSeen: "2023-12-15T05:31:34Z"
       privateIPAddress: 192.168.XX.XX
       publicIpAddressPoolID: pippool-2ze498cxxx
       resourceGroupID: rg-acfmwqnxxx
       status: InUse
   kind: List
   metadata:
     resourceVersion: ""

   ステートフルアプリケーションの Pod が削除された後、対応する PodEIP カスタムリソース (CR) は削除される前に 10 分間保持されます。この間に同じ名前の Pod が作成された場合、EIP は再利用されます。

2. 設定を検証します。

   Pod が実行中状態になった後、Pod の k8s.aliyun.com/allocated-eipAddress アノテーションの値を確認して、関連付けられている EIP アドレスを表示できます。その後、この EIP を使用して Pod にアクセスできます。

   

1. EIP 機能をサポートするように Terway を設定します。

   1. Terway ConfigMap を変更します。

      kubectl edit cm eni-config -n kube-system

   2. 次の内容を eni_conf に追加します。

      "enable_eip_pool": "true"

      説明

      EIP を指定するときに以前のインスタンスを強制的にデタッチする場合は、eni_conf に "allow_eip_rob": "true" パラメーターも追加する必要があります。

   3. ファイルを変更した後、Esc キーを押し、:wq! と入力してから Enter キーを押して、変更した設定ファイルを保存し、編集モードを終了します。

   4. Terway インスタンスを再作成します。

      kubectl delete pod -n kube-system -l app=terway-eniip # terway-eni コンポーネントをインストールした場合は、terway-eniip を terway-eni に置き換えます。

2. アノテーションを使用して、EIP を作成し、Pod に関連付けます。

   Pod にアノテーションを指定することで、EIP を作成して Pod に関連付けることができます。EIP の制限の詳細については、「制限事項」をご参照ください。

   さまざまなシナリオに合わせて、次のようにアノテーションを設定します。

   自動 EIP 割り当てシナリオ

   次のアノテーションを追加して、EIP を Pod に自動的に割り当て、EIP の帯域幅を指定します。

   • k8s.aliyun.com/pod-with-eip: "true": ターゲット Pod に独立したパブリック EIP を割り当てます。

   • k8s.aliyun.com/eip-bandwidth: "5": EIP の帯域幅を指定します。デフォルトの帯域幅は 5 Mbit/s で、EIP のデフォルト値と同じです。

   次のコードは、サンプル YAML ファイルを示しています。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment-basic
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         annotations:
           network.alibabacloud.com/pod-with-eip: "true" # Nginx コンテナーにパブリック EIP アドレスを自動的に割り当てます。
           network.alibabacloud.com/eip-bandwidth: "5"   # EIP の帯域幅を指定します。デフォルトの帯域幅は 5 Mbit/s で、EIP のデフォルト値と一致します。
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx

   EIP 指定シナリオ

   重要

   • 単一の EIP を複数の Pod に関連付けることはできません。したがって、このシナリオはデプロイメントおよび StatefulSet には適用できません。

   • デフォルトでは、EIP がすでにインスタンスにアタッチされている場合、EIP を Pod にアタッチすることはできません。EIP を新しいインスタンスにアタッチする前に以前のインスタンスからデタッチする場合は、前のステップで説明したように ConfigMap で "allow_eip_rob": "true" を設定する必要があります。

   • EIP インスタンス ID は、単一レプリカのインスタンスに対してのみ指定できます。たとえば、デプロイメントは複数のレプリカを持つことはできません。

   次のアノテーションを追加して、Pod の EIP インスタンス ID を指定します。

   k8s.aliyun.com/pod-eip-instanceid: "<youreipInstanceId>"

3. 設定を検証します。

   Pod が実行中状態になった後、Pod の network.alibabacloud.com/allocated-eipAddress アノテーションの値を確認して、関連付けられている EIP アドレスを表示できます。その後、この EIP を使用して Pod にアクセスできます。