NAME
gdcloud topic configurations – Zusätzliche Hilfe für benannte Konfigurationen
BESCHREIBUNG
gdcloud CLI-Attribute können in benannten Konfigurationen gespeichert werden. Diese sind Sammlungen von Schlüssel/Wert-Paaren, die das Verhalten der gdcloud CLI beeinflussen.
Benannte Konfigurationen sind nützlich, wenn Sie mehr als ein Projekt oder eine Organisation verwalten.
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 als Gruppe definieren und aktivieren.
Konfigurationsdaten werden in $HOME/.config/gdcloud/ gespeichert.
Konfigurationen sind besonders nützlich, wenn Sie
+ mit mehreren Projekten arbeiten. Sie können für jedes Projekt eine eigene Konfiguration erstellen.
- mehrere URLs der Organisationskonsole verwenden.
* allgemein unabhängige Aufgaben ausführen. Sie können beispielsweise eine Konfiguration für die Arbeit mit dem Object Storage-Dienst in einem Projekt verwenden und mit einer weiteren Konfiguration einen separaten Dienst in einem anderen Projekt verwalten.
Attributinformationen, die in benannten Konfigurationen gespeichert sind, können von allen gdcloud CLI-Befehlen gelesen werden. Verwenden Sie den Befehl gdcloud config set, um die Attribute festzulegen.
Konfigurationen erstellen
Benannte Konfigurationen können von Nutzern definiert oder in die gdcloud CLI integriert werden.
Nutzerdefinierte Konfigurationen haben Namen in Kleinbuchstaben, z. B. johndoe, default, jeff-staging oder foo2. Sie werden durch den folgenden regulären Ausdruck definiert: ^[a-z][-a-z0-9]*$.
Führen Sie folgenden Befehl aus, um eine neue Konfiguration zu erstellen:
gdcloud init
Hier erfahren Sie, wie Sie Ihre erste benannte Konfiguration einrichten, eine neue benannte Konfiguration erstellen oder eine vorhandene benannte Konfiguration neu initialisieren. Wenn Sie eine vorhandene Konfiguration neu initialisieren, werden alle vorhandenen Attribute entfernt.
Führen Sie folgenden Befehl aus, um eine neue leere Konfiguration zu erstellen:
gdcloud config configurations create [CONFIG_NAME]
Konfigurationen verwenden
In der gdcloud CLI sollte höchstens eine aktive Konfiguration vorhanden sein, die Attributwerte bereitstellt. Inaktive Konfigurationen haben keine Auswirkungen auf die Ausführung der gdcloud CLI. Führen Sie folgenden Befehl aus, um eine Konfiguration zu aktivieren:
gdcloud config configurations activate [CONFIG_NAME]
Führen Sie folgenden Befehl aus, um die Attribute Ihrer aktiven Konfiguration aufzurufen und zu ändern:
gdcloud config list
gdcloud config set
Außerdem können Sie mit den Befehlen unter der Gruppe gdcloud config configurations Konfigurationen auflisten, aktivieren, umbenennen, beschreiben und löschen, die aktiv sein können oder nicht.
Mit dem Flag --configuration my-config können Sie eine Konfiguration für einen einzelnen gdcloud-Aufruf aktivieren.
Verfügbare Attribute
accessibility
* screen_reader
* Wenn festgelegt, aktiviert die gdcloud CLI die Sprachausgabe.
auth
* login_config_cert_path
* Pfad der Datei, in der das aktuelle Zertifikat der Anmeldekonfiguration gespeichert ist.
component_manager
* disable_update_check
* Wenn festgelegt, sucht die gdcloud CLI nicht automatisch nach Updates.
core
* disable_prompts
* Wenn „True“, wird für alle Eingabeaufforderungen die Standardantwort angenommen. Bei Eingabeaufforderungen, für die eine Nutzereingabe erforderlich ist, wird jedoch ein Fehler ausgegeben.
* format
* Legen Sie das Format für das Drucken von Befehlsausgaberessourcen fest. Die Standardeinstellung ist ein befehlsspezifisches, benutzerfreundliches Ausgabeformat. Wenn sowohl core/format als auch --format angegeben sind, hat --format Vorrang. Die unterstützten Formate sind auf csv, json, table, text und yaml beschränkt.
* organization_console_url
* URL der aktuellen Organisations-UI/Konsole. Sie sollte mit https //console. beginnen. Beispiel: https //console.org-name.gdch.google.com.
* project
* Aktueller Projektname.
storage
* s3_access_key_id
* Zugriffsschlüssel-ID des S3-Speicherobjekts. Dies ist eine eindeutige Kennung für Nutzer.
* s3_custom_ca_certs_file
* Datei mit benutzerdefinierten Zertifikaten für das S3-Speicherobjekt.
* s3_endpoint
* Die URL des S3-Objekts besteht aus S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME. S3_ENDPOINT ist der Speicherort des S3-Speicherbuckets.
* s3_region
* Der Name der S3-Region, in der sich der S3-Speicherbucket befindet. Die Standardeinstellung ist us-east-1.
* s3_secret_access_key
* Privater Schlüssel des S3-Speicherobjekts, der zum Signieren von Anfragen verwendet wird.