Über den asmcli

Das asmcli ist ein von Google bereitgestelltes Tool, mit dem Sie ein Upgrade des Cloud Service Mesh ausführen. 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 noch nicht mit Cloud Service Mesh und Istio vertraut sind, fahren Sie mit dem Unterstützte Plattformen. Der nächste Abschnitt soll Unterstützung beim Upgrade des bestehenden Cloud Service Mesh auf 1.23.

Umstellung auf asmcli

asmcli ersetzt istioctl install und install_asm. Obwohl können Sie die Legacy-Tools in Cloud Service Mesh 1.11 weiterhin verwenden. Diese werden dann 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.

Ab Cloud Service Mesh 1.11 müssen alle Cluster bei einem Flotte. 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 in der bestehenden Steuerungsebene, asmcli installiert Cloud Service Mesh. Wenn der Cluster über eine vorhandene Steuerungsebene (entweder eine Cloud Service Mesh-Steuerungsebene oder eine Open-Source-Steuerungsebene) Istio-Steuerungsebene:

    • Wenn das Überarbeitungslabel auf der vorhandenen Steuerungsebene nicht mit dem Überarbeitungslabel für die neue Steuerungsebene, asmcli führt Folgendes aus: Canary-Upgrade.

    • Wenn die Überarbeitungslabels der Steuerungsebene identisch sind, führt asmcli eine direkte Aktion aus ein Upgrade ausführen.

  • 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 unter Verwendung des -f-Befehlszeilenarguments zum Konfigurieren des Steuerungsebene haben, können Sie die Datei mithilfe der Funktion --custom_overlay an asmcli übergeben. Option. In der Cloud Service Mesh-Dokumentation werden diese Dateien als Overlay bezeichnet. -Dateien.

Unterstützte Plattformen

Cloud Service Mesh-Installationen auf der Liste der Unterstützte Plattformen können konfiguriert werden. oder ein Upgrade bis zum asmcli ausführen.

Allerdings sind nicht alle Features auf den Plattformen außerhalb von Google Cloud verfügbar. Weitere Informationen finden Sie unter In der clusterinternen Steuerungsebene unterstützte Features.

Nächste Schritte