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

  1. Instal alat config-connector CLI.
  2. Untuk menyederhanakan perintah, tetapkan namespace default 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 tidak mengetahui nama lengkap resource, Anda mungkin dapat menemukannya dengan salah satu metode berikut:

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:

  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. Pastikan 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 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 adalah policy (default), policymember, atau none.
  • --filter-deleted-iam-members: Menentukan apakah akan memfilter akun utama IAM yang dihapus. Opsinya adalah true atau false. Nilai defaultnya adalah false.
  • --verbose: Mengaktifkan logging panjang.

Langkah berikutnya