Über den asmcli

asmcli ist ein von Google bereitgestelltes Tool, mit dem Sie Anthos 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 benötigt, um die Anthos Service Mesh-Steuerungsebene zu installieren.

Wenn Sie mit Anthos Service Mesh und Istio noch nicht vertraut sind, fahren Sie mit Unterstützte Plattformen fort. Der nächste Abschnitt soll helfen, vorhandenes Anthos Service Mesh auf 1.12 zu aktualisieren.

Umstellung auf asmcli

asmcli ersetzt istioctl install und install_asm. Die Legacy-Tools werden verworfen und ab Anthos Service Mesh 1.12 nicht mehr unterstützt. Sie können sie jedoch weiterhin in Anthos Service Mesh 1.11 verwenden. Aktualisieren Sie Ihre Skripts und Tools für die Verwendung von asmcli.

Bei Anthos 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 wie install_asm. Wenn Sie asmcli install ausführen, wird geprüft, ob im Cluster eine Steuerungsebene vorhanden ist. Wenn keine Steuerungsebene vorhanden ist, installiert asmcli Anthos Service Mesh. Wenn der Cluster eine vorhandene Steuerungsebene hat (entweder eine Anthos Service Mesh-Steuerungsebene oder eine Open-Source-Istio-Steuerungsebene):

    • Wenn das Überarbeitungslabel auf der vorhandenen Steuerungsebene nicht dem Überarbeitungslabel für die neue Steuerungsebene entspricht, 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ür install_asm.

Umstellung von istioctl install

Wenn Sie mit istioctl install vertraut sind und normalerweise eine IstioOperator YAML-Datei über das -f-Befehlszeilenargument zum Konfigurieren der Steuerungsebene übergeben, können Sie die Datei an asmcli mithilfe der --custom_overlay-Option übergeben. In der Anthos Service Mesh-Dokumentation werden diese Dateien als Overlay-Dateien bezeichnet.

Unterstützte Plattformen

Anthos Service Mesh-Installationen in der Liste der unterstützten Plattformen können von asmcli konfiguriert oder aktualisiert werden.

Nicht alle Features sind auf den Plattformen außerhalb von Google Cloud verfügbar. Beispielsweise wird die Anthos Service Mesh-Zertifizierungsstelle (Mesh CA) in GKE on AWS, Amazon EKS oder Microsoft AKS nicht unterstützt. Weitere Informationen finden Sie unter In der clusterinternen Steuerungsebene unterstützte Features.

Nächste Schritte