ステップ 3: ASM をインストールする

GKE

ASM のインストールを準備する

1. 次のステップで必要となる環境変数を確認し、必要に応じて環境変数を設定します。

   echo $PROJECT_ID
   echo $CLUSTER_NAME
   echo $CLUSTER_LOCATION

2. 次の内容で、overlay.yaml という名前のオーバーレイ ファイルを作成します。

   apiVersion: install.istio.io/v1alpha1
   kind: IstioOperator
   spec:
     components:
       ingressGateways:
         - name: istio-ingressgateway
           enabled: true
           k8s:
             nodeSelector:
               # default node selector, if different or not using node selectors, change accordingly.
               cloud.google.com/gke-nodepool: apigee-runtime
             resources:
               requests:
                 cpu: 1000m
             service:
               type: LoadBalancer
               loadBalancerIP: STATIC_IP # If you do not have a reserved static IP, leave this out.
               ports:
                 - name: http-status-port
                   port: 15021
                 - name: http2
                   port: 80
                   targetPort: 8080
                 - name: https
                   port: 443
                   targetPort: 8443
     meshConfig:
       accessLogFormat:
         '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

   • apigee-runtime は、ノードセレクタのデフォルト値です。これは、ステップ 1: クラスタを作成するで作成した apigee-runtime ノードプールです。 別のノードセレクタを使用している、または使用していない場合は、nodeSelector プロパティを変更するか省略してください。
   • STATIC_IP は、ロードバランサの IP アドレスです。設定していない場合は、loadBalancerIP プロパティを省略しますが、type プロパティと ports プロパティは残します。
3. 手順に従って、ASM のインストールを準備します。
   1. Anthos の前提条件。
   2. Anthos Service Mesh のインストールに必要な権限。
   3. インストールを計画する。
4. 必要なツールをインストールするの手順に沿って、asmcli と、必要なツール（git、kubectl、jq など）をインストールします。
5. クラスタ管理者権限の付与の手順に沿って進め、停止します。「プロジェクトとクラスタを検証する」手順は実施しないでください。
6. オプション機能を使用して ASM をインストールします。 --option legacy-default-ingressgateway を使用してレガシー Ingress ゲートウェイを指定します。次に例を示します。

   ./asmcli install \
     --verbose \
     --project_id $PROJECT_ID \
     --cluster_name $CLUSTER_NAME \
     --cluster_location $CLUSTER_LOCATION \
     --output_dir dir_path \
     --custom_overlay overlay.yaml \
     --enable_all \
     --option legacy-default-ingressgateway

   • dir_path は、asmcli がすべてのサブディレクトリも含む ASM インストールを設定する出力ディレクトリです。
   • overlay.yaml は、前の手順で作成したオーバーレイ ファイルです。

   これらの設定は、オプション機能を使用したインストールの手順に従うときに使用します。

トラブルシューティング

gcloud container hub memberships register を参照する際にエラーが発生した場合は、GKE Hub に登録されたクラスタの最大数を超えている可能性があります。次に例を示します。

asmcli_1.12: [WARNING]:  Command 'run_command gcloud
container hub memberships register my-hybrid-example
...' failed.

次の手順でこのエラーを解決してから、asmcli install を再度実行してください。

1. プロジェクトの GKE Hub メンバーシップを一覧表示します。

   gcloud container hub memberships list --project=$PROJECT_ID

2. GKE Hub メンバーシップを削除します。

   gcloud container hub memberships delete "membership" --project=$PROJECT_ID

GKE Hub の上限の詳細については、割り当てと上限をご覧ください。

Google Cloud 以外

ここでは、Anthos を使用して Apigee ハイブリッド インスタンス用に ASM をインストールして設定する方法を説明します。

• Anthos clusters on VMware（GKE On-Prem）
• ベアメタル版 Anthos
• Anthos clusters on AWS
• Amazon EKS

ASM のインストールを準備する

1. 次のステップで必要となる環境変数を確認し、必要に応じて環境変数を設定します。

   echo ${PROJECT_ID}
   echo ${CLUSTER_NAME}
   echo ${CLUSTER_LOCATION}

2. ASMCLI で必要となる値をメモしておきます。これらの値は、ASM のドキュメントの手順に従うときに指定するよう求められます。
   • FLEET_PROJECT_ID は、クラスタが関連付けられるプロジェクトの名前です。 このインストール用に作成したプロジェクト（${PROJECT_ID} 環境変数に保存）を使用します。
   • KUBECONFIG_FILE kubeconfig ファイルのフルパス。デフォルトのパスは $HOME/.kube/config です。詳細については、Kubernetes ドキュメントの kubeconfig ファイルを使用してクラスタ アクセスを整理するをご覧ください。
   • DIR_PATH: ASMCLI の出力ディレクトリ。これは、Istio 構成ファイルを作成するパスです。例: ./asm
   • GATEWAY_NAMESPACE: Istio Ingress ゲートウェイの名前空間（例: istio）。
   • REVISION: ASM のこのリリースのリビジョン ラベル。asm-1129-3 を使用します。
   • CONTEXT: Kubernetes コンテキスト。次のコマンドを使用して、Kubernetes がクラスタのコンテキストを使用していることを確認します。

     kubectl config get-contexts

     現在のクラスタが現在のコンテキストでない場合は、次のコマンドを使用して設定できます。

     kubectl config use-context CONTEXT

   • USER_ACCOUNT: クラスタの管理に使用しているクラスタ管理者権限を持つアカウント。
3. 次のコマンドを使用して、コンテキストをプロジェクトとリージョンに設定します。

   デフォルトのプロジェクト ID を設定します。

   gcloud config set project ${PROJECT_ID}

   リージョン クラスタを使用する場合は、デフォルトのコンピューティング リージョンを設定します。

   gcloud config set compute/region ${CLUSTER_LOCATION}

4. 次のコマンドを使用して認証情報を取得します。

   gcloud container clusters get-credentials ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID}

5. 次の内容で、overlay.yaml という名前のオーバーレイ ファイルを作成します。

   apiVersion: install.istio.io/v1alpha1
   kind: IstioOperator
   spec:
     components:
       ingressGateways:
         - name: istio-ingressgateway
           enabled: true
           k8s:
             nodeSelector:
               # default node selector, if different or not using node selectors, change accordingly.
               cloud.google.com/gke-nodepool: apigee-runtime
             resources:
               requests:
                 cpu: 1000m
             service:
               type: LoadBalancer
               loadBalancerIP: STATIC_IP # If you do not have a reserved static IP, leave this out.
               ports:
                 - name: http-status-port
                   port: 15021
                 - name: http2
                   port: 80
                   targetPort: 8080
                 - name: https
                   port: 443
                   targetPort: 8443
     meshConfig:
       accessLogFormat:
         '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

   • apigee-runtime は、ノードセレクタのデフォルト値です。これは、ステップ 1: クラスタを作成するで作成した apigee-runtime ノードプールです。 別のノードセレクタを使用している、または使用していない場合は、nodeSelector プロパティを変更するか省略してください。
   • STATIC_IP は、ロードバランサの IP アドレスです。設定していない場合は、loadBalancerIP プロパティを省略しますが、type プロパティと ports プロパティは残します。
6. 手順に従って、ASM のインストールを準備します。
   1. Anthos の前提条件。
   2. Anthos Service Mesh のインストールに必要な権限。
   3. インストールを計画する。
7. 必要なツールをインストールするの手順に沿って、asmcli と、必要なツール（git、kubectl、jq など）をインストールします。
8. クラスタ管理者権限の付与の手順に沿って進め、停止します。「プロジェクトとクラスタを検証する」手順は実施しないでください。
9. オプション機能を使用して ASM をインストールします。 --option legacy-default-ingressgateway を使用してレガシー Ingress ゲートウェイを指定します。次に例を示します。

   ./asmcli install \
     --verbose \
     --project_id $PROJECT_ID \
     --cluster_name $CLUSTER_NAME \
     --cluster_location $CLUSTER_LOCATION \
     --output_dir dir_path \
     --custom_overlay overlay.yaml \
     --enable_all \
     --option legacy-default-ingressgateway

   • dir_path は、asmcli がすべてのサブディレクトリも含む ASM インストールを設定する出力ディレクトリです。
   • overlay.yaml は、前の手順で作成したオーバーレイ ファイルです。

   これらの設定は、オプション機能を使用したインストールの手順に従うときに使用します。

トラブルシューティング

gcloud container hub memberships register を参照する際にエラーが発生した場合は、GKE Hub に登録されたクラスタの最大数を超えている可能性があります。次に例を示します。

asmcli_1.12: [WARNING]:  Command 'run_command gcloud
container hub memberships register my-hybrid-example
...' failed.

次の手順でこのエラーを解決してから、asmcli install を再度実行してください。

1. プロジェクトの GKE Hub メンバーシップを一覧表示します。

   gcloud container hub memberships list --project=$PROJECT_ID

2. GKE Hub メンバーシップを削除します。

   gcloud container hub memberships delete "membership" --project=$PROJECT_ID

GKE Hub の上限の詳細については、割り当てと上限をご覧ください。

その他の Kubernetes プラットフォーム