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

この例では、NGINX という名前の Deployment、Service、および 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 などの Alibaba Cloud サービスのモニタリングデータを取得できます。これにより、クラスタのモニタリング機能と自動スケーリング機能が強化されます。

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

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

3. [helm] ページで、[デプロイ] をクリックします。[基本情報] 手順で、パラメータを構成し、ack-alibaba-cloud-metrics-adapter を選択します。次に、[次へ] をクリックします。次の表にパラメータを示します。

4. [パラメータ] 手順で、[チャートバージョン] パラメータを構成し、[OK] をクリックします。

手順 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. 次のコマンドを実行して、Deployment と Service を作成します。

   kubectl apply -f nginx-test.yaml

手順 3：Ingress を作成する

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

2. [ingress の作成] ダイアログボックスで、パラメータを構成し、[OK] をクリックします。Ingress を作成すると、[ingress] ページが表示されます。

3. [名前] 列で、新しく作成した Ingress の名前を見つけてクリックし、Ingress に関する情報を表示します。Ingress の詳細については、「Ingress 管理」をご参照ください。

手順 4：HPA を構成する

sls_ingress_qps メトリックと sls_ingress_latency_p9999 メトリックなど、HPA で SLS プロジェクトをスケーリングするための 2 つのメトリックを構成できます。

• sls_ingress_qps メトリックを AverageValue に設定します。これは、メトリック値が合計 QPS をポッド数で割った結果であることを指定します。

• sls_ingress_latency_p9999 メトリックを Value に設定します。これは、レイテンシがポッド数で除算されないことを指定します。

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 プロジェクトを指定します。
                 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 ログストアは nginx-ingress です
                 sls.logstore: "nginx-ingress"
                 # 名前空間-svc-ポート
                 sls.ingress.route: "default-nginx-80"
                 # sls vpc エンドポイント、デフォルトは true
                 # sls.internal.endpoint:true
           target:
             type: Value
             # sls_ingress_latency_p9999>10ms は、値が 10 ミリ秒を超えた場合に HPA が nginx-deployment-basic ポッドの数を自動的に増やすことを指定します。
             value: 10

   次の表に、HPA の構成に使用されるパラメータを示します。

   パラメータ	必須	説明
   sls.ingress.route	はい	パラメータ形式：<名前空間>-<svc>-<ポート>。<名前空間> は、Ingress が属する名前空間を指定します。<svc> は、Ingress の作成時に選択した Service の名前を指定します。<ポート> は、Service のポートを指定します。例：default-nginx-80
   sls.logstore	はい	SLS の Logstore の名前。sls.logstore のデフォルト値は nginx-ingress です。
   sls.project	はい	SLS のプロジェクトの名前。sls.project のデフォルト値は k8s-log-クラスタ ID です。
   sls.internal.endpoint	いいえ	SLS に内部ネットワーク経由でアクセスするかどうかを指定します。デフォルト値：true。 true：内部ネットワーク経由で SLS にアクセスします。 false：インターネット経由で SLS にアクセスします。

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

   kubectl apply -f ingress-hpa.yml

手順 5：構成の確認

1. HPA を構成した後、次のコマンドを実行してストレステストを実行します。

   ab -t 300 -c 10 <Ingress のドメイン名> # Apache ベンチマークを使用して、Ingress によって公開されているサービスにリクエストを送信します。テストの完了には 300 秒かかり、1 秒あたり 10 件の同時リクエストが送信されます。

2. HPA が想定どおりに動作するかどうかを確認します。

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

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

      kubectl get hpa ingress-hpa

      予期される出力：

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

      REPLICAS パラメータの値が MAXPODS パラメータの値と同じであれば、HPA は想定どおりにアプリケーションをスケールアウトしました。

FAQ

CLI を使用して CLI を使用して取得するにはどうすればよいですかsls_ingress_qps QPS メトリックのデータを取得するにはどうすればよいですか？？

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"
      }
    }
  ]
}

target 列が <unknown> と表示されるのはなぜですか? kubectl get hpa コマンドを実行した後ですか? コマンドを実行した後に 列が になっている場合はどうすればよいですか？

HPA でサポートされているメトリックを見つけるにはどうすればよいですか？HPA でサポートされているメトリックをどのように確認できますか?

NGINX Ingress ログの形式を変更した後、水平自動スケーリングを構成するにはどうすればよいですか？NGINX Ingress ログのフォーマットを変更した後、水平自動スケーリングを構成するにはどうすればよいですか?

参考資料

• Managed Service for Prometheus メトリックに基づく水平ポッドスケーリング

• NGINX Ingress コントローラのメトリックに基づいて複数のアプリケーションの水平ポッド自動スケーリングを構成する