asmcli について
asmcli
は、Anthos Service Mesh のインストールまたはアップグレードに使用できる Google 提供のツールです。asmcli
を使用すると、プロジェクトとクラスタは次のように構成されます。
- Google Cloud プロジェクトに対して必要な Identity and Access Management(IAM)権限を付与します。
- Google Cloud プロジェクトで必要な Google API を有効にします。
- メッシュを識別するラベルをクラスタに設定します。
- サービス アカウントを作成し、サイドカー プロキシなどのデータプレーン コンポーネントがプロジェクトのデータとリソースに安全にアクセスできるようにします。
- クラスタを登録します(まだ登録されていない場合)。
asmcli
でプロジェクトとクラスタを構成する場合は、--enable_all
フラグのみを指定します。asmcli
のオプションとフラグの詳細については、asmcli
リファレンスをご覧ください。
asmcli
が、プロジェクトとクラスタの情報を使用して YAML ファイルを構成します。これらの構成ファイルは、Anthos Service Mesh コントロール プレーンのインストールで必要になります。
Anthos Service Mesh と Istio を初めて使用する場合は、対応プラットフォームに進んでください。次のセクションでは、既存の Anthos Service Mesh を 1.13 にアップグレードする方法について説明します。
asmcli
への移行
asmcli
は、istioctl install
と install_asm
の代わりに使用されます。Anthos Service Mesh 1.11 では従来のツールを引き続き使用できますが、それらのツールは非推奨となり、Anthos Service Mesh 1.12 以降ではサポートされなくなります。asmcli
を使用するようにツールとスクリプトを更新してください。
Anthos Service Mesh 1.11 以降では、すべてのクラスタをフリートに登録する必要があります。詳しくは、フリートの要件をご覧ください。
install_asm
からの移行
install_asm
と asmcli
はよく似ていているように見えるかもしれませんが、次の点が大きく異なります。
新規インストールとアップグレードには
asmcli install
を使用します。これには、install_asm
のような--mode
オプションはありません。asmcli install
を実行すると、クラスタに既存のコントロール プレーンが存在するかどうかが確認されます。既存のコントロール プレーンがない場合、asmcli
は Anthos Service Mesh をインストールします。クラスタに既存のコントロール プレーン(Anthos Service Mesh コントロール プレーンまたはオープンソースの Istio コントロール プレーン)がある場合:既存のコントロール プレーンのリビジョン ラベルが、新しいコントロール プレーンのリビジョン ラベルと一致しない場合、
asmcli
はカナリア アップグレードを実行します。コントロール プレーンのリビジョン ラベルが一致している場合、
asmcli
はインプレース アップグレードを実行します。
asmcli
のオプションとフラグのほとんどはinstall_asm
と同じように機能します。
istioctl install
からの移行
istioctl install
に慣れていて、-f
コマンドライン引数で IstioOperator
YAML ファイルを渡してコントロール プレーンを構成している場合は、--custom_overlay
オプションを使用してファイルを asmcli
に渡すことができます。Anthos Service Mesh のドキュメントでは、これらのファイルをオーバーレイ ファイルと呼んでいます。
対応プラットフォーム
対応プラットフォームでの Anthos Service Mesh のインストールは、asmcli
によって構成またはアップグレードできます。
すべての機能が Google Cloud 以外のプラットフォームで利用できるわけではありません。たとえば、Anthos Service Mesh 認証局(Mesh CA)は GKE on AWS、Amazon EKS、または Microsoft AKS でサポートされていません。詳細については、クラスタ内コントロール プレーンでサポートされている機能をご覧ください。