:ALB インスタンスを構成するための AlbConfig の使用

前提条件

• ACS クラスタが作成されていること。詳細については、ACS クラスタの作成を参照してください。

• 異なるゾーンにある 2 つの vSwitch が作成され、クラスタの仮想プライベートクラウド (VPC) にデプロイされていること。詳細については、vSwitch の作成と管理を参照してください。

• ALB Ingress コントローラーがクラスタにインストールされていること。詳細については、ALB Ingress コントローラーの管理を参照してください。

使用上の注意

• クラスタ内のリソースを変更または更新するには、kubectl edit コマンドを使用することをお勧めします。kubectl apply コマンドを使用してリソースを変更または更新する必要がある場合は、kubectl diff コマンドを実行して変更をプレビューし、kubectl apply コマンドを実行する前に変更が要件を満たしていることを確認する必要があります。その後、kubectl apply コマンドを実行して、リソースに変更を適用します。

• 以前のバージョンの NGINX Ingress コントローラーは、Ingress リソースの spec:ingressClassName フィールドを認識できません。クラスタに NGINX Ingress と ALB Ingress の両方が構成されている場合、ALB Ingress は以前のバージョンの NGINX Ingress コントローラーによって調整される可能性があります。この問題を回避するには、NGINX Ingress コントローラーをできるだけ早く更新するか、アノテーションを使用して ALB Ingress の IngressClass を指定します。

サービス、Ingress、AlbConfig 間の関係

ALB Ingress コントローラーは、API サーバーから Ingress への変更を取得し、Ingress の変更が検出されたときに AlbConfig オブジェクトを動的に生成します。次に、ALB Ingress コントローラーは、ALB インスタンスの作成、リスナーの構成、Ingress ルールの作成、バックエンドサーバーグループの構成という操作を順番に実行します。サービス、Ingress、AlbConfig オブジェクトは、次のように相互作用します。

• サービスは、複製された Pod のグループにデプロイされるアプリケーションの抽象化です。

• Ingress にはリバースプロキシルールが含まれています。HTTP または HTTPS リクエストのルーティング先となるサービスを制御します。たとえば、Ingress は、リクエスト内のホストと URL に基づいて、リクエストを異なるサービスにルーティングします。

• AlbConfig は、ALB Ingress コントローラーが ALB インスタンスとリスナーを構成するために使用するカスタムリソース定義 (CRD) です。AlbConfig オブジェクトは 1 つの ALB インスタンスに対応します。

各 AlbConfig は 1 つの ALB インスタンスに対応します。ALB インスタンスは、複数の Ingress の転送ルールで指定できます。したがって、各 AlbConfig は複数の Ingress に関連付けることができます。

AlbConfig の作成

AlbConfig は、ALB インスタンスを構成するために使用されます。複数の ALB インスタンスを構成する場合は、複数の AlbConfig を作成する必要があります。AlbConfig を作成するには、次の手順を実行します。

1. alb-test.yaml という名前のファイルを作成し、次の内容をファイルに追加します。このファイルは、AlbConfig を作成するために使用されます。

   apiVersion: alibabacloud.com/v1
   kind: AlbConfig
   metadata:
     name: alb-demo
   spec:
     config:
       name: alb-test
       addressAllocatedMode: Dynamic # 有効な値：Dynamic および Fixed。このパラメーターを使用して、ALB インスタンスに IP アドレスを割り当てる方法を指定できます。
       addressType: Internet
       zoneMappings:               
       - vSwitchId: vsw-uf6ccg2a9g71hx8go****
       - vSwitchId: vsw-uf6nun9tql5t8nh15****
     listeners:
       - port: 80
         protocol: HTTP

   パラメーター	説明
   spec.config.name	ALB インスタンスの名前。このパラメーターはオプションです。
   spec.config.addressType	ALB インスタンスがサービスを提供するために使用する IP アドレスのタイプ。このパラメーターは必須です。有効な値： Internet (デフォルト): ALB インスタンスはパブリック IP アドレスを使用します。Ingress のドメイン名はパブリック IP アドレスに解決されます。したがって、ALB インスタンスにはインターネット経由でアクセスできます。 Intranet: ALB インスタンスはプライベート IP アドレスを使用します。Ingress のドメイン名はプライベート IP アドレスに解決されます。したがって、ALB インスタンスは、ALB インスタンスがデプロイされている VPC 内からのみアクセスできます。
   spec.config.zoneMappings	ALB Ingress によって使用される vSwitch の ID。このパラメーターは必須です。複数のゾーンを含むリージョンで vSwitch を指定する場合は、異なるゾーンに少なくとも 2 つの vSwitch ID を指定する必要があります。1 つのゾーンのみを含むリージョンで vSwitch を指定する場合は、1 つの vSwitch ID のみ指定できます。指定された vSwitch は、ALB インスタンスでサポートされているゾーンにデプロイされ、クラスタと同じ VPC にデプロイされている必要があります。ALB Ingress でサポートされているリージョンとゾーンの詳細については、ALB が利用可能なリージョンとゾーンを参照してください。 重要 ALB インスタンスの作成後、ALB インスタンスのリージョンとゾーンを変更することはできません。これは、AlbConfig の addressType パラメーターと zoneMappings パラメーターは、AlbConfig を作成するときにのみ有効になることを示しています。AlbConfig を更新するとき、パラメーターは有効になりません。
   spec.config.addressAllocatedMode	ALB インスタンスが使用する IP アドレスのタイプ。このパラメーターはオプションです。有効な値： Dynamic: 動的 IP アドレス Fixed: 静的 IP アドレス

   クラスタに ALB Ingress コントローラーをインストールすると、システムはデフォルトの AlbConfig を作成します。デフォルトの AlbConfig のパラメーターは、vSwitchID パラメーターを除き、次の設定を使用します。

   デフォルトの AlbConfig 構成

   apiVersion: alibabacloud.com/v1
   kind: AlbConfig
   metadata:
     name: alb-demo                      # AlbConfig の名前。
   spec:
     config:
       accessLogConfig:
         logProject: ""
         logStore: ""
       addressAllocatedMode: Dynamic # このパラメーターを使用して、ALB インスタンスに IP アドレスを割り当てる方法を指定できます。有効な値：Dynamic および Fixed。Dynamic の値は動的 IP アドレスを指定します。Fixed の値は静的 IP アドレスを指定します。
       addressType: Internet
       billingConfig:
         internetBandwidth: 0
         internetChargeType: ""
         payType: PostPay
       deletionProtectionEnabled: true
       edition: Standard
       forceOverride: false
       zoneMappings:
       - vSwitchId: vsw-wz92lvykqj1siwvif****        # vSwitch の ID。ALB インスタンスが動的 IP アドレスを使用する場合は、2 つの vSwitch を指定します。ALB インスタンスが静的 IP アドレスを使用する場合は、1 つの vSwitch を指定します。
       - vSwitchId: vsw-wz9mnucx78c7i6iog****        # vSwitch の ID。
   status:
     loadBalancer:
       dnsname: alb-s2em8fr9debkg5****.cn-shenzhen.alb.aliyuncs.com
       id: alb-s2em8fr9debkg5****

2. 次のコマンドを実行して、AlbConfig を作成します。

   kubectl apply -f alb-test.yaml

   予期される出力：

   albconfig.alibabacloud.com/alb-demo created

3. 次のコマンドを実行して、AlbConfig の名前をクエリします。

   kubectl -n kube-system get AlbConfig

   予期される出力：

   NAME       ALBID        DNSNAME                                  PORT&PROTOCOL   CERTID                 AGE
   alb-demo   alb-******   alb-******.<regionID>.alb.aliyuncs.com   443/HTTPS       11055487-cn-<regionID>  2d

AlbConfig の更新

Kubernetes では、kubectl apply コマンドはオブジェクトの構成を上書きしますが、kubectl edit コマンドはオブジェクトに構成を追加するだけです。AlbConfig を使用して作成された ALB インスタンスを更新するには、kubectl edit コマンドを使用することをお勧めします。AlbConfig を更新するには、次の手順を実行します。

1. 次のコマンドを実行して、AlbConfig の名前をクエリします。

   kubectl -n kube-system get AlbConfig

   予期される出力：

   NAME       ALBID        DNSNAME                                  PORT&PROTOCOL   CERTID                 AGE
   alb-demo   alb-******   alb-******.<regionID>.alb.aliyuncs.com   443/HTTPS       11055487-cn-<regionID>  2d

2. 次のコマンドを実行して、AlbConfig を変更します。

   重要

   • クラスタ内のリソースを更新するには、kubectl edit コマンドを実行することをお勧めします。kubectl apply コマンドを使用してリソースを更新するには、kubectl diff コマンドを実行して変更をプレビューし、kubectl apply コマンドを実行する前に変更が要件を満たしていることを確認してください。その後、kubectl apply コマンドを実行して、リソースに変更を適用できます。

   • kubectl apply コマンドは AlbConfig の構成を上書きします。AlbConfig の YAML ファイルに listener 設定が含まれていない場合、更新は既存のリスナーに影響しません。YAML ファイルにリスナー設定が含まれている場合、既存のリスナーは更新されたリスナー設定に基づいて調整されます。したがって、ポート 80 および 443 でリッスンする一般的に使用されるリスナーなど、使用中のすべてのリスナーを指定する必要があります。

   kubectl -n kube-system edit AlbConfig alb-demo

   ビジネス要件に基づいて AlbConfig 構成ファイルを更新します。たとえば、spec.config.name パラメーターを更新して、AlbConfig の名前を test に変更できます。

   ...
    spec:
    config:
    name: test # AlbConfig の新しい名前。
   ...

IngressClass を使用して AlbConfig を Ingress に関連付ける

IngressClass を使用して、AlbConfig を ALB Ingress に関連付けることができます。これを行うには、最初に IngressClass を作成する必要があります。

1. alb.yaml という名前のファイルを作成し、次の内容をファイルに追加します。このファイルは、IngressClass を作成するために使用されます。

   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     name: alb
   spec:
     controller: ingress.k8s.alibabacloud/alb
     parameters:
       apiGroup: alibabacloud.com
       kind: AlbConfig
       name: alb-demo

2. 次のコマンドを実行して、IngressClass を作成します。

   kubectl apply -f alb.yaml

   予期される出力：

   ingressclass.networking.k8s.io/alb created

3. ingress.yaml という名前のファイルを作成し、次の内容をファイルに追加します。ingressClassName パラメーターを alb IngressClass に設定します。

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: cafe-ingress 
   spec:
     ingressClassName: alb
     rules:
     - http:
         paths:
         # コンテキストパスを指定します。
         - path: /tea
           pathType: ImplementationSpecific
           backend:
             service:
               name: tea-svc
               port:
                 number: 80
         # コンテキストパスを指定します。
         - path: /coffee
           pathType: ImplementationSpecific
           backend:
             service:
               name: coffee-svc
               port: 
                 number: 80

4. 次のコマンドを実行して、Ingress を作成します。

   kubectl apply -f ingress.yaml

   予期される出力：

   ingress.networking.k8s.io/cafe-ingress created

上記の手順を完了すると、IngressClass を使用して AlbConfig を Ingress に関連付けることができます。

ALB インスタンスの名前変更

kubectl -n kube-system edit AlbConfig alb-demo

...
  spec:
    config:
      name: test   # 新しい名前。
...

IPv6 の有効化

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-demo
spec:
  config:
    addressIpVersion: DualStack
    ...

カスタム TLS セキュリティポリシーの指定

AlbConfig を使用して HTTPS リスナーを構成するときに、TLS セキュリティポリシーを指定できます。カスタム TLS セキュリティポリシーとデフォルト TLS セキュリティポリシーがサポートされています。詳細については、TLS セキュリティポリシーを参照してください。

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-demo
spec:
  config:
    #...
  listeners:
  - port: 443
    protocol: HTTPS
    securityPolicyId: tls_cipher_policy_1_1
  #...

アクセスログを収集するための SLS の有効化

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-demo
spec:
  config:
    accessLogConfig:
      logProject: "k8s-log-xz92lvykqj1siwvif****"
      logStore: "alb_****"
    #...

既存の ALB インスタンスの再利用

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: reuse-alb
spec:
  config:
    id: **** # SLB コンソールで作成された標準 ALB インスタンスまたは WAF 対応 ALB インスタンスの ID。
    forceOverride: false
    listenerForceOverride: false

複数の ALB インスタンスの作成と使用

Ingress に複数の ALB インスタンスを使用させる場合は、Ingress 構成ファイルの spec.ingressClassName パラメーターに異なる IngressClass を指定します。

1. alb-demo2.yaml という名前のファイルを作成し、次の内容をファイルに追加します。

   apiVersion: alibabacloud.com/v1
   kind: AlbConfig
   metadata:
     name: demo
   spec:
     config:
       name: alb-demo2        # ALB インスタンスの名前。
       addressType: Internet  # ALB インスタンスはパブリック IP アドレスを使用します。
       zoneMappings:
       - vSwitchId: vsw-uf6ccg2a9g71hx8go****
       - vSwitchId: vsw-uf6nun9tql5t8nh15****

2. 次のコマンドを実行して、AlbConfig を作成します。

   kubectl apply -f alb-demo2.yaml

   予期される出力：

   AlbConfig.alibabacloud.com/demo created

3. alb.yaml という名前のファイルを作成し、次の内容をファイルに追加します。このファイルは、IngressClass を作成するために使用されます。

   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     name: alb-demo2
   spec:
     controller: ingress.k8s.alibabacloud/alb
     parameters:
       apiGroup: alibabacloud.com
       kind: AlbConfig
       name: demo

4. 次のコマンドを実行して、IngressClass を作成します。

   kubectl apply -f alb.yaml

   予期される出力：

   ingressclass.networking.k8s.io/alb-demo2 created

5. ingress.yaml という名前のファイルを作成し、次の内容をファイルに追加します。ingressClassName パラメーターを使用して異なる ALB インスタンスを指定します。

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: demo
     namespace: default
   spec:
     ingressClassName: alb-demo2
     rules:
       - host: ""
         http:
           paths:
             - backend:
                service:
                 name: demo-service
                 port:
                   number: 80
               path: /hello
               pathType: ImplementationSpecific

リスナーの接続タイムアウト期間の設定

AlbConfig の構成で、リスナーの接続タイムアウト期間を設定できます。接続タイムアウト期間は 1 秒から 180 秒の範囲で設定できます。指定された接続タイムアウト期間内にバックエンドサーバーから応答がない場合、ALB はクライアントに HTTP 504 エラーコードを返します。接続タイムアウト期間を指定しない場合は、デフォルトの接続タイムアウト期間である 60 秒が使用されます。次の YAML ファイルは例を示しています。

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    requestTimeout: 60
  ...

データ圧縮の構成

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    gzipEnabled: false
  ...

クライアント IP アドレスの保持

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    #...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForEnabled: true
  #...

ALB インスタンスで使用されるリスナープロトコルの取得

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForProtoEnabled: true
  ...

ALB インスタンスの ID の取得

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForSLBIdEnabled: true
  ...

ALB インスタンスのリスナーポートの取得

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForSLBPortEnabled: true
  ...

クライアントが ALB インスタンスへの接続に使用するポートの取得

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    xForwardedForConfig:
      XForwardedForClientSrcPortEnabled: true
  ...

ネットワーク ACL の構成

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
   #...
  listeners:
  - port: 80
    protocol: HTTPS
    aclConfig:
      aclEntries:
      - 127.0.0.1/32
      aclType: White
  #...

ALB インスタンスの削除

AlbConfig は ALB インスタンスを構成するために使用されます。したがって、対応する AlbConfig を削除することで、ALB インスタンスを削除できます。AlbConfig を削除する前に、AlbConfig に関連付けられているすべての Ingress を削除する必要があります。

kubectl delete -n kube-system delete AlbConfig alb-demo

alb-demo を削除する AlbConfig の名前に置き換えます。

再利用された ALB インスタンスの AlbConfig の削除

再利用された ALB インスタンスの AlbConfig を削除するには、次の手順を実行します。

1. 次のコマンドを実行して、AlbConfig に関連付けられているすべての Ingress を削除します。

   kubectl delete -n <NAMESPACE> ingress <INGRESS_NAME>  # <INGRESS_NAME> と <NAMESPACE> を削除する Ingress の名前と名前空間に置き換えます。

2. kubectl edit コマンドを実行して AlbConfig を変更し、spec.listeners パラメーターのすべてのエントリを削除します。このようにして、AlbConfig で指定されたすべてのリスナーが削除されます。

   重要

   クラスタにインストールされている ALB Ingress コントローラーのバージョンが 2.10.0-aliyun.1 以降の場合は、この手順をスキップします。

3. 次のコマンドを実行して、AlbConfig を削除します。

   kubectl -n kube-system delete AlbConfig alb-demo # alb-demo を削除する AlbConfig の名前に置き換えます。