Informazioni sulle CRD di Config Connector

Config Connector include una raccolta di definizioni di risorse personalizzate (CRD). Ogni CRD consente di configurare una risorsa da Kubernetes. Google CloudConfig Connector ti consente anche di utilizzare una serie di funzionalità di Kubernetes per gestire le risorse Google Cloud .

Questa pagina introduce l'utilizzo degli oggetti Kubernetes e dei relativi metadati da parte di Config Connector.

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 come Config Connector estende i tipi di oggetti.

Specifica 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 campi secondari di un spec fanno riferimento alla risorsa Google Cloud associata. Quando modifichi un sottocampo, il valore della risorsa Google Cloud è alla fine coerente con il valore che intendi impostare.
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 risorsa Google Cloude aggiorna status. Puoi controllare i messaggi di errore o la preparazione di una risorsa esaminando Status.Condition.
Un esempio di campo di sola lettura status è connectionName di una risorsa SQLInstance.

Metadati degli oggetti

Ogni risorsa Config Connector include un campo metadata. Questa sezione descrive come Config Connector utilizza i sottocampi all'interno dei 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 risorsa Google Cloud corrispondente. Se il campo resourceID è supportato nella risorsa Config Connector, puoi specificare un nome diverso, che segue la convenzione di denominazione della risorsa Google Cloud, per la risorsa Google Cloud corrispondente nel campospec.resourceID. Per saperne di più, 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 Spazi dei nomi Kubernetes e 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 di true alle tue risorse 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 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 Google Cloud cartelle e organizzazioni. Per saperne di più, consulta Spazi dei nomi e progetti.

Utilizzo di RBAC per il controllo dell'accesso

Il controllo dell'accesso basato sui ruoli (RBAC) di Kubernetes protegge le tue risorse. Puoi controllare la creazione di risorse Google Cloudassegnando autorizzazioni RBAC. Per ulteriori informazioni, vedi Proteggere l'accesso alle risorse.

Status Condition

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

  • indicando quando una risorsa è pronta. Quando una risorsa viene riconciliata e pronta, il relativo status.condition.status viene impostato su True. Per verificare quando una risorsa è pronta, consulta In attesa che le risorse siano pronte
  • visualizzando ulteriori errori o informazioni. La condizione pronta ha i campi Message e Reason che forniscono ulteriori informazioni sullo stato della risorsa.

Eventi

Le modifiche importanti dello stato delle risorse Config Connector sono visibili come eventi Kubernetes. Per saperne di più, vedi Visualizzazione degli eventi.

Configurazione dichiarativa e coerenza finale

Consulta la sezione Riconciliazione.

Passaggi successivi