Ressourcen in Config Connector exportieren und importieren
Auf dieser Seite wird der Befehl config-connector export
beschrieben und wie Sie damit Google Cloud Ressourcen in YAML-Dateien exportieren, um diese in Config Connector zu importieren. Wenn Sie bereits Zugriff auf die YAML-Datei der Ressource haben, folgen Sie stattdessen der Anleitung unter Ressourcen verwalten und löschen, um die Ressource abzurufen.
Beschränkungen
Nicht alle Ressourcen unterstützen den Befehl export
. Führen Sie den Befehl config-connector print-resources
aus, um eine Liste der unterstützten Ressourcen abzurufen.
Hinweise
- Installieren Sie das
config-connector
-Befehlszeilentool. - Um Befehle zu vereinfachen, legen Sie Ihren Standard-Namespace mit dem folgenden Befehl fest:
Ersetzen Siekubectl config set-context --current --namespace NAMESPACE_NAME
NAMESPACE_NAME
durch den Namen Ihres Namespace. - Rufen Sie den vollständigen Ressourcennamen der Ressource ab, die Sie exportieren möchten.
Wenn Sie den vollständigen Namen der Ressource nicht kennen, können Sie ihn möglicherweise mit einer der folgenden Methoden ermitteln:
- Cloud Asset Inventory verwenden, um nach einer Ressource zu suchen
- Verwenden Sie den Befehl
describe
oderlist
für die Ressource, z. B.gcloud pubsub topics describe sample-topic --format "value(name)"
. - In der Produktdokumentation der Ressource finden Sie eine Anleitung zum Abrufen der Ressourcen-ID, z. B. Cloud Key Management Service-Ressourcen-ID abrufen.
Ressource exportieren
Mit dem config-connector
-CLI-Tool können Sie eine vorhandene Ressource in eine YAML-Datei exportieren.
Führen Sie den folgenden Befehl aus, um eine Ressource in eine YAML-Datei zu exportieren:
config-connector export RESOURCE_ID
Ersetzen Sie RESOURCE_ID
durch den vollständigen Namen der Ressource, die Sie exportieren möchten.
Der Befehl gibt die Ressource im YAML-Format aus, das von Config Connector verwendet werden kann. Die Ausgabe sollte in etwa so aussehen:
apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
kind: PubSubTopic
metadata:
annotations:
cnrm.cloud.google.com/project-id: my-example-project
name: sample-topic
Ressource in Config Connector importieren
Nachdem Sie die YAML-Datei für die Ressource haben, die Config Connector abrufen soll, führen Sie die folgenden Schritte aus:
Übergeben Sie Ihre Ressource mit dem folgenden Befehl an Config Connector:
config-connector export RESOURCE_ID | kubectl apply -f - --namespace NAMESPACE
Ersetzen Sie
NAMESPACE
durch den Namespace, von dem aus Config Connector Ressourcen verwaltet.Prüfen Sie mit dem folgenden Befehl, ob Config Connector die Ressource verwaltet:
kubectl describe RESOURCE_TYPE RESOURCE_NAME
Ersetzen Sie Folgendes:
RESOURCE_TYPE
: Der Ressourcentyp, z. B.pubsubtopic
.RESOURCE_NAME
: der Ressourcenname. Das muss nicht der vollständige Ressourcenname sein.
Nachdem Config Connector die Ressource abgerufen hat, können Sie sie mit den Schritten unter Ressourcen verwalten und löschen verwalten.
Optionale Felder für das config-connector
-Befehlszeilentool
Wenn Sie den Befehl config-connector export
ausführen, können Sie die folgenden optionalen Felder übergeben:
config-connector export RESOURCE_NAME \
--output FILENAME \
--oauth2-token TOKEN \
--iam-format [policy | policymember | none] \
--filter-deleted-iam-members [true | false] \
--verbose
--output
ist ein optionaler Ausgabepfad, der die Standardausgabe deaktiviert. Bei einer Datei enthält das Ergebnis die gesamte Befehlsausgabe. Bei einem Verzeichnis enthält das Verzeichnis eine neue Datei für jede Ressource in der Ausgabe.--oauth2-token
: Ein OAUTH2-Token als Google Cloud -Identität. Standardmäßig verwendetconfig-connector
die Google Cloud CLI-Standardanmeldedaten.--iam-format
: Gibt den Typ der IAM-Ressourcen an, die bei Ihrem Export ausgegeben werden. Verfügbare Optionen sindpolicy
(Standard),policymember
odernone
.--filter-deleted-iam-members
: Gibt an, ob gelöschte IAM-Hauptkonten herausgefiltert werden sollen. Optionen sindtrue
oderfalse
. Der Standardwert istfalse
.--verbose
: Aktiviert die ausführliche Protokollierung.
Nächste Schritte
- Informationen zum Abrufen vorhandener Google Cloud Ressourcen mit Config Connector
- Informationen zu den von Config Connector unterstützten Ressourcen