Container Service for Kubernetes:MseIngressConfig の設定

仕組み

MSE Ingress Controller は、クラスター内の MseIngressConfig リソースを監視し、対応するクラウドネイティブゲートウェイのライフサイクルと、ACK マネージドクラスター、ACK サーバーレスクラスター、および ACS クラスターとの関連付けを動的に管理します。ゲートウェイが ACK マネージドクラスター、ACK サーバーレスクラスター、または ACS クラスターの API サーバーに関連付けられると、そのコントロールプレーンは Ingress リソースの変更を同期し、ルーティングルールをリアルタイムで更新します。ゲートウェイがリクエストを受信すると、Ingress のルーティングルールとリクエストを照合し、適切なバックエンド Pod にトラフィックを転送します。

次の図は、コンポーネント間の関係を示しています。

主要なコンポーネントは次のとおりです：

• Service：バックエンドサービスの抽象化です。Service は、複製された Pod のグループを表します。

• Ingress：ホスト名とパスに基づいて HTTP または HTTPS リクエストを Service にルーティングするリバースプロキシルールが含まれます。

• IngressClass：Ingress リソースのセットを処理する Ingress コントローラー実装を宣言します。IngressClass を MseIngressConfig に関連付けて、それらの Ingress リソースに対して MSE クラウドネイティブゲートウェイを有効化します。

• MseIngressConfig：ゲートウェイ設定 (インスタンス仕様、ネットワーク設定、グローバルポリシー、Ingress のリスニング範囲) を提供する CRD です。

• MSE Ingress Controller：MSE クラウドネイティブゲートウェイインスタンスとその設定を管理するコントロールプレーンです。ネットワークのデータプレーンではありません。クラスター内の MseIngressConfig リソースを監視し、Ingress リソースに記述されたトラフィック管理ルールを実装するために、MSE クラウドネイティブゲートウェイインスタンスを調整します。

1 つの MseIngressConfig は、1 つの MSE クラウドネイティブゲートウェイと 1 対 1 で対応します。複数のゲートウェイを実行するには、複数の MseIngressConfig を作成します。

MseIngressConfig リファレンス

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  common:
    pay:
      payType: POSTPAY
    instance:
      spec: 4c8g
      replicas: 3
    network:
      vSwitches:
      - "vsw-1"
      - "vsw-2"
      publicSLBSpec: slb.s2.small
    securityGroupType: normal
  global:
    tls:
      enableHardwareAcceleration: true
    ipAccessControl:
      whitelist:
      - 1.1.XX.XX
      - 2.2.XX.XX
  monitor:
    logging:
      sls:
        reuseProject: "xxx"   # 空欄の場合はデフォルトプロジェクトを使用します
    tracing:
      openTelemetry:
        sampleRate: "100"
  ingress:
    local:
      ingressClass: mse
      watchNamespace: ""      # 空欄の場合はすべての名前空間をリッスンします

kubectl get mseingressconfig

NAME   STATUS     MESSAGE
test   Listening

MSE クラウドネイティブゲートウェイの作成

1. MseIngressConfig を適用してゲートウェイを作成します。次の例では、mse-ingress という名前のゲートウェイを、2c4g 仕様、レプリカ数 3 で作成します。

   apiVersion: mse.alibabacloud.com/v1alpha1
   kind: MseIngressConfig
   metadata:
     name: test
   spec:
     name: mse-ingress
     common:
       instance:
         spec: 2c4g
         replicas: 3

2. IngressClass リソースを作成し、MseIngressConfig にリンクします。

   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     name: mse
   spec:
     controller: mse.alibabacloud.com/ingress
     parameters:
       apiGroup: mse.alibabacloud.com
       kind: MseIngressConfig
       name: test

   両方のリソースを適用すると、IngressClass が mse である Ingress リソースは、関連付けられたクラウドネイティブゲートウェイによって処理されます。

3. ゲートウェイが稼働していることを確認します。

   kubectl get mseingressconfig test

   ステータスは Pending → Running → Listening の順に遷移します。ステータスが Listening になると、ゲートウェイは準備完了です。

既存の MSE クラウドネイティブゲートウェイの再利用

既存のゲートウェイを再利用するには、spec.id をゲートウェイの ID (gw-xxx 形式) に設定し、spec.override でその設定を上書きするかどうかを制御します。

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: reuse
spec:
  id: gw-xxxx
  override: false
  ingress:
    local:
      ingressClass: mse

spec.override の動作：

MSE クラウドネイティブゲートウェイの削除

MseIngressConfig を削除すると、ほとんどの場合は関連付けられているゲートウェイも削除されます。例外は再利用シナリオで、この場合はゲートウェイが保持されます。

次のコマンドを実行して MseIngressConfig を削除します：

kubectl delete mseingressconfig <your-config-name>

シナリオ別の削除動作：

IP アクセス制御の設定

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  global:
    ipAccessControl:
      whitelist:
      - 1.1.XX.XX
      - 2.0.XX.XX/8

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  global:
    ipAccessControl:
      blacklist:
      - 1.1.XX.XX
      - 2.0.XX.XX/8

Simple Log Service の有効化

Simple Log Service (SLS) を有効化する前に、クラスタータイプに応じて MSE Ingress Controller に SLS 権限を付与してください：

• ACK マネージドクラスターと ACK 専用クラスターの場合は、「Grant permissions to MSE Ingress Controller」を参照し、お使いのクラスタータイプに対応するセクションに従ってください。

• ACK サーバーレスクラスターの場合は、「Grant permissions to MSE Ingress Controller」の ACK サーバーレスクラスターのセクションに従ってください。

• ACS クラスターの場合は、「Grant permissions to MSE Ingress Controller」の ACS クラスターのセクションに従ってください。

次の例では、ゲートウェイを設定して、demo という名前の SLS プロジェクトにアクセスログを配信します。代わりにデフォルトのプロジェクトを使用する場合は、reuseProject を空にします。

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  monitor:
    logging:
      sls:
        reuseProject: "demo"

Managed Service for OpenTelemetry の有効化

Managed Service for OpenTelemetry を設定すると、エンドツーエンドの分散トレーシングが有効になり、本番環境の問題の診断と特定に役立ちます。

次の例では、サンプリングレートを 100% に設定します。

apiVersion: mse.alibabacloud.com/v1alpha1
kind: MseIngressConfig
metadata:
  name: test
spec:
  name: mse-ingress
  monitor:
    tracing:
      openTelemetry:
        sampleRate: "100"

その他の設定

MSE Ingress が使用する MSE クラウドネイティブゲートウェイインスタンスは、次の追加設定をサポートしています。

これらの設定を適用するには、MSE コンソールにログオンし、Cloud-Native Gateway > ゲートウェイリスト に移動し、MSE Ingress Controller が使用する既存の、または自動的に作成されたゲートウェイインスタンス (インスタンス ID は mse_ingresspost-***** 形式) を見つけ、インスタンス ID をクリックし、次に左側のナビゲーションペインで Parameters をクリックします。