AlbConfigsを使用してALBリスナーを構成する方法 - Container Service for Kubernetes

AlbConfigのListenersパラメーターを設定して、Application Load Balancer (ALB) インスタンスのリスナーを設定できます。このトピックでは、Listenersパラメーターと、AlbConfigを使用してリスナーを作成、変更、および更新する方法について説明します。

前提条件

異なるゾーンに存在する2つのvSwitchが作成され、ACKクラスターと同じ仮想プライベートクラウド (VPC) にデプロイされます。詳細については、「vSwitchの作成と管理」をご参照ください。
ALB Ingressコントローラーがクラスターにインストールされています。詳細については、「ALB Ingressコントローラーの管理」をご参照ください。
説明
ALB Ingressを使用してACK専用クラスターにデプロイされたサービスにアクセスするには、まずALB Ingressコントローラーが必要とする権限をクラスターに付与する必要があります。詳細については、「ACK専用クラスターにALB Ingressコントローラーへのアクセスを許可する」をご参照ください。
AlbConfigが作成されます。詳細については、「AlbConfigの作成」をご参照ください。
kubectlクライアントがACKクラスターに接続されています。詳細については、「クラスターのkubeconfigファイルを取得し、kubectlを使用してクラスターに接続する」をご参照ください。

Listenersパラメーターの説明

用語

オブジェクト設定ファイル: Kubernetesオブジェクトの設定を定義するファイル。
ライブオブジェクト設定ファイル: Kubernetesクラスターに適用されているオブジェクト設定ファイル。
last-applied-configuration: Kubernetesオブジェクトのアノテーション。注釈は、オブジェクトの最新の構成の内容を記録する。注釈は、オブジェクトの構成が更新されるときにリアルタイムで更新されない。

Listenersパラメーターの更新方法

Listenersパラメーターは配列型です。ほとんどの場合、配列内のフィールドを置き換えることでListenersパラメーターを更新できます。 Listenersパラメーターを更新すると、フィールドは指定した新しいフィールドに置き換えられます。次の表にルールを示します。

いいえ	条件			結果
いいえ	リスナーがオブジェクト構成ファイルにある	リスナーがライブオブジェクト構成ファイルにあります	リスナーは最後に適用された構成アノテーションにあります	結果
1	必須	必須	-(無関係)	リスナーはライブオブジェクト構成ファイルに保持されます。
2	必須	選択可能	-(無関係)	リスナーがライブオブジェクト構成ファイルに追加されます。
3	選択可能	-(無関係)	必須	リスナーがライブオブジェクト構成ファイルから削除されます。ただし、リスナーのフィールドをデフォルト設定にリセットすることもできます。
4	継続しない	継続する	選択可能	リスナーがライブオブジェクト構成ファイルから削除されます。

例

次の例は、オブジェクト構成ファイル、ライブオブジェクト構成ファイル、およびlast-applied-configurationアノテーションの内容を示しています。

# The content of the object configuration file. 
  listeners:
  - port: 8001
    protocol: HTTP
  - port: 8003
    protocol: HTTP
  - port: 8005 # Add port 8005.
    protocol: HTTP

# The content of the live object configuration file. 
  listeners:
  - port: 8001
    protocol: HTTP
  - port: 8002  # Delete port 8002.
    protocol: HTTP
  - port: 8003
    protocol: HTTP
  - port: 8004  # Delete port 8004.
    protocol: HTTP
    
# The content of the last-applied-configuration annotation. 
  listeners:
  - port: 8001 
    protocol: HTTP
  - port: 8002  # Delete port 8002.
    protocol: HTTP
  - port: 8003
    protocol: HTTP

次のコードブロックは、更新後のListenersパラメーターの設定を示しています。

# The configuration of the Listeners parameter.
  listeners:
  - port: 8001
    protocol: HTTP
  - port: 8003
    protocol: HTTP
  - port: 8005
    protocol: HTTP

ポート8001とポート8003はルール1に一致します。したがって、それらは保持されます。
ポート8005はルール2に一致します。したがって、それは追加されます。
ポート8002はルール3に一致します。したがって、削除されます。
ポート8004はルール4に一致します。したがって、削除されます。

リスナーの作成

ALBインスタンスは、リスナーを使用して、リクエストのアプリケーション層情報に基づいて外部リクエストを受信および転送します。

kubectl edit albconfig <Albconfig_Name> コマンドを実行して、AlbConfigを変更します。portおよびprotocolパラメーターを設定して、リスナーを作成できます。 portおよびprotocolパラメーターは、リスナーの唯一の識別子です。 portまたはprotocolパラメーターを変更すると、元のリスナーが削除され、新しい構成に基づいてリスナーが作成されます。

説明

HTTPはWebSocketと互換性があります。追加の設定は必要ありません。

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-demo
spec:
  config:
  ...
  listeners:
    - port: 80
      protocol: HTTP # Valid values: HTTP, HTTPS, and QUIC. 
  ...

証明書の指定

ALBインスタンスの作成時にHTTPSリスナーの暗号化と認証を有効にする場合は、kubectl edit albconfig <Albconfig_Name> コマンドを実行して、ALBインスタンスの設定に使用されるAlbConfigを変更します。次に、AlbConfigのcertificatesパラメーターに証明書IDを指定します。

パラメーターに証明書を指定しない場合、システムがALBインスタンスを作成するときにHTTPSリスナーは作成されません。 Ingressがリスナーに関連付けられ、IngressがIngress構成で指定されたドメイン名に基づいて証明書を自動的に検出するまで、システムは待機します。これは、ドメイン名に基づく証明書の自動検出により、リスナーの作成が遅れることを意味します。

証明書の設定方法の詳細については、「暗号化通信用のHTTPS証明書の設定」をご参照ください。

重要

ALBは、デフォルトの証明書として指定した最初の証明書を使用します。 ALBは、証明書の有効期限が切れるか、要件を満たさなくなるまで、デフォルトの証明書を使用してリクエストを暗号化します。この場合、ALBは他の証明書を使用して要求を暗号化します。

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: alb-demo
spec:
  config:
  ...
  listeners:
  - caEnabled: false
    certificates:
    - CertificateId: 756****-cn-hangzhou # The certificate ID. 
      IsDefault: true
    port: 443
    protocol: HTTPS
  ...

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

カスタムTLSセキュリティポリシーを設定する場合は、kubectl edit albconfig <Albconfig_Name> コマンドを実行して、AlbConfigを変更します。次に、securityPolicyIdパラメーターを設定して、セキュリティポリシーIDを指定します。 AlbConfigでHTTPSリスナーを設定するときに、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 # The security policy ID. 
  ...

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

リスナーの接続タイムアウト時間を設定する場合は、kubectl edit albconfig <Albconfig_Name> コマンドを実行して、AlbConfigを変更します。次に、requestTimeoutパラメーターを設定します。

クライアントがサーバーにリクエストを送信してからタイムアウト期間内にバックエンドサーバーが応答しない場合、ALBはクライアントにHTTP 504エラーコードを返します。

requestTimeoutの有効な値: 1〜180。単位は秒です。
requestTimeoutのデフォルト値: 60。

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    requestTimeout: 60 # The connection timeout period for the listener. Valid values: 1 to 180. If you leave the parameter empty, the default value is used. 
  ...

データ圧縮の設定

データ圧縮により、ファイルのサイズを縮小して、伝送効率とネットワークパフォーマンスを向上させることができます。データ圧縮を設定する場合は、kubectl edit albconfig <Albconfig_Name> コマンドを実行してAlbConfigを変更します。次に、gzipEnabledパラメーターを設定して、リスナーのデータ圧縮を有効にします。 BrotliとGzipは、一般的に使用される2つの圧縮アルゴリズムです。

Brotliはあらゆる種類のファイルをサポートしています。
Gzipは、text/plain、text/css、application/javascript、application/x-javascript、application/rss + xml、application/atom + xml、application/xml、application/jsonをサポートしています。

次のコードブロックは、データ圧縮を無効にするサンプルAlbConfig設定を提供します。

apiVersion: alibabacloud.com/v1
kind: AlbConfig
metadata:
  name: default
spec:
  config:
    ...
  listeners:
  - port: 80
    protocol: HTTP
    gzipEnabled: false # A value of true enables data compression for specific types of files. A value of false disables data compression. 
  ...

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

クライアントのIPアドレスを保持するには、kubectl edit albconfig <Albconfig_Name> コマンドを実行してAlbConfigを変更します。次に、X-Forwarded-Forパラメーターを設定して、クライアントIPの保存を有効にします。

重要