Mengelola resource dengan kolom resourceID

Halaman ini menjelaskan cara mengelola resource dengan kolom resourceID.

Config Connector memungkinkan Anda menentukan resource ID Google Cloud resource menggunakan kolom resourceID yang tidak dapat diubah tetapi bersifat opsional untuk membuat atau memperoleh sumber daya. "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 Anda.

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

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

Jenis ID resource

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

ID resource yang ditentukan pengguna
ID resource yang ditentukan, ditentukan, dan diteruskan oleh pengguna sebelum pembuatan resource. Anda bisa membuat atau memperoleh resource yang memiliki ID resource yang ditentukan pengguna dengan kolom resourceID.
ID resource yang dibuat layanan
ID resource yang dibuat 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 ini tidak ditentukan jika Anda ingin membuat resource yang memiliki ID resource buatan layanan. Lihat daftar Resource dengan resource yang dihasilkan layanan ID.

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 {i>dataset <i}BigQuery baru menggunakan Config Connector dengan kolom resourceID. Nilai resourceID harus mengikuti konvensi penamaan untuk kolom datasetId dari 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

    Mengganti CC_NAMESPACE dengan namespace Config Connector mengelola resource.

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

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

    Mengganti CC_NAMESPACE dengan namespace Config Connector mengelola resource.

Mendapatkan resource dengan kolom resourceID

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

  • Resource memiliki ID resource yang ditentukan pengguna, dan nilai dalam manifes dan nama resource mencocokkan dengan sumber daya yang ada; Atau,
  • Resource memiliki ID resource yang dibuat layanan.

Mendapatkan 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 diakuisisi.
    • ACQUIRED_FOLDER_DISPLAY_NAME dengan nama tampilan untuk folder yang akan didapat.

  2. Terapkan file YAML ke cluster Anda.

    kubectl apply --namespace CC_NAMESPACE -f folder.yaml

    Mengganti CC_NAMESPACE dengan namespace Config Connector mengelola resource.

  3. Gunakan kubectl describe untuk melihat detail pada folder.

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

    Mengganti CC_NAMESPACE dengan namespace Config Connector mengelola resource.

Langkah selanjutnya

Tinjau Referensi resource untuk pelajari resource yang didukung Config Connector.