Ressources

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Config Connector comprend un ensemble de définitions de ressources personnalisées (CRD). Chaque CRD vous permet de configurer une ressource Google Cloud à partir de Kubernetes. Config Connector vous permet également de exploiter un certain nombre de fonctionnalités Kubernetes pour la gestion des ressources Google Cloud.

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

Objets Kubernetes et ressources Config Connector

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

Spécifications et état

Chaque ressource Config Connector est un objet Kubernetes doté d'un élément Spec et d'un élément Status.

Spécification
Le champ spec contient tous les champs qui définissent l'état souhaité d'un objet, à l'exception de Labels. Les sous-champs d'une ressource 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.
Voici un exemple de champ accessible en écriture : databaseVersion dans une ressource SQLInstance.
État
Le champ status est en lecture seule et contient l'état actuel de votre objet. Config Connector lit régulièrement les informations de votre ressource Google Cloud et met à jour le status. Vous pouvez vérifier les messages d'erreur d'une ressource ou la disponibilité en consultant Status.Condition.
Un exemple de champ status en lecture seule est le connectionName d'une ressource SQLInstance.

Métadonnées de l'objet

Chaque ressource Config Connector inclut un champ de métadonnées. 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 suivre 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, en respectant 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 la page 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 la page Espaces de noms Kubernetes et projets Google Cloud.
Étiquettes
Les libellés du champ de métadonnées d'une ressource Config Connector sont également ajoutés à la ressource Google Cloud associée.
De plus, Config Connector ajoute un libellé système nommé managed-by-cnrm avec la valeur true à vos ressources Google Cloud.
Annotations :
Config Connector peut effectuer des actions supplémentaires sur les ressources qui ne sont pas définies dans spec. Ces actions sont définies dans les sous-champs de metadata.annotations. Les valeurs d'annotations doivent être des chaînes. Les types d'annotations compatibles avec Config Connector sont décrits dans la section Annotations.

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 les dossiers et organisations Google Cloud. Pour en savoir plus, consultez la section 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 Kubernetes (RBAC) vous permet de sécuriser vos ressources. Vous pouvez contrôler la création de ressources Google Cloud en attribuant des autorisations RBAC. Pour en savoir plus, consultez la page Sécuriser l'accès aux ressources.

Condition d'état

Config Connector utilise une condition prête à l'emploi dans status.condition à deux fins:

  • indique qu'une ressource est prête. Lorsqu'une ressource est rapprochée et prête, son champ status.condition.status est défini sur True. Pour vérifier la disponibilité d'une ressource, consultez la section En attente de la préparation des ressources.
  • en affichant une erreur ou des informations supplémentaires. La condition prête comporte des champs Message et Reason qui fournissent des informations supplémentaires sur l'état de la ressource.

Événement

Les changements d'état importants pour les 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