Über den asmcli
Das asmcli
ist ein von Google bereitgestelltes Tool, mit dem Sie das Cloud Service Mesh installieren oder aktualisieren können. Wenn Sie dies zulassen, konfiguriert asmcli
Ihr Projekt und Ihren Cluster so:
- Weisten Ihnen die erforderlichen IAM-Berechtigungen (Identity and Access Management) für Ihr Google Cloud-Projekt zu.
- Aktivieren Sie die erforderlichen Google APIs in Ihrem Google Cloud-Projekt.
- Legt im Cluster ein Label zur Angabe des Mesh-Netzwerks fest.
- Erstellen Sie ein Dienstkonto, mit dem Datenebenenkomponenten wie der Sidecar-Proxy sicher auf die Daten und Ressourcen Ihres Projekts zugreifen können.
- Registriert den Cluster bei der Flotte, falls noch nicht geschehen.
Fügen Sie einfach das Flag --enable_all
hinzu, wenn Sie asmcli
ausführen, damit Ihr Projekt und Ihr Cluster konfiguriert werden. Weitere Informationen zu den asmcli
-Optionen und -Flags finden Sie in der asmcli
-Referenz.
Als Nächstes konfiguriert asmcli
YAML-Dateien mit Ihren Projekt- und Clusterinformationen.
Diese Konfigurationsdateien werden zum Installieren der Cloud Service Mesh-Steuerungsebene benötigt.
Wenn Sie Cloud Service Mesh und Istio noch nicht kennen, fahren Sie mit Unterstützte Plattformen fort. Der nächste Abschnitt soll das Upgrade vorhandener Cloud Service Mesh auf unterstützen.
Umstellung auf asmcli
asmcli
ersetzt istioctl install
und install_asm
. Sie können die Legacy-Tools in Cloud Service Mesh 1.11 zwar weiterhin verwenden, aber wir stellen sie ein. Sie werden in Cloud Service Mesh 1.12 und höher nicht mehr unterstützt.
Aktualisieren Sie Ihre Skripts und Tools für die Verwendung von asmcli
.
Bei Cloud Service Mesh 1.11 und höher müssen alle Cluster bei einer Flotte registriert sein. Weitere Informationen finden Sie unter Flottenanforderungen.
Umstellung von install_asm
Wenn Sie mit install_asm
vertraut sind, erweist sich asmcli
als ähnlich, allerdings mit den folgenden wichtigen Unterschieden:
Sie verwenden
asmcli install
für neue Installationen und Upgrades. Es gibt keine--mode
-Option wieinstall_asm
. Wenn Sieasmcli install
ausführen, wird geprüft, ob im Cluster eine Steuerungsebene vorhanden ist. Wenn keine Steuerungsebene vorhanden ist, installiertasmcli
Cloud Service Mesh. Wenn der Cluster bereits eine Steuerungsebene hat (entweder eine Cloud Service Mesh-Steuerungsebene oder eine Open-Source-Looker-Steuerungsebene):Wenn das Überarbeitungslabel der vorhandenen Steuerungsebene nicht mit dem Überarbeitungslabel für die neue Steuerungsebene übereinstimmt, führt
asmcli
ein Canary-Upgrade durch.Wenn die Überarbeitungslabels der Steuerungsebene identisch sind, führt
asmcli
ein direktes Upgrade durch.
Die meisten
asmcli
-Optionen und -Flags verhalten sich genauso wie die fürinstall_asm
.
Umstellung von istioctl install
Wenn Sie mit istioctl install
vertraut sind und normalerweise eine YAML-Datei vom Typ IstioOperator
mit dem Befehlszeilenargument -f
übergeben, um die Steuerungsebene zu konfigurieren, können Sie die Datei mit der Option --custom_overlay
an asmcli
übergeben. In der Cloud Service Mesh-Dokumentation bezeichnen wir diese Dateien als Overlay-Dateien.
Unterstützte Plattformen
Cloud Service Mesh-Installationen auf der Liste der unterstützten Plattformen können über asmcli
konfiguriert oder aktualisiert werden.
Auf Plattformen außerhalb von Google Cloud sind jedoch nicht alle Funktionen verfügbar. Weitere Informationen finden Sie unter In der clusterinternen Steuerungsebene unterstützte Features.