Mengekspor dan mengimpor resource ke Config Connector

Halaman ini menjelaskan perintah config-connector export dan cara menggunakannya untuk mengekspor Google Cloud resource ke dalam file YAML, yang selanjutnya 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 tersebut.

Batasan

Tidak semua resource mendukung perintah export. Untuk mendapatkan daftar resource yang didukung, jalankan config-connector print-resources.

Tips: Jika resource tidak didukung oleh export, tetapi didukung oleh bulk-export, Anda dapat mencoba memfilter ekspor Inventaris Aset dengan bulk-export.

Sebelum memulai

1. Instal alat CLI config-connector.
2. Untuk menyederhanakan perintah, tetapkan namespace default Anda dengan menjalankan perintah berikut:

   kubectl config set-context --current --namespace NAMESPACE_NAME

   Ganti NAMESPACE_NAME dengan nama namespace Anda.
3. Dapatkan nama resource lengkap untuk resource yang ingin Anda ekspor. Jika Anda tidak mengetahui nama lengkap resource, Anda mungkin dapat menemukannya dengan salah satu metode berikut:
   • Gunakan Inventaris Aset Cloud untuk menelusuri resource.
   • Gunakan perintah describe atau list untuk resource, misalnya gcloud pubsub topics describe sample-topic --format "value(name)".
   • Periksa dokumentasi produk resource untuk panduan 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 dalam file YAML, jalankan perintah berikut:

config-connector export RESOURCE_ID

Ganti RESOURCE_ID dengan nama lengkap resource yang ingin Anda ekspor.

Perintah ini akan menampilkan resource dalam format YAML yang dapat digunakan oleh Config Connector. Output-nya akan menyerupai 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 Anda memiliki file YAML untuk resource yang ingin Anda dapatkan oleh Config Connector, selesaikan langkah-langkah berikut:

1. 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.

2. Konfirmasi bahwa Config Connector mengelola resource dengan menjalankan perintah berikut:

   kubectl describe RESOURCE_TYPE RESOURCE_NAME
   

   Ganti kode berikut:

   • RESOURCE_TYPE: jenis resource, misalnya pubsubtopic.
   • RESOURCE_NAME: nama resource. Nama ini tidak harus nama resource lengkap.

Setelah Config Connector mendapatkan resource, Anda dapat mengelola resource tersebut dengan mengikuti langkah-langkah di Mengelola dan menghapus resource.

Kolom opsional alat CLI config-connector

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 Google Cloud identitas. Secara default, config-connector menggunakan kredensial Google Cloud CLI.
• --iam-format: Menentukan jenis output resource IAM dengan ekspor Anda. Opsi yang tersedia adalah policy (default), policymember, atau none.
• --filter-deleted-iam-members: Menentukan apakah akan memfilter principal IAM yang dihapus. Opsi yang tersedia adalah true atau false. Nilai defaultnya adalah false.
• --verbose: Mengaktifkan logging panjang.

Langkah berikutnya

• Baca cara Config Connector mendapatkan resource yang ada Google Cloud .
• Pelajari resource yang didukung Config Connector.