SDK-Konfigurationen verwalten

Was ist eine Konfiguration?

Eine Konfiguration ist ein benannter Satz von SDK-Properties. Diese Attribute sind Schlüssel/Wert-Paare, die die Funktionsweise des gcloud-Befehlszeilentools und anderer SDK-Tools steuern.

Zu den Properties, die üblicherweise in den Konfigurationen gespeichert werden, gehören die Google 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.

Wenn Sie mehrere Konfigurationen haben, können Sie zwischen ihnen wechseln oder Befehle mithilfe einer bestimmten Konfiguration ausführen (mithilfe des Flags --configuration). Weitere Informationen zum Wechseln zwischen Konfigurationen finden Sie im Abschnitt Konfigurationen aktivieren.

Führen Sie den Befehl gcloud topic configurations aus, um mehr über Konfigurationen über die Befehlszeile zu erfahren und eine vollständige Liste verfügbarer Properties anzeigen zu lassen.

Standardkonfiguration

Das SDK beginnt mit der Einzelkonfiguration default. Durch Ausführen des Befehls gcloud init oder direktes Ausführen des Befehls gcloud config set können Sie Attribute in der Konfiguration festlegen.

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. Allerdings können Sie auch zusätzliche Konfigurationen erstellen und mit gcloud config configurations activate zwischen ihnen 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 Google 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 gcloud config configurations create aus, um eine Konfiguration zu erstellen:

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 mit den Eigenschaften, die das Verhalten der SDK-Tools bestimmen.

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, verwenden Sie das Flag --configuration für jeden gcloud-Kommandozeilenbefehl:

gcloud auth list --configuration=[CONFIGURATION_NAME]

Wenn Sie die aktive Konfiguration für alle Befehle in Ihrem aktuellen Terminal ändern möchten, legen Sie für die Umgebungsvariable CLOUDSDK_ACTIVE_CONFIG_NAME den Namen der Konfiguration fest, die Sie verwenden möchten.

Konfigurationswechsel automatisieren

Wenn Sie nahtlos zwischen Konfigurationen wechseln möchten, können Sie Tools wie direnv und ondir verwenden, um automatisch eine andere Konfiguration zu nutzen, wenn Sie das Arbeitsverzeichnis wechseln. Eine Möglichkeit besteht darin, die erforderlichen Umgebungsvariablen (wie CLOUDSDK_ACTIVE_CONFIG_NAME) in der .envrc-Datei im Stammverzeichnis Ihres Projekts festzulegen.

Konfigurationen auflisten

Mit gcloud config configurations list listen Sie die Konfigurationen in der Cloud SDK-Installation auf:

gcloud config configurations list

Die gcloud-Kommandozeile listet die Konfigurationen auf und zeigt an, welche Konfiguration gerade 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 disable_usage_reporting

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

Mit gcloud config configurations delete löschen Sie eine Konfiguration:

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.

Nächste Schritte

Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:

Feedback geben zu...

Cloud SDK-Dokumentation