Container Service for Kubernetes:Alibaba Cloud コンポーネントメトリックに基づく水平ポッド自動スケーリングの実装

このトピックでは、Nginx という名前のデプロイメント、サービス、および Ingress を作成して Horizontal Pod Autoscaler (HPA) を設定する方法を示します。これにより、Simple Log Service (SLS) からの Ingress QPS メトリックに基づいて水平ポッド自動スケーリングを実装できます。

ステップ1：ack-alibaba-cloud-metrics-adapter コンポーネントのデプロイ

ack-alibaba-cloud-metrics-adapter コンポーネントを使用すると、Kubernetes は External Metrics API を介して、Elastic Compute Service (ECS)、Server Load Balancer (SLB)、ApsaraDB RDS (RDS) などの Alibaba Cloud プロダクトのモニタリングデータを取得できます。これにより、クラスターのモニタリングおよび自動スケーリング機能が強化されます。

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

2. [クラスター] ページで、対象クラスターの名前をクリックします。左側のナビゲーションウィンドウで、[アプリケーション] > [Helm] を選択します。

3. [Helm] ページで、[作成] をクリックします。[基本情報] パラメーターを設定し、ack-alibaba-cloud-metrics-adapter を選択してから、[次へ] をクリックします。

ステップ2：アプリケーションとサービスの作成

1. nginx-test.yaml という名前のファイルを作成します。

   YAML の例を表示

   apiVersion: apps/v1 
   kind: Deployment
   metadata:
     name: nginx-deployment-basic
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx:1.7.9 
           ports:
           - containerPort: 80
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: nginx
     namespace: default
   spec:
     ports:
       - port: 80
         protocol: TCP
         targetPort: 80
     selector:
       app: nginx
     type: ClusterIP

2. 次のコマンドを実行して、アプリケーションのデプロイメントとそれに対応するサービスを作成します。

   kubectl apply -f nginx-test.yaml

ステップ3：Ingress の作成

1. クラスター管理ページの左側のナビゲーションウィンドウで、[ネットワーク] > [Ingress] を選択します。[Ingress] ページの左上隅にある [Ingress の作成] をクリックします。

2. [作成] パネルで、必要な情報を入力し、[OK] をクリックします。Ingress が作成されると、[Ingress] ページにリダイレクトされます。

3. [名前] 列で Ingress 名をクリックして、そのルーティングルール情報を表示します。Ingress の詳細については、「Ingress の管理」をご参照ください。

ステップ4：HPA の設定

HPA でスケーリングのために SLS プロジェクトから 2 つのメトリックを設定できます。たとえば、sls_ingress_qps と sls_ingress_latency_p9999 です。

• sls_ingress_qps：AverageValue に設定します。これは、QPS が評価される前に Pod の数で除算されることを意味します。

• sls_ingress_latency_p9999：Value に設定します。これは、値が Pod の数で除算されないことを意味します。

1. ingress-hpa.yaml という名前のファイルを作成し、次の内容をコピーします。

   YAML の例を表示

   apiVersion: autoscaling/v2
   kind: HorizontalPodAutoscaler
   metadata:
     name: ingress-hpa
   spec:
     scaleTargetRef:
       apiVersion: apps/v1
       kind: Deployment
       name: nginx-deployment-basic
     minReplicas: 2
     maxReplicas: 10
     metrics:
       - type: External
         external:
           metric:
             name: sls_ingress_qps
             selector:
               matchLabels:
                 sls.project: "***" # sls.project の値を実際の値に置き換えてください。
                 sls.logstore: "nginx-ingress"
                 sls.ingress.route: "default-nginx-80"
           target:
             type: AverageValue
             averageValue: 10
       - type: External
         external:
           metric:
             name: sls_ingress_latency_p9999
             selector:
               matchLabels:
                 # デフォルトの Ingress ログプロジェクトは k8s-log-clusterId です。
                 sls.project: "***" 
                 # デフォルトの Ingress Logstore は nginx-ingress です。
                 sls.logstore: "nginx-ingress"
                 # namespace-svc-port
                 sls.ingress.route: "default-nginx-80"
                 # SLS VPC エンドポイント。デフォルト値は true です。
                 # sls.internal.endpoint:true
           target:
             type: Value
             # sls_ingress_latency_p9999>10ms の場合、HPA は nginx-deployment-basic の Pod 数を自動的に増やします。
             value: 10

   HPA の設定には、次のパラメーターが含まれます。

   パラメーター名	必須	説明
   sls.ingress.route	はい	パラメーターのフォーマットは <namespace>-<svc>-<port> です。<namespace> は Ingress が配置されている名前空間です。<svc> は Ingress に対応するサービスの名前です。<port> は Ingress に対応するサービスのポートの名前です。例：default-nginx-80。
   sls.logstore	はい	SLS の Logstore の名前。クラスターでは、sls.logstore のデフォルト値は nginx-ingress です。
   sls.project	はい	SLS のプロジェクトの名前。クラスターでは、sls.project のデフォルト値は k8s-log-Cluster ID です。
   sls.internal.endpoint	いいえ	SLS にプライベートネットワーク経由でアクセスするか、インターネット経由でアクセスするかを指定します。デフォルト値は true です。 true：プライベートネットワーク経由で SLS にアクセスします。 false：インターネット経由で SLS にアクセスします。

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

   kubectl apply -f ingress-hpa.yaml

ステップ5：結果の検証

1. HPA を設定した後、次のコマンドを実行して負荷テストを実行します。

   ab -t 300 -c 10 <domain_name_configured_for_ingress> # Apache Benchmark を使用して、Ingress によって公開されたサービスに対して負荷テストを実行します。同時実行数を 10、持続時間を 300 秒に設定します。

2. スケーリングステータスを検証します。

   1. コンソールの左側のナビゲーションウィンドウで、[クラスター] をクリックします。[クラスター] ページで、対象のクラスターを見つけ、[アクション] 列の [その他] > [CloudShell でクラスターを管理] を選択します。

   2. 次のコマンドを実行して、スケーリングステータスを確認します。

      kubectl get hpa ingress-hpa

      期待される出力：

      NAME            REFERENCE                              TARGETS           MINPODS    MAXPODS    REPLICAS   AGE
      ingress-hpa     Depolyment/nginx-deployment-basic      21/10 (avg)       2          10         10          7m49s

      REPLICAS の値が MAXPODS の値と同じであれば、スケーリングは成功です。

よくある質問

kubectl get --raw  /apis/external.metrics.k8s.io/v1beta1/namespaces/*/sls_ingress_qps?labelSelector=sls.project={{SLS_Project}},sls.logstore=nginx-ingress

Error from server: {
    "httpCode": 400,
    "errorCode": "ParameterInvalid",
    "errorMessage": "key (slb_pool_name) is not config as key value config,if symbol : is  in your log,please wrap : with quotation mark \"",
    "requestID": "xxxxxxx"
}

{
  "kind": "ExternalMetricValueList",
  "apiVersion": "external.metrics.k8s.io/v1beta1",
  "metadata": {},
  "items": [
    {
      "metricName": "sls_ingress_qps",
      "timestamp": "2025-02-26T16:45:00Z", 
      "value": "50",   # QPS 値
      "metricLabels": {
        "sls.project": "your-sls-project-name",
        "sls.logstore": "nginx-ingress"
      }
    }
  ]
}

関連ドキュメント

• Alibaba Cloud Prometheus メトリックに基づく水平ポッド自動スケーリングの実装

• Nginx Ingress トラフィックメトリックに基づく複数アプリケーションの水平ポッド自動スケーリングの実装