À propos des CRD Config Connector

Config Connector inclut une collection de définitions de ressources personnalisées (CRD). Chaque CRD vous permet de configurer une ressource Google Cloudde Kubernetes. Config Connector vous permet également d'utiliser un certain nombre de fonctionnalités Kubernetes pour gérer les ressources Google Cloud .

Cette page explique comment Config Connector utilise les objets Kubernetes et leurs métadonnées.

Objets Kubernetes et ressources de Config Connector

Par exemple, lorsque vous créez un objet Kubernetes de kind: SQLInstance, Config Connector crée une instance Cloud SQL. Cette section décrit comment Config Connector étend les types d'objets.

Spécification et état

Chaque ressource Config Connector est un objet Kubernetes avec un Spec et un Status.

Spécification
Le champ spec contient tous les champs qui définissent l'état souhaité d'un objet. Les sous-champs d'un spec font référence à la ressource Google Cloud associée. Lorsque vous modifiez un sous-champ, la valeur de la ressource Google Cloud est cohérente à terme avec la valeur souhaitée.
 databaseVersion est un exemple de champ accessible en écriture dans une ressource SQLInstance.
Pour les ressources Config Connector avec spec.labels, les libellés configurés dans le champ spec.labels de la ressource Config Connector seront appliqués à la ressource Google Cloud associée. Pour en savoir plus, consultez Gérer les libellés.
État
Le champ status est en lecture seule et contient l'état actuel de votre objet. Config Connector lit régulièrement les informations sur votre ressource Google Cloudet met à jour status. Vous pouvez vérifier les messages d'erreur ou l'état d'une ressource en consultant Status.Condition.
 Le champ status en lecture seule connectionName est un exemple de champ en lecture seule pour une ressource SQLInstance.

Métadonnées des objets

Chaque ressource Config Connector inclut un champ metadata. Cette section décrit comment Config Connector utilise les sous-champs dans les métadonnées.

Nom
Nom d'une ressource Config Connector. Il doit respecter la convention d'attribution de noms d'un nom d'objet Kubernetes. Il est utilisé par défaut comme nom de la ressource Google Cloud correspondante. Si le champ resourceID est compatible avec la ressource Config Connector, vous pouvez spécifier un autre nom, qui suit la convention d'attribution de noms de la ressource Google Cloud, pour la ressource Google Cloud correspondante dans le champ spec.resourceID. Pour en savoir plus, consultez Gérer les ressources avec le champ resourceID.
Espace de noms
L'espace de noms dans lequel vous créez une ressource Config Connector détermine le projet contenant la ressource Google Cloud . Pour en savoir plus sur les espaces de noms, consultez Espaces de noms Kubernetes et projets Google Cloud .
Étiquettes
Selon la ressource, les libellés du champ metadata.labels d'une ressource Config Connector peuvent s'appliquer à la ressource Google Cloudassociée. Pour en savoir plus, consultez Gérer les libellés.
Config Connector ajoute un libellé système nommé managed-by-cnrm avec la valeur true aux ressources Google Cloud qui acceptent les libellés.
Annotations
Config Connector peut effectuer des actions supplémentaires sur vos ressources qui ne sont pas définies dans le spec. Ces actions sont définies dans les sous-champs de metadata.annotations. Les valeurs d'annotation doivent être une chaîne. Les types d'annotations compatibles avec Config Connector sont décrits dans Annotations.

Gérer les libellés

Pour les ressources Google Cloud qui acceptent les libellés, l'emplacement où vous définissez les libellés dépend de la présence ou non d'un champ spec.labels dans la ressource Config Connector :

  • Ressources avec un champ spec.labels : vous devez gérer les libellés dans spec.labels. Les libellés spécifiés par l'utilisateur dans ce champ sont appliqués à la ressourceGoogle Cloud .
  • Ressources sans champ spec.labels : tous les libellés de metadata.labels, y compris ceux spécifiés par l'utilisateur et les libellés système, sont appliqués à la ressource Google Cloud .

Dossiers et ressources hiérarchiques

En plus de gérer les ressources dans les produits Google Cloud , Config Connector permet de créer et de gérer des ressources dans lesGoogle Cloud dossiers et les organisations. Pour en savoir plus, consultez Espaces de noms et projets.

Utiliser RBAC pour le contrôle des accès

Le contrôle des accès basé sur les rôles (RBAC) de Kubernetes sécurise vos ressources. Vous pouvez contrôler la création de ressources Google Clouden attribuant des autorisations RBAC. Pour en savoir plus, consultez Sécuriser l'accès aux ressources.

Condition de l'état

L'aptitude que Config Connector met à disposition dans status.condition a un double objectif :

  • Indiquer quand une ressource est prête. Lorsqu'une ressource est réconciliée et prête, son status.condition.status est défini sur True. Pour vérifier si une ressource est prête, consultez la section Vérifier si une ressource est prête.
  • Afficher des informations ou des erreurs supplémentaires. L'aptitude comporte des champs Message et Reason qui fournissent des informations supplémentaires sur l'état de la ressource.

Événements

Les changements d'état importants des ressources Config Connector sont visibles en tant qu'événements Kubernetes. Pour en savoir plus, consultez la section Afficher des événements.

Configuration déclarative et cohérence à terme

Voir Rapprochement.

Étape suivante