Resource cakupan folder
Config Connector dapat mengelola resource Anda di tingkat project, folder, atau organisasi. Agar Config Connector dapat menentukan tempat membuat resource, Config Connector akan memeriksa kolom penentu cakupan di spesifikasi resource Anda terlebih dahulu. Jika tidak ditemukan, Config Connector akan memeriksa anotasi penentu cakupan.
Menentukan kolom folderRef
Sebagian besar resource Config Connector cakupan folder mendukung kolom bernama folderRef
dalam spesifikasi CRD-nya. Gunakan kolom ini untuk menentukan folder Google Cloud tempat Anda
ingin membuat resource.
Jika folder Google Cloud juga dikelola di cluster yang sama melalui CRD Folder, Anda dapat menentukan folder sebagai referensi resource Kubernetes:
...
spec:
folderRef:
name: FOLDER_RESOURCE_NAME
namespace: FOLDER_RESOURCE_NAMESPACE
...
Pendekatan ini memungkinkan penggunaan Config Connector dan pembuatan folder Google Cloud dengan resource turunannya dalam satu operasi penerapan. Kolom namespace bersifat opsional jika resource Folder Config Connector berada di namespace Kubernetes yang sama dengan resource cakupan folder Anda.
Jika folder Google Cloud tidak dikelola sebagai resource Kubernetes di cluster yang sama, Anda dapat menggunakan kolom external
untuk menentukan ID folder secara langsung. Format persis nilai dapat berbeda-beda, 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"
...
Membuat anotasi konfigurasi resource
Jika resource Config Connector memiliki cakupan 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
...
Berikut adalah contoh tampilan YAML resource dengan anotasi ini di dalamnya:
apiVersion: foo.cnrm.cloud.google.com/v1beta1
kind: FooBar
metadata:
annotations:
cnrm.cloud.google.com/folder-id: FOLDER_ID
name: foobarname
Menganotasi konfigurasi namespace
Anda dapat menetapkan ID folder default untuk resource yang baru dibuat dengan menganotasi namespace Kubernetes. Jika salah satu resource dalam namespace memiliki anotasi ini yang ditetapkan secara eksplisit dalam konfigurasinya sendiri, anotasi tingkat resource akan menimpa anotasi tingkat namespace.
Untuk menganotasi 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 AndaFOLDER_ID
: ID folder Google Cloud 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 folder Google Cloud AndaNAMESPACE_NAME
: nama namespace Anda
Setelah membuat file, terapkan ke cluster Anda.