Mengelola dan menghapus resource
Halaman ini menjelaskan cara Config Connector mengelola resource yang ada dan menangani penghapusan resource.
Saat Anda menentukan resource menggunakan Config Connector, salah satu tindakan berikut akan terjadi:
- Jika resource tidak ada, Config Connector akan membuat resource. Untuk contoh cara membuat resource baru, lihat Memulai.
- Jika resource dengan nama yang sama sudah ada, Config Connector akan mendapatkan resource tersebut dan mulai mengelolanya. Config Connector memeriksa nama di organisasi, project, atau folder. Halaman ini menjelaskan secara mendetail cara Config Connector mendapatkan, mengelola, dan menangani penghapusan resource.
Anda juga dapat mengelola resource menggunakan kolom resourceID. Beberapa resource hanya dapat diperoleh menggunakan kolom resourceID. Beberapa resource hanya dapat dibuat sebagai resource baru dan tidak dapat diperoleh. Untuk mempelajari lebih lanjut, lihat
Mengelola resource dengan kolom resourceID.
Mendapatkan resource yang ada
Bagian ini menjelaskan cara mendapatkan resource yang ada dengan Config Connector, menggunakan resource BigQuery sebagai contoh.
Sebelum memulai
- Aktifkan BigQuery API.
- Pastikan Anda memiliki akses ke
bqalat command line. Jika Anda tidak memilikibq, gunakan Cloud Shell atau instal dengan gcloud CLI.
Mendapatkan set data BigQuery
Config Connector mendapatkan, atau mengambil kontrol atas, resource saat nilai dalam manifes dan nama resource cocok. Jika resource tidak memiliki nama (misalnya, Project ID), ID resource akan digunakan.
Dengan membuat set data BigQuery kosong, lalu mendapatkan set data dengan Config Connector, Anda akan mempelajari cara Config Connector menangani resource yang ada.
Buat set data BigQuery bernama
bigquerydatasetsampledenganbq.bq --location=US mk \--dataset \ --default_table_expiration 3600 \ --description description \ PROJECT_ID:bigquerydatasetsampleSalin konten berikut ke dalam file bernama
bq-sample.yaml.apiVersion: bigquery.cnrm.cloud.google.com/v1beta1 kind: BigQueryDataset metadata: name: bigquerydatasetsample spec: defaultTableExpirationMs: 3600000 description: "BigQuery Dataset Sample" friendlyName: bigquerydataset-sample location: USTerapkan yaml ke cluster Anda.
kubectl apply --namespace CC_NAMESPACE -f bq-sample.yaml
Ganti
CC_NAMESPACEdengan namespace tempat Config Connector mengelola resource.Gunakan
kubectl describeuntuk melihat detail set data.kubectl describe --namespace CC_NAMESPACE bigquerydataset bigquerydatasetsample
Ganti
CC_NAMESPACEdengan namespace tempat Config Connector mengelola resource.Output dari
kubectl describemencakup metadata tentang status dan kepemilikan resource.
Menghapus set data
Secara default, setelah Config Connector mendapatkan dan mengelola resource, menghapus objek dari cluster akan menghapus resource. Jika Anda lebih suka menyimpan
set data, tetapkan
resource'sdeletion-policy.
Misalnya, menghapus manifes yang mendapatkan bigquerydataset-sample akan menghapus set data dari BigQuery.
Anda dapat menghapus set data
bigquerydataset-sampledengankubectl delete.kubectl delete --namespace CC_NAMESPACE -f bq-sample.yaml
Ganti
CC_NAMESPACEdengan namespace tempat Config Connector mengelola resource.Output
kubectlmengonfirmasi penghapusan:bigquerydataset.bigquery.cnrm.cloud.google.com "bigquerydatasetsample" deletedGunakan
bquntuk mengonfirmasi bahwa set data tidak lagi ada.bq show PROJECT_ID:bigquerydatasetsample
Output perintah mencakup
Not Found.
Mempertahankan resource setelah penghapusan
...
metadata:
annotations:
cnrm.cloud.google.com/deletion-policy: abandon
...
Misalnya, YAML untuk set data BigQuery yang dijelaskan sebelumnya, termasuk kebijakan penghapusan abandon, ada di bawah ini:
apiVersion: bigquery.cnrm.cloud.google.com/v1beta1
kind: BigQueryDataset
metadata:
name: bigquerydatasetsample
annotations:
cnrm.cloud.google.com/deletion-policy: abandon
spec:
defaultTableExpirationMs: 3600000
description: "BigQuery Dataset Sample"
friendlyName: bigquerydataset-sample
location: US
Resource dengan batasan terkait perolehan
Beberapa resource tidak dapat diperoleh dengan mengikuti petunjuk di bagian sebelumnya. Bagian ini menjelaskan batasan terkait perolehan untuk beberapa resource.
Resource dengan ID resource yang dibuat oleh layanan
Anda hanya dapat memperoleh Google Cloud resource yang memiliki
ID resource yang dibuat oleh layanan
menggunakan kolom resourceID.
Resource Config Connector berikut sesuai dengan Google Cloud resource yang memiliki ID resource yang dibuat oleh layanan:
AccessContextManagerAccessPolicyApigeeOrganizationBigQueryDataTransferConfigBillingBudgetsBudgetCloudIdentityGroupCloudIdentityMembershipComputeFirewallPolicyDLPDeidentifyTemplateDLPInspectTemplateDLPJobTriggerDLPStoredInfoTypeDataCatalogPolicyTagDataCatalogTaxonomyEssentialContactsContactFolderIAPBrandIAPIdentityAwareProxyClientIdentityPlatformTenantMonitoringAlertPolicyMonitoringGroupMonitoringNotificationChannelMonitoringUptimeCheckConfigRecaptchaEnterpriseKeyResourceManagerLienSQLSSLCertSecretManagerSecretVersionStorageNotificationStorageTransferJobTagsTagBindingTagsTagKeyTagsTagValueVertexAIDatasetVertexAIIndex
Untuk mempelajari cara menggunakan kolom resourceID, lihat Mengelola resource dengan
kolom resourceID.
Resource yang tidak dapat diperoleh
Resource Config Connector berikut tidak memiliki dukungan untuk mendapatkan resource yang ada Google Cloud :
DataflowFlexTemplateJobFirestoreIndexIAMServiceAccountKey
Langkah berikutnya
- Pelajari cara Config Connector memodelkan Google Cloud resource dengan konstruksi Kubernetes.
- Lihat Google Cloud resource yang dapat dikelola Config Connector.
- Lihat contoh tambahan cara menggunakan Config Connector di repositori GitHub.
- Pelajari cara Kubernetes menangani konfigurasi deklaratif objek.