Risorse

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

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

Risorse di Config Connector e oggetti Kubernetes

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 preferito di un oggetto, ad eccezione di Labels. I campi secondari di un spec si riferiscono alla risorsa Google Cloud associata. Quando modifichi un Google Cloud campo secondario, il valore della risorsa è eventualmente coerente con il valore previsto.
Un esempio di campo modificabile è databaseVersion in una risorsa SQLInstance.
Stato
Il campo status è di sola lettura e contiene lo stato corrente dell'oggetto. Config Connector legge periodicamente le informazioni sulla tua Google Cloud risorsa e aggiorna il status. Puoi controllare i messaggi di errore o l'idoneità di una risorsa consultando Status.Condition.
Un esempio di campo status di sola lettura è connectionName di una risorsa SQLInstance.

Metadati degli oggetti

Ogni risorsa Config Connector include un campo metadata. Questa sezione descrive come Config Connector utilizza i campi secondari all'interno degli elementi metadati.

Nome
Il nome di una risorsa Config Connector. Deve rispettare la convenzione di denominazione di un nome di oggetto Kubernetes. Viene utilizzato per impostazione predefinita come nome della Google Cloud risorsa corrispondente. Se il campo resourceID è supportato nella risorsa Config Connector, puoi specificare un nome diverso, che segua la convenzione di denominazione della risorsa Google Cloud, per la risorsa Google Cloud corrispondente nel campo spec.resourceID. Per ulteriori informazioni, consulta Gestire le 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 Spazi dei nomi e progetti Google Cloud Kubernetes.
Etichette
Le etichette nel campo dei metadati di una risorsa Config Connector vengono aggiunte anche alla risorsa Google Cloud associata.
Inoltre, Config Connector aggiunge alle risorse un'etichetta di sistema denominata managed-by-cnrm con un valore true.
Google Cloud
Annotazioni
Config Connector può eseguire azioni aggiuntive sulle risorse che non sono definite in spec. Queste azioni sono definite nei campi secondari di metadata.annotations. I valori delle annotazioni devono essere una stringa. I tipi di annotazioni supportati da Config Connector sono descritti in annotations.

Cartelle e risorse gerarchiche

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

Utilizzo del RBAC per il controllo dell'accesso

Il controllo degli accessi basato sui ruoli (RBAC) di Kubernetes protegge le risorse. Puoi controllare la creazione delle Google Cloud risorse assegnando autorizzazioni RBAC. Per ulteriori informazioni, consulta Proteggere l'accesso alle risorse.

Condizione dello stato

Config Connector utilizza una condizione di disponibilità in status.condition per due scopi:

  • che indica quando una risorsa è pronta. Quando una risorsa è riconciliata e pronta, il relativo status.condition.status viene impostato su True. Per controllare quando una risorsa è pronta, consulta In attesa del completamento delle risorse
  • visualizzando un errore o informazioni aggiuntive. La condizione di stato attivo ha i campi Message e Reason che forniscono informazioni aggiuntive sullo stato della risorsa.

Eventi

Le modifiche importanti dello stato delle risorse di Config Connector sono visibili come eventi Kubernetes. Per ulteriori informazioni, consulta Visualizzare gli eventi.

Configurazione dichiarativa e coerenza finale

Consulta Riconciliazione.

Passaggi successivi