Eine Konfiguration ist ein benannter Satz von Attributen der Distributed Cloud CLI. Diese Attribute sind in Abschnitten organisierte Schlüssel/Wert-Paare, die das Verhalten der gcloud CLI steuern.
Zu den Attributen, die üblicherweise in den Konfigurationen gespeichert werden, gehören die Organisationskonsolen-URL und die Projekt-ID. Mit Konfigurationen können Sie diese und andere Einstellungen als Gruppe definieren und aktivieren.
Konfigurationen werden in Ihrem Nutzerkonfigurationsverzeichnis gespeichert, in der Regel ~/.config/gdcloud unter macOS und Linux. Beachten Sie auch, dass das Konfigurationsverzeichnis schreibgeschützt sein muss.
Wenn Sie mehrere Konfigurationen haben, können Sie zwischen ihnen wechseln oder Befehle mit einer bestimmten Konfiguration ausführen (mithilfe des Flags --configuration). Weitere Informationen zum Wechseln zwischen Konfigurationen finden Sie im Abschnitt Konfiguration aktivieren.
Führen Sie gdcloud topic
configurations aus, um mehr zu Konfigurationen über die Befehlszeile zu erfahren und eine vollständige Liste der verfügbaren Attribute und der relevanten Abschnitte aufzurufen.
Standardkonfiguration
Die gdcloud-Befehlszeile erstellt anfangs eine einzelne Konfiguration mit dem Namen default. Sie können Attribute in Ihrer Konfiguration festlegen, indem Sie den Befehl gdcloud
init ausführen oder gdcloud config set direkt ausführen.
Mehrere Konfigurationen
Für viele Anwendungsfälle reicht es, nur die Konfiguration default zu verwenden. Sie können jedoch auch zusätzliche Konfigurationen erstellen und bei Bedarf mit gdcloud config configurations activate zwischen diesen wechseln. Die ursprüngliche default-Konfiguration wurde nur zur Veranschaulichung erstellt und ist nicht erforderlich. Sie können diese und jede weitere Konfiguration nach Wunsch benennen.
Mehrere Konfigurationen sind nützlich, wenn Sie
- Mehrere Projekte verwenden: Sie können für jedes Projekt eine eigene Konfiguration erstellen und bei Bedarf zwischen den Konfigurationen wechseln.
- Mehrere Konsolen-URLs für Organisationen verwenden
- Allgemein unabhängige Aufgaben ausführen: Sie können beispielsweise eine Konfiguration für die Arbeit an Dienst A in einem Projekt verwenden und mit einer weiteren Konfiguration einen separaten Dienst B in einem anderen Projekt verwalten.
Konfiguration erstellen
So erstellen Sie eine Konfiguration:
gdcloud config configurations create NAME
Aktivieren Sie die neue Konfiguration nach ihrer Erstellung, um sie verwenden zu können.
Konfiguration aktivieren
Es kann jeweils nur eine Ihrer Konfigurationen aktiv sein. Die aktive Konfiguration ist die Konfiguration mit den Attributen, die das Verhalten der gcloud-Befehlszeile bestimmen.
Mit dem folgenden Befehl aktivieren Sie eine neue Konfiguration oder wechseln zu einer neuen aktiven Konfiguration:
gdcloud config configurations activate NAME
gdcloud config list gibt immer die Attribute der aktiven Konfiguration zurück.
Wenn Sie die aktive Konfiguration für einen einzelnen Befehlsaufruf ändern möchten, wenden Sie das Flag --configuration für einen beliebigen gcloud-Kommandozeilenbefehl an:
gdcloud auth print-identity-token --configuration=CONFIGURATION
Konfigurationen auflisten
Mit dem folgenden Befehl listen Sie die Konfigurationen in der gdcloud CLI auf:
gdcloud config configurations list
Die gcloud-Befehlszeile listet die Konfigurationen auf und zeigt an, welche Konfiguration aktiv ist:
NAME ISACTIVE PROPERTIES.CORE.PROJECT PROPERTIES.CORE.ORGANIZATIONCONSOLEURL
default False example-project-default https://console.default-org.example.com
config-project-1 False example-project-1 https://console.org-1.example.com
config-project-2 False example-project-2 https://console.org-2.example.com
Konfigurationsattribute festlegen
Mit den folgenden Befehlen legen Sie die Attribute in der aktiven Konfiguration fest oder heben ihre Festlegung auf:
gdcloud config set project PROJECT
Attribute einer Konfiguration aufrufen
Mit diesem Befehl rufen Sie die Attribute in einer Konfiguration auf:
gdcloud config configurations describe NAME
Die gcloud-Befehlszeile gibt die Konfigurationsattribute aus:
is_active: false
name: default
properties:
accessibility:
screen_reader: "false"
auth:
login_config_cert_path: /tmp/root-web-tls-ca.cert
core:
organization_console_url: https://console.example.com
project: example-project
Mit diesem Befehl rufen Sie die Attribute in der aktiven Konfiguration auf:
gdcloud config list
Konfiguration löschen
Führen Sie zum Löschen einer Konfiguration Folgendes aus:
gdcloud config configurations delete NAME
Sie können keine aktive Konfiguration löschen. Wenn Sie vor dem Löschen zu einer anderen Konfiguration wechseln möchten, verwenden Sie gegebenenfalls gdcloud config configurations activate.