:Alibaba Cloudメトリクスに基づく水平自動スケーリングの実装

次の例は、両方ともNginxという名前のデプロイメントとサービスを作成してHPAを設定する方法を示しています。

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

2. [クラスター] ページで、管理するクラスターの名前をクリックします。 左側のウィンドウで、[ワークロード] > [デプロイ] を選択します。

3. [デプロイメント] ページで、右上隅の [YAMLから作成] をクリックします。

4. サンプルテンプレートを [カスタム] に設定します。 次のYAMLテンプレートを使用して、デプロイとClusterIPサービスを作成します。 次に、作成 をクリックします。

   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

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

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

7. [名前] 列で、新しく作成したIngressの名前を見つけてクリックし、Ingressに関する情報を表示します。

8. HPAを設定します。

   1. 左上隅のアイコンをクリックして、[クラスター] ページに戻ります。

   2. ACKコンソールの左側のナビゲーションウィンドウで、[マーケットプレイス] > [オーケストレーションテンプレート] を選択します。

   3. [テンプレート] ページで、右上隅の [作成] をクリックします。

   4. [作成] ダイアログボックスでテンプレートを設定し、[保存] をクリックします。

      • 名前: テンプレートの名前を入力します。 この例では、HPAが使用される。

      • 説明: テンプレートの説明を入力します。 このパラメーターはオプションです。

      • テンプレート: Kubernetesの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: "***" # Specify the Simple Log Service project that you want to use. 
                    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:
                    # default ingress log project is k8s-log-clusterId
                    sls.project: "***" 
                    # default ingress logstre is nginx-ingress
                    sls.logstore: "nginx-ingress"
                    # namespace-svc-port
                    sls.ingress.route: "default-nginx-80"
                    # sls vpc endpoint, default true
                    # sls.internal.endpoint:true
              target:
                type: Value
                # sls_ingress_latency_p9999 > 10ms
                value: 10

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

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

      説明

      この例では、HPAはsls_ingress_qpsおよびsls_ingress_latency_p9999メトリックに基づいてスケーリングアクティビティをトリガーします。 ターゲットセクションでは、各メトリックのタイプ値が異なります。

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

      • sls_ingress_latency_p9999メトリックのタイプ値はvalueに設定されています。 これは、レイテンシがポッドの数で除算されないことを示します。

      2つのタイプ値は、HPA設定で一般的に使用されます。

   5. [テンプレート] ページで、[HPA] を選択し、[アプリケーションの作成] をクリックします。

   6. HPAページで、[作成] をクリックします。

9. HPAを設定したら、次のスクリプトを実行してストレステストを実行します。

   #!/bin/bash
   ##Use Apache Benchmark to send requests to the Service exposed by the Ingress. The test lasts 300 seconds and 10 concurrent requests are sent per second. 
   ab -t 300 -c 10 <The domain name of the Ingress>

10. HPAが期待どおりに機能するかどうかを確認します。

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

    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が期待どおりにアプリケーションをスケールアウトしたことを示します。

次のコマンドを実行してデータを照会します。 この例では、sls_ingress_qpsメトリックが照会されます。

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

{{SLS_Project}} は、ACKクラスターで使用されるSimple Log Serviceプロジェクトの名前です。 ACKクラスターで使用されるSimple Log Serviceプロジェクトのデフォルト名はk8s-log-{{ClusterId}} です。 {{ClusterId}} はクラスターのIDです。

期待される出力:

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

前の出力が返された場合、メトリックは無効です。 ALB Ingressが作成されていないため、sls_alb_ingress_qpsメトリックのデータは返されません。