gcloud-Befehlszeilenkonfigurationen verwalten

Eine Konfiguration ist ein benannter Satz von Google Cloud CLI-Attributen. Diese Attribute sind Schlüssel/Wert-Paare, die in Abschnitten organisiert sind und die Funktionsweise der gcloud-Befehlszeile steuern.

Zu den Attributen, die üblicherweise in den Konfigurationen gespeichert werden, gehören die Compute Engine-Zone, der Ausführlichkeitsgrad, Nutzungsberichte, die Projekt-ID sowie ein aktives Nutzer- oder Dienstkonto. Mit Konfigurationen können Sie diese und andere Einstellungen als Gruppe definieren und aktivieren.

Konfigurationen werden im Nutzerverzeichnis gespeichert (normalerweise ~/.config/gcloud unter macOS und Linux oder %APPDATA%\gcloud unter Windows). Den Speicherort des Konfigurationsverzeichnisses kannst du mit gcloud info --format='value(config.paths.global_config_dir)' abrufen. Sie können das Konfigurationsverzeichnis ändern, indem Sie die Umgebungsvariable CLOUDSDK_CONFIG festlegen. Beachten Sie auch, dass das Konfigurationsverzeichnis schreibgeschützt sein muss. Wenn Sie Cloud Shell verwenden, werden jedoch Ihre gcloud-Befehlszeileneinstellungen in einem temporären tmp-Ordner gespeichert und nur für den aktuellen Cloud Shell-Tab festgelegt. Sie bleiben nicht sitzungsübergreifend erhalten.

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 Konfigurationen aktivieren.

Führen Sie gcloud 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 gcloud-Befehlszeile startet mit einer einzigen Konfiguration namens default. Sie können Attribute in Ihrer Konfiguration festlegen, indem Sie den Befehl gcloud init ausführen oder gcloud config set direkt ausführen.

Führen Sie beispielsweise folgenden Befehl aus, um die Eingabeaufforderung für Skripts zu deaktivieren:

gcloud config set disable_prompts true

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 mit gcloud config configurations activate nach Bedarf zwischen diesen wechseln. Die ursprüngliche default-Konfiguration hat keine spezielle Bedeutung, sondern wurde nur zur Veranschaulichung erstellt. 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 Autorisierungskonten verwenden
  • Allgemein unabhängige Aufgaben ausführen: Sie können beispielsweise eine Konfiguration für die Arbeit an einer App Engine-Anwendung in einem Projekt verwenden und mit einer weiteren Konfiguration eine separate Compute Engine-Instanz in einem anderen Projekt verwalten.

Konfiguration erstellen

Führen Sie zum Erstellen einer Konfiguration gcloud config configurations create aus:

gcloud 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, deren Attribute das Verhalten der gcloud-Befehlszeile steuern.

Mit gcloud config configurations activate aktivieren Sie eine neue Konfiguration oder wechseln zu einer neuen aktiven Konfiguration:

gcloud config configurations activate [NAME]

gcloud config list gibt immer die Attribute der aktiven Konfiguration zurück.

Wenn Sie die aktive Konfiguration für einen einzelnen Befehlsaufruf ändern möchten, können Sie das Flag --configuration in einem Befehl von gcloud verwenden.

gcloud auth list --configuration=[CONFIGURATION_NAME]

Um die aktive Konfiguration für alle Befehle in Ihrem aktuellen Terminal zu ändern, können Sie für die Umgebungsvariable CLOUDSDK_ACTIVE_CONFIG_NAME den Namen der Konfiguration festlegen, die Sie verwenden möchten.

Konfigurationswechsel automatisieren

Tools wie direnv und ondir können Ihnen dabei helfen, nahtlos zwischen Konfigurationen zu wechseln, wenn Sie ein Arbeitsverzeichnis wechseln. Eine Möglichkeit, dies zu erreichen, besteht darin, die erforderlichen Umgebungsvariablen (z. B. CLOUDSDK_ACTIVE_CONFIG_NAME) in der envrc-Datei im Stammverzeichnis Ihres Projekts festzulegen.

Konfigurationen auflisten

Mit gcloud config configurations list können Sie die Konfigurationen in der gcloud-Befehlszeile auflisten:

gcloud config configurations list

Über die gcloud-Befehlszeile können Sie die Konfigurationen auflisten und sehen, welche Konfiguration aktiv ist:

NAME         IS_ACTIVE     ACCOUNT            PROJECT               DEFAULT_ZONE  DEFAULT_REGION
default      False         user@gmail.com     example-project-1     us-east1-b    us-east1
project-1    False         user@gmail.com     example-project-2     us-east1-c    us-east1
project-2    True          user@gmail.com     example-project-3     us-east1-b    us-east1

Konfigurationsattribute festlegen

Mit gcloud config set und gcloud config unset legen Sie die Attribute in der aktiven Konfiguration fest oder heben ihre Festlegung auf:

gcloud config set project [PROJECT]

gcloud config unset project

Attribute können auch über Umgebungsvariablen namens CLOUDSDK_SECTION_NAME_PROPERTY_NAME festgelegt werden. Sie können beispielsweise die Attribute core/project und compute/zone so festlegen:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]

CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

Attribute einer Konfiguration aufrufen

Mit gcloud config configurations describe rufen Sie die Attribute in einer Konfiguration auf:

gcloud config configurations describe [NAME]

Mit diesem Befehl rufen Sie die Attribute in der aktiven Konfiguration auf:

gcloud config list

Die gcloud-Kommandozeile gibt die Konfigurationsattribute aus:

is_active: false
name: default
properties:
  compute:
    region: us-east1
    zone: us-east1-b
  core:
    account: user@google.com
    project: example-project

Konfiguration löschen

Führen Sie zum Löschen einer Konfiguration den Befehl gcloud config configurations delete aus:

gcloud config configurations delete [NAME]

Die aktive Konfiguration kann nicht gelöscht werden. Wechseln Sie vor dem Löschen gegebenenfalls mit gcloud config configurations activate zu einer anderen Konfiguration.

Weitere Informationen