Mengekspor dan mengimpor resource ke Config Connector
Halaman ini menjelaskan perintah config-connector export
dan cara menggunakannya untuk
mengekspor resource Google Cloud ke dalam file YAML,
yang kemudian dapat Anda impor ke Config Connector. Jika Anda sudah memiliki akses ke file YAML resource,
ikuti langkah-langkah di Mengelola dan menghapus resource
untuk mendapatkan resource.
Batasan
Tidak semua resource mendukung perintah export
. Untuk mendapatkan daftar resource
yang didukung, jalankan config-connector print-resources
.
Sebelum memulai
- Instal alat
config-connector
CLI. - Untuk menyederhanakan perintah, tetapkan namespace default dengan menjalankan perintah berikut:
Gantikubectl config set-context --current --namespace NAMESPACE_NAME
NAMESPACE_NAME
dengan nama namespace Anda. - Dapatkan nama resource lengkap untuk resource yang ingin Anda ekspor.
Jika tidak mengetahui nama lengkap resource, Anda mungkin dapat menemukannya dengan salah satu metode berikut:
- Gunakan Inventaris Aset Cloud untuk menelusuri resource.
- Gunakan perintah
describe
ataulist
untuk resource, misalnyagcloud pubsub topics describe sample-topic --format "value(name)"
. - Periksa dokumentasi produk resource untuk mendapatkan panduan tentang cara mendapatkan ID resource, misalnya Mendapatkan ID resource Cloud Key Management Service.
Mengekspor resource
Anda dapat menggunakan alat CLI config-connector
untuk mengekspor resource yang ada ke dalam file YAML.
Untuk mengekspor resource ke file YAML, jalankan perintah berikut:
config-connector export RESOURCE_ID
Ganti RESOURCE_ID
dengan nama lengkap resource yang ingin Anda ekspor.
Perintah ini menghasilkan resource dalam format YAML yang dapat digunakan oleh Config Connector. Output akan terlihat seperti contoh berikut:
apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
kind: PubSubTopic
metadata:
annotations:
cnrm.cloud.google.com/project-id: my-example-project
name: sample-topic
Mengimpor resource ke Config Connector
Setelah memiliki file YAML untuk resource yang ingin diperoleh Config Connector, selesaikan langkah-langkah berikut:
Teruskan resource Anda ke Config Connector dengan menjalankan perintah berikut:
config-connector export RESOURCE_ID | kubectl apply -f - --namespace NAMESPACE
Ganti
NAMESPACE
dengan namespace tempat Config Connector mengelola resource.Pastikan Config Connector mengelola resource dengan menjalankan perintah berikut:
kubectl describe RESOURCE_TYPE RESOURCE_NAME
Ganti kode berikut:
RESOURCE_TYPE
: jenis resource, misalnyapubsubtopic
.RESOURCE_NAME
: nama resource. Nama ini tidak harus berupa nama resource lengkap.
Setelah Config Connector mengakuisisi resource, Anda dapat mengelola resource tersebut dengan mengikuti langkah-langkah di Mengelola dan menghapus resource.
config-connector
Kolom opsional alat CLI
Saat menjalankan perintah config-connector export
, Anda dapat meneruskan
kolom opsional berikut:
config-connector export RESOURCE_NAME \
--output FILENAME \
--oauth2-token TOKEN \
--iam-format [policy | policymember | none] \
--filter-deleted-iam-members [true | false] \
--verbose
--output
: Jalur output opsional yang menonaktifkan output standar. Jika berupa file, hasilnya akan berisi semua output perintah; jika berupa direktori, direktori akan berisi file baru untuk setiap resource dalam output.--oauth2-token
: Token OAUTH2 sebagai identitas Google Cloud . Secara default,config-connector
menggunakan kredensial default Google Cloud CLI.--iam-format
: Menentukan jenis output resource IAM dengan ekspor Anda. Opsi yang tersedia adalahpolicy
(default),policymember
, ataunone
.--filter-deleted-iam-members
: Menentukan apakah akan memfilter akun utama IAM yang dihapus. Opsinya adalahtrue
ataufalse
. Nilai defaultnya adalahfalse
.--verbose
: Mengaktifkan logging panjang.
Langkah berikutnya
- Baca cara Config Connector mendapatkan resource Google Cloud yang ada.
- Pelajari resource yang didukung Config Connector.