Resource yang cakupannya folder

Config Connector dapat mengelola resource Anda di tingkat project, folder, atau organisasi. Agar Config Connector dapat menentukan tempat untuk membuat resource Anda, Config Connector akan memeriksa kolom yang menentukan cakupan dalam spesifikasi resource Anda terlebih dahulu. Jika tidak ditemukan, Config Connector akan memeriksa anotasi yang menentukan cakupan.

Menentukan kolom folderRef

Sebagian besar resource Config Connector yang cakupannya folder mendukung kolom bernama folderRef dalam spesifikasi CRD-nya. Gunakan kolom ini untuk menentukan Google Cloud folder tempat Anda ingin membuat resource.

Jika Google Cloud folder juga dikelola di cluster yang sama melalui the Folder CRD, Anda dapat menentukan folder sebagai referensi resource Kubernetes:

...
spec:
  folderRef:
    name: FOLDER_RESOURCE_NAME
    namespace: FOLDER_RESOURCE_NAMESPACE
...

Pendekatan ini memungkinkan Anda menggunakan Config Connector dan membuat Google Cloud folder dengan resource turunannya dalam satu operasi penerapan. Kolom namespace bersifat opsional jika resource Folder Config Connector berada di namespace Kubernetes yang sama dengan resource yang cakupannya folder.

Jika Google Cloud folder tidak dikelola sebagai resource Kubernetes di cluster yang sama, Anda dapat menggunakan external field untuk menentukan folder ID secara langsung. Format pasti nilai mungkin berbeda, bergantung pada jenis resource. Dua format yang paling umum adalah "FOLDER_ID" dan "folders/FOLDER_ID". Lihat contoh "FOLDER_ID" di bawah:

...
spec:
  folderRef:
    external: "FOLDER_ID"
...

Anotasi konfigurasi resource

Jika resource Config Connector cakupannya folder, tetapi tidak mendukung kolom folderRef, Anda dapat menetapkan ID folder ke konfigurasi resource menggunakan anotasi folder-id:

...
metadata:
  annotations:
    cnrm.cloud.google.com/folder-id: FOLDER_ID
...

Contoh berikut menunjukkan tampilan konfigurasi YAML resource dengan anotasi ini:

apiVersion: SERVICE_NAME.cnrm.cloud.google.com/v1beta1
kind: RESOURCE_KIND
metadata:
  annotations:
    cnrm.cloud.google.com/folder-id: FOLDER_ID
  name: RESOURCE_NAME

Ganti kode berikut:

  • SERVICE_NAME: nama Google Cloud layanan untuk resource
  • RESOURCE_KIND: jenis resource Config Connector
  • FOLDER_ID: ID Google Cloud folder Anda
  • RESOURCE_NAME: nama resource

Anotasi konfigurasi namespace

Anda dapat menetapkan ID folder default untuk resource yang baru dibuat dengan memberi anotasi pada namespace Kubernetes. Jika salah satu resource dalam namespace memiliki anotasi ini yang ditetapkan secara eksplisit dalam konfigurasinya sendiri, anotasi tingkat resource akan mengganti anotasi tingkat namespace.

Untuk memberi anotasi pada namespace menggunakan command line, jalankan perintah berikut:

kubectl annotate namespace NAMESPACE_NAME cnrm.cloud.google.com/folder-id=FOLDER_ID

Ganti kode berikut:

  • NAMESPACE_NAME: nama namespace Anda
  • FOLDER_ID: ID Google Cloud folder Anda

Atau, Anda dapat menerapkan manifes YAML yang berisi anotasi. Salin YAML di bawah ke dalam file:

apiVersion: v1
kind: Namespace
metadata:
  annotations:
    cnrm.cloud.google.com/folder-id: FOLDER_ID
  name: NAMESPACE_NAME

Ganti kode berikut:

  • FOLDER_ID: ID Google Cloud folder Anda
  • NAMESPACE_NAME: nama namespace Anda

Setelah membuat file, terapkan ke cluster Anda.