Risorse

Config Connector include una raccolta di definizioni delle risorse personalizzate (CRD). Ogni CRD ti consente di configurare una risorsa Google Cloud da Kubernetes. Config Connector consente inoltre di utilizzare una serie di funzionalità Kubernetes per la gestione delle risorse Google Cloud.

Questa pagina illustra come l'oggetto Config Connector utilizza gli oggetti Kubernetes e i relativi metadati.

Oggetti Kubernetes e risorse Config Connector

Ad esempio, quando crei un oggetto Kubernetes di kind: SQLInstance, Config Connector crea un'istanza Cloud SQL. Questa sezione descrive in che modo Config Connector estende i tipi di oggetti.

Specifiche e stato

Ogni risorsa Config Connector è un oggetto Kubernetes con un Spec e un Status.

Spec
Il campo spec contiene tutti i campi che definiscono lo stato desiderato di un oggetto, ad eccezione di Labels. I sottocampi di un spec si riferiscono alla risorsa Google Cloud associata. Quando modifichi un sottocampo, il valore della risorsa Google Cloud è finalmente coerente con il valore previsto.
Un esempio di campo scrivibile è databaseVersion in una risorsa SQLInstance.
Stato
Il campo status è di sola lettura e contiene lo stato attuale dell'oggetto. Config Connector legge periodicamente le informazioni sulla tua risorsa Google Cloud e aggiorna il status. Puoi controllare i messaggi di errore o l'idoneità di una risorsa esaminando il Status.Condition.
Un campo status di esempio in sola lettura è connectionName di una risorsa SQLInstance.

Metadati degli oggetti

Ogni risorsa di Config Connector include un campo metadata. Questa sezione descrive come Config Connector utilizza sottocampi all'interno dei metadati.

Nome
Il nome di una risorsa Config Connector. Deve seguire la convenzione di denominazione di un nome oggetto Kubernetes. Viene utilizzato per impostazione predefinita come nome della risorsa Google Cloud corrispondente. Se il campo resourceID è supportato nella risorsa Config Connector, puoi specificare un nome altro, che segue la convenzione di denominazione della risorsa Google Cloud, per la risorsa Google Cloud corrispondente nel campo spec.resourceID. Per ulteriori informazioni, consulta Gestione delle risorse con il campo resourceID.
Spazio dei nomi
Lo spazio dei nomi in cui crei una risorsa Config Connector determina il progetto che contiene la risorsa Google Cloud. Per saperne di più sugli spazi dei nomi, consulta gli spazi dei nomi di Kubernetes e i progetti Google Cloud.
Etichette
Le etichette nel campo dei metadati di una risorsa Config Connector vengono aggiunte anche alla risorsa Google Cloud associata.
Inoltre, Config Connector aggiunge un'etichetta di sistema denominata managed-by-cnrm con un valore true alle tue risorse Google Cloud.
Annotazioni
Config Connector può eseguire altre azioni sulle tue risorse che non sono definite in spec. Queste azioni sono definite nei sottocampi di metadata.annotations. I valori delle annotazioni devono essere una stringa. I tipi di annotazioni supportati da Config Connector sono descritti nelle annotazioni.

Cartelle e risorse gerarchiche

Oltre a gestire le risorse nei prodotti Google Cloud, Config Connector supporta la creazione e la gestione delle risorse all'interno di cartelle e organizzazioni Google Cloud. Per ulteriori informazioni, vedi Spazi dei nomi e progetti.

Utilizzo di RBAC per il controllo degli accessi

Il controllo dell'accesso basato sui ruoli Kubernetes (RBAC) protegge le tue risorse. Puoi controllare la creazione delle risorse Google Cloud assegnando autorizzazioni RBAC. Per ulteriori informazioni, vedi Protezione dell'accesso alle risorse.

Condizione di stato

Config Connector utilizza una condizione pronta in status.condition per due scopi:

  • per indicare quando una risorsa è pronta. Quando una risorsa è riconciliata ed è pronta, status.condition.status viene impostata su True. Per verificare quando una risorsa è pronta, consulta In attesa che le risorse siano pronte
  • Mostrare ulteriori informazioni o errori. La condizione pronta ha campi Message e Reason che forniscono informazioni aggiuntive sullo stato della risorsa.

Eventi

Importanti modifiche di stato per le risorse di Config Connector sono visibili come eventi Kubernetes. Per ulteriori informazioni, consulta Visualizzazione degli eventi.

Configurazione dichiarativa e coerenza finale

Vedi Riconciliazione.

Passaggi successivi