Mengelola resource dengan kolom resourceID

Halaman ini menjelaskan cara mengelola resource dengan kolom resourceID.

Dengan Config Connector, Anda dapat menentukan ID resource secara eksplisit untuk resource Google Cloud menggunakan kolom resourceID yang bersifat opsional tetapi tidak dapat diubah untuk membuat atau memperoleh resource. "Tidak dapat diubah, tetapi opsional" berarti Anda dapat memilih untuk menentukan atau tidak menentukan kolom resourceID, tetapi Anda tidak dapat membuat perubahan apa pun pada nilai kolom resourceID setelah menerapkan manifes ke cluster.

Kolom resourceID meningkatkan fleksibilitas penamaan resource Google Cloud yang memiliki ID resource yang ditentukan pengguna. Dengan menggunakan kolom resourceID di resource Config Connector, Anda dapat menentukan beberapa resource Config Connector yang sama jenisnya dengan nama resource Google Cloud yang sama di project, folder, organisasi, atau resource induk berbeda dalam namespace yang sama. Nama resource Google Cloud juga tidak dibatasi oleh konvensi penamaan nama objek Kubernetes. Selain itu, kolom resourceID memungkinkan akuisisi resource Google Cloud yang memiliki ID resource yang dihasilkan layanan.

Config Connector menjadikan namespace sebagai "pemilik" resource agar tidak diambil oleh pemilik lain. Namun, jika Anda menggunakan kolom resourceID, mungkin ada beberapa resource dengan nama resource Google Cloud yang sama, yang dibuat dengan namespace yang sama. Resource ini menimbulkan konflik yang tidak dapat dikelola oleh Config Connector. Anda harus menyelesaikan konflik secara manual.

Jenis ID resource

Di Config Connector, ID resource dapat ditentukan oleh pengguna atau dihasilkan layanan.

ID resource yang ditentukan pengguna
ID resource yang ditentukan, ditentukan, dan diteruskan oleh pengguna sebelum pembuatan resource. Anda dapat membuat atau memperoleh resource yang memiliki ID resource yang ditentukan pengguna dengan kolom resourceID.
ID resource yang dihasilkan layanan
ID resource yang dihasilkan oleh layanan selama pembuatan resource. Resource ini dapat diambil oleh pengguna setelah resource berhasil dibuat. Anda dapat memperoleh resource yang memiliki ID resource yang dihasilkan layanan dengan kolom resourceID. Biarkan kolom tidak ditentukan jika Anda ingin membuat resource baru yang memiliki ID resource yang dihasilkan layanan. Lihat daftar Resource dengan ID resource yang dihasilkan layanan.

Menentukan kolom resourceID

Anda dapat menentukan kolom resourceID di spec resource.

Manifes berikut menjelaskan cara menentukan kolom resourceID untuk topik Pub/Sub. Nama resource Config Connector adalah pubsub-topic-sample dan nama topik Pub/Sub adalah pubsub-topic-id.

apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
kind: PubSubTopic
metadata:
  name: pubsub-topic-sample
spec:
  resourceID: pubsub-topic-id

Membuat resource dengan kolom resourceID

Membuat set data BigQuery

Dalam contoh ini, Anda membuat set data BigQuery baru menggunakan Config Connector dengan kolom resourceID. Nilai kolom resourceID harus mengikuti konvensi penamaan untuk kolom datasetId set data BigQuery.

  1. Salin konten berikut ke dalam file bernama bigquery-dataset.yaml.

      apiVersion: bigquery.cnrm.cloud.google.com/v1beta1
  kind: BigQueryDataset
  metadata:
    name: bigquerydataset-sample-for-creation
  spec:
    resourceID: bigquerydataset_sample_with_resourceid
    defaultTableExpirationMs: 3600000
    description: "BigQuery Dataset Sample with the ResourceID Field"
    friendlyName: bigquerydataset-sample-with-resourceid
    location: US

  2. Terapkan file YAML ke cluster Anda.

    kubectl apply --namespace CC_NAMESPACE -f bigquery-dataset.yaml

    Ganti CC_NAMESPACE dengan Config Connector namespace yang mengelola resource.

  3. Gunakan kubectl describe untuk melihat detail di set data.

    kubectl describe --namespace CC_NAMESPACE bigquerydataset bigquerydataset-sample-for-creation

    Ganti CC_NAMESPACE dengan Config Connector namespace yang mengelola resource.

Mendapatkan resource dengan kolom resourceID

Saat Anda mengelola resource Google Cloud dengan kolom resourceID, Config Connector akan memperoleh resource jika:

  • Resource memiliki ID resource yang ditentukan pengguna, dan nilai dalam manifes serta nama resource cocok dengan resource yang ada; Atau,
  • Resource memiliki ID resource yang dihasilkan layanan.

Memperoleh folder

Untuk mendapatkan folder menggunakan Config Connector dengan kolom resourceID, selesaikan langkah-langkah berikut:

  1. Salin konten berikut ke dalam file bernama folder.yaml.

        apiVersion: resourcemanager.cnrm.cloud.google.com/v1beta1
    kind: Folder
    metadata:
      annotations:
        cnrm.cloud.google.com/organization-id: ORG_ID
        # Remove the deletion-policy annotation if it is safe to delete the
        # folder when the resource is deleted from your cluster.
        cnrm.cloud.google.com/deletion-policy: "abandon"
      name: folder-sample-for-acquisition
    spec:
      resourceID: ACQUIRED_FOLDER_ID
      displayName: ACQUIRED_FOLDER_DISPLAY_NAME

    Ganti kode berikut:

    • ORG_ID dengan ID numerik untuk organisasi Anda.
    • ACQUIRED_FOLDER_ID dengan ID numerik untuk folder yang akan diperoleh.
    • ACQUIRED_FOLDER_DISPLAY_NAME dengan nama tampilan untuk folder yang akan diperoleh.

  2. Terapkan file YAML ke cluster Anda.

    kubectl apply --namespace CC_NAMESPACE -f folder.yaml

    Ganti CC_NAMESPACE dengan Config Connector namespace yang mengelola resource.

  3. Gunakan kubectl describe untuk melihat detail pada folder.

    kubectl describe --namespace CC_NAMESPACE folder folder-sample-for-acquisition

    Ganti CC_NAMESPACE dengan Config Connector namespace yang mengelola resource.

Langkah selanjutnya

Tinjau Referensi resource untuk mempelajari resource yang didukung Config Connector.