Membuat referensi resource

---

Resource Google Cloud yang dibuat dengan Config Connector dapat merujuk ke resource lain. Config Connector menentukan hubungan ini melalui referensi resource. Topik ini menjelaskan cara membuat resource dengan referensi.

Jenis referensi

Di Config Connector, referensi dapat berupa dependensi atau link.

Dependensi

Referensi dependensi mengacu pada resource Google Cloud yang ada yang diperlukan untuk resource Config Connector. Misalnya, aturan firewall tidak dapat ada tanpa jaringan

Link

Referensi link menghubungkan beberapa resource independen. Misalnya, Project dapat dikaitkan dengan Akun Penagihan.

Menentukan referensi resource

Anda menetapkan referensi resource dalam spec resource. Nama kolom adalah nama pendek resource yang diikuti dengan Ref. Contoh:

• Referensi ke PubSubTopic bernama topic adalah topicRef.
• Referensi ke StorageBucket bernama bucket adalah bucketRef.

Referensinya adalah objek dengan satu kolom (name). Resource di resourceRef diganti dengan nama referensi.

File YAML berikut menjelaskan PubSubSubscription Pub/Sub yang mereferensikan PubSubTopic bernama myTopic.

apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
kind: PubSubSubscription
metadata:
  name: pubsubsubscription-referencing-topic
spec:
  topicRef:
    name: myTopic

Contoh Pub/Sub

Membuat PubSubTopic

Dalam contoh ini, Anda membuat PubSubSubscription yang bergantung pada PubSubTopic.

1. Salin kode berikut ke dalam file bernama pubsub-topic.yaml:

   apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
   kind: PubSubTopic
   metadata:
   name: TOPIC_NAME
   

   Ganti TOPIC_NAME dengan nama PubSubTopic yang diinginkan

   Misalnya, untuk membuat topik bernama myTopic, Anda dapat menggunakan file YAML berikut:

   apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
   kind: PubSubTopic
   metadata:
     name: myTopic
   

2. Buat PubSubTopic dengan kubectl apply.

   kubectl --namespace CC_NAMESPACE apply -f pubsub-topic.yaml

   Ganti CC_NAMESPACE dengan Config Connector namespace yang mengelola resource.

Membuat PubSubSubscription

1. Salin kode berikut ke dalam file bernama `pubsub-subscription.yaml:

   apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
   kind: PubSubSubscription
   metadata:
     name: pubsubsubscription-referencing-topic
   spec:
     topicRef:
       name: TOPIC_NAME
   

   Ganti TOPIC_NAME dengan nama PubSubTopic yang Anda gunakan di langkah 1. Misalnya, YAML yang merujuk ke topik myTopic yang Anda buat sebelumnya adalah:

   apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
   kind: PubSubSubscription
   metadata:
     name: pubsubsubscription-referencing-topic
   spec:
     topicRef:
       name: myTopic
   

2. Buat PubSubSubscription dengan kubectl apply.

   kubectl --namespace CC_NAMESPACE apply -f pubsub-subscription.yaml 

   Ganti CC_NAMESPACE dengan Config Connector namespace yang mengelola resource.

Referensi eksternal

Config Connector dapat merujuk resource yang tidak dikelolanya. Hal ini dikenal sebagai Referensi Eksternal. Misalnya, ComputeURLMap di bawah merujuk ke BackendService bernama test-backendservice.

apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeURLMap
metadata:
  name: test-urlmap
spec:
  location: global
  defaultService:
    backendServiceRef:
      external: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/test-backendservice

Format nilai yang diterima oleh external bergantung pada resource. Lihat dokumentasi untuk resource tertentu di Referensi resource. Anda dapat mengetahui nilai yang diterima external dengan membaca deskripsi kolom external resource.

IAMPolicy, IAMPartialPolicy, dan IAMPolicyMember

IAMPolicy, IAMPartialPolicy, dan IAMPolicyMember juga mendukung Referensi Eksternal. Misalnya, IAMPolicyMember di bawah merujuk ke Project dengan project ID test-project.

apiVersion: iam.cnrm.cloud.google.com/v1beta1
kind: IAMPolicyMember
metadata:
  name: test-iampolicymember
spec:
  member: serviceAccount:[email protected]
  role: roles/storage.admin
  resourceRef:
    kind: Project
    external: projects/test-project

Anda dapat mengetahui format yang diterima kolom external dengan membaca dokumentasi referensi. Halaman IAMPolicy, IAMPartialPolicy, dan IAMPolicyMember mencantumkan format yang diterima untuk semua resource yang didukung. Formatnya tercantum di kolom "External Reference Formats" pada tabel Resource yang Didukung. Anda juga dapat membuka halaman referensi setiap resource (misalnya, PubSubTopic) dan melihat nilai yang tercantum dalam baris "IAM External Reference Format" di tabel ringkasan resource.

Referensi lintas namespace

Config Connector memungkinkan resource merujuk resource di namespace lain. Namun, jika Config Connector diinstal dalam mode namespace, Anda harus memberikan izin tambahan ke Config Connector agar bisa mendapatkan referensi lintas namespace.

Misalnya, jika ingin membuat resource di NAMESPACE_A yang mereferensikan resource di NAMESPACE_B, Anda perlu membuat RoleBinding berikut:

apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  namespace: NAMESPACE_B
  name: allow-references-from-NAMESPACE_A
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cnrm-viewer
subjects:
- kind: ServiceAccount
  name: cnrm-controller-manager-NAMESPACE_A
  namespace: cnrm-system

Langkah selanjutnya

• Tinjau Referensi resource untuk mempelajari resource yang didukung Config Connector.

• Lihat cara menggunakan referensi resource ke Secret di cluster Config Connector Anda.