正規サービスコントローラの有効化と無効化

注: 正規サービスは Cloud Service Mesh バージョン 1.6.8 以降で自動的にサポートされます。

asmcli を使用して Cloud Service Mesh をインストールまたはアップグレードすると、正規サービスコントローラがクラスタにデプロイされます。正規サービスコントローラは、同じ論理サービスに属するワークロードをグループ化します。このコントローラは、Google Cloud コンソールの [サービス] ダッシュボードが完全に機能するために必要です。コントローラをデプロイすると、クラスタの asm-system Namespace に canonical-service-controller-manager Deployment が作成されますが、サービスやワークロードには影響しません。

asmcli を使用せずに Cloud Service Mesh をインストールした場合は、正規サービスコントローラがクラスタで有効になっていない可能性があります。クラスタで正規サービスコントローラが有効になっているかどうかを確認するには:

kubectl get services -n asm-system

クラスタ内正規サービスコントローラの有効化

正規サービスコントローラが有効になっていない場合は、次の手順で有効にできます。

コントローラを格納する kpt パッケージを現在の作業ディレクトリにダウンロードします。
```
kpt pkg get https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/asm@release-1.22 asm
```

コントローラの構成を適用します。

kubectl apply -f asm/canonical-service/controller.yaml

クラスタ内正規サービスコントローラの無効化

正規サービスコントローラを無効にする場合は:

コントローラを格納する kpt パッケージを現在の作業ディレクトリにダウンロードします。
```
kpt pkg get https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/asm@release-1.22 asm
```

コントローラをクラスタから削除します。

kubectl delete -f asm/canonical-service/controller.yaml

マネージド正規サービスコントローラの有効化

クラスタ内コントローラをインストールしない場合は、代わりにマネージド正規サービスコントローラを有効にできます。そうすると、コントローラのインストールまたは管理をご自身で行わなくても、メッシュに登録されたすべてのクラスタに対して同じ機能が実行されます。

コントローラは、マネージドコントローラよりもクラスタ内コントローラのほうが優先されるように設計されています。クラスタ内コントローラから移行する場合は、マネージドコントローラに制御を引き継ぐために、実行している各クラスタからクラスタ内コントローラを削除する必要があります。詳しくは、クラスタ内正規サービスコントローラを無効にするをご覧ください。

マネージドコントローラを有効にするには:

GKE クラスタの作成

新しい GKE クラスタを作成する際に [Cloud Service Mesh を有効にする] オプションを使用した場合、マネージド正規サービスコントローラがデフォルトでインストールされています。

次のコマンドを実行して、マネージド正規サービスコントローラが動作していることを確認します。

gcloud beta container hub mesh describe --project=PROJECT_ID

説明フィールドに、「正規サービスが正常に調整された」というメッセージが表示されます。

  projects/<your project number>/locations/global/memberships/<your cluster name>:
    code: OK
    description: |-
      Revision(s) ready for use: asm-managed.
      All Canonical Services have been reconciled successfully.
    servicemeshFeatureState: {}
    updateTime: '2021-11-16T21:10:36.289467777Z'

正規サービスが正常に調整されていない場合は、エラーメッセージまたは次のようなメッセージが出力されます。

  projects/<your project number>/locations/global/memberships/<your cluster name>:
    code: OK
    description: |-
      Revision(s) ready for use: istiod-asm-173-6.
      The Managed Canonical Service Controller is yielding to the in-cluster controller.  See https://cloud.google.com/service-mesh/v1.22/docs/canonical-service-controller-enable-and-disable#disable-in-cluster-service-controller for instructions on removing the in-cluster controller.
    servicemeshFeatureState: {}
    updateTime: '2021-11-16T21:05:43.286828851Z'
  lifecycleState: ENABLED

マネージドコントロールプレーンのインストール

マネージド Cloud Service Mesh を（fleet API または asmcli を使用して）インストールした場合、マネージド正規サービスコントローラはデフォルトでインストールされます。

次のコマンドを実行して、マネージド正規サービスコントローラが動作していることを確認します。

gcloud beta container hub mesh describe --project=PROJECT_ID

説明フィールドに、「正規サービスが正常に調整された」というメッセージが表示されます。

  projects/<your project number>/locations/global/memberships/<your cluster name>:
    code: OK
    description: |-
      Revision(s) ready for use: asm-managed.
      All Canonical Services have been reconciled successfully.
    servicemeshFeatureState: {}
    updateTime: '2021-11-16T21:10:36.289467777Z'

正規サービスが正常に調整されない場合は、エラーメッセージまたは次のようなメッセージが出力されます。

  projects/<your project number>/locations/global/memberships/<your cluster name>:
    code: OK
    description: |-
      Revision(s) ready for use: istiod-asm-173-6.
      The Managed Canonical Service Controller is yielding to the in-cluster controller.  See https://cloud.google.com/service-mesh/v1.22/docs/canonical-service-controller-enable-and-disable#disable-in-cluster-service-controller for instructions on removing the in-cluster controller.
    servicemeshFeatureState: {}
    updateTime: '2021-11-16T21:05:43.286828851Z'
  lifecycleState: ENABLED

次のステップ

以下の内容について学習します。

正規サービス コントローラの有効化と無効化

クラスタ内正規サービス コントローラの有効化

クラスタ内正規サービス コントローラの無効化

マネージド正規サービス コントローラの有効化