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 gdcloud CLI steuern.
Zu den Attributen, die häufig in Konfigurationen gespeichert werden, gehören die URL der Organisationskonsole und die Projekt-ID. Mit Konfigurationen können Sie diese und andere Einstellungen zusammen als Gruppe definieren und aktivieren.
Konfigurationen werden in Ihrem Nutzerkonfigurationsverzeichnis gespeichert, in der Regel ~/.config/gdcloud unter Linux, $HOME/Library/Application Support/gdcloud unter Mac und %AppData%\gdcloud unter Windows. 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 mit dem Flag --configuration ausführen. Weitere Informationen zum Wechseln von 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 CLI erstellt zunächst eine einzelne Konfiguration mit dem Namen default. Sie können Attribute in Ihrer Konfiguration festlegen, indem Sie den gdcloud
init Befehl oder direkt gdcloud config set ausführen.
Mehrere Konfigurationen
Für viele Anwendungsfälle reicht es, nur die Konfiguration default zu verwenden. Sie können aber auch zusätzliche Konfigurationen erstellen und mit gdcloud config configurations activate zwischen ihnen wechseln. Die anfängliche Konfiguration default wird zur Vereinfachung erstellt und muss nicht verwendet werden. Sie können diese und alle zusätzlichen Konfigurationen beliebig benennen.
Mehrere Konfigurationen sind nützlich, wenn Sie
- mehrere Projekte verwenden: Sie können für jedes Projekt eine separate Konfiguration erstellen und nach Bedarf zwischen ihnen wechseln.
- mehrere URLs der Organisationskonsole 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
Führen Sie Folgendes aus, um eine Konfiguration zu erstellen:
gdcloud config configurations create NAME
Sie müssen die neue Konfiguration nach der Erstellung aktivieren, um sie zu verwenden.
Konfiguration aktivieren
Es kann jeweils nur eine Ihrer Konfigurationen aktiv sein. Die aktive Konfiguration ist die Konfiguration mit den Attributen, die das Verhalten der gdcloud CLI bestimmen.
Führen Sie Folgendes aus, um eine neue Konfiguration zu aktivieren oder zu einer neuen aktiven Konfiguration zu wechseln:
gdcloud config configurations activate NAME
gdcloud config list zeigt immer die Attribute in Ihrer aktiven Konfiguration an.
Wenn Sie die aktive Konfiguration für einen einzelnen Befehlsaufruf ändern möchten, verwenden Sie das Flag --configuration für einen beliebigen gdcloud CLI-Befehl:
gdcloud auth print-identity-token --configuration=CONFIGURATION
Konfigurationen auflisten
Führen Sie Folgendes aus, um die Konfigurationen in Ihrer gdcloud CLI aufzulisten:
gdcloud config configurations list
Die gdcloud CLI 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
Führen Sie Folgendes aus, um die Attribute in der aktiven Konfiguration festzulegen und zu entfernen:
gdcloud config set project PROJECT
Attribute einer Konfiguration aufrufen
Führen Sie Folgendes aus, um die Attribute in einer Konfiguration aufzurufen:
gdcloud config configurations describe NAME
Die gdcloud CLI gibt die Konfigurationsattribute aus:
is_active: false
name: default
properties:
accessibility:
screen_reader: "false"
core:
organization_console_url: https://console.example.com
project: example-project
Führen Sie Folgendes aus, um die Attribute in der aktiven Konfiguration aufzurufen:
gdcloud config list
Konfiguration löschen
Führen Sie Folgendes aus, um eine Konfiguration zu löschen:
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 bei Bedarf gdcloud config configurations activate.