Cette page a été traduite par l'API Cloud Translation.
Switch to English

Premiers pas avec Config Connector


Ce guide présente les base de la gestion des ressources à l'aide de Config Connector en vous montrant comment :

  • activer une API Google Cloud ;
  • Créez et gérez un sujet Pub/Sub.

Avant de commencer

Pour terminer les exercices de cette page, procédez comme suit:

  • Installez Config Connector en suivant toutes les étapes de la section Installer avec le module complémentaire GKE.

  • Configurez Config Connector pour utiliser un espace de noms par défaut.

  • Config Connector utilise l'API Resource Manager pour activer les API de service. Pour effectuer ces opérations, vous devez activer l'API Resource Manager. Vous pouvez activer cette API à l'aide de l'outil de ligne de commande gcloud:
    gcloud services enable cloudresourcemanager.googleapis.com

Découvrir les ressources Google Cloud disponibles

Pour connaître les types de ressources Google Cloud que vous pouvez créer avec Config Connector, exécutez la commande suivante :

kubectl get crds --selector cnrm.cloud.google.com/managed-by-kcc=true

Le résultat est une liste de toutes les ressources que votre version de Config Connector peut créer et gérer.

Par exemple, vous pouvez afficher la description de l'API pour la ressource PubSubTopic avec kubectl describe :

kubectl describe crd pubsubtopics.pubsub.cnrm.cloud.google.com

Vous pouvez également consulter des informations sur les ressources disponibles sur la page Ressources de Config Connector.

Activer le service Pub/Sub

Utilisez Config Connector pour activer l'API Pub/Sub en appliquant une configuration YAML à votre cluster:

  1. Copiez le fichier YAML suivant dans un fichier nommé enable-pubsub.yaml.

    apiVersion: serviceusage.cnrm.cloud.google.com/v1beta1
    kind: Service
    metadata:
      name: pubsub.googleapis.com
    
  2. Utilisez kubectl apply pour appliquer la configuration à votre cluster. Pour activer l'API Pub/Sub, exécutez la commande suivante:

    kubectl apply -f enable-pubsub.yaml

Créer une instance Pub/Sub

Créez un fichier nommé pubsub-topic.yaml avec le contenu suivant :

  apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
  kind: PubSubTopic
  metadata:
    labels:
      LABEL_VALUE
    name: TOPIC_NAME

Remplacez l'élément suivant :

  • LABEL_VALUE: une paire clé/valeur d'étiquettes Par exemple, environment: production.
  • TOPIC_NAME : nom du sujet Pub/Sub

Lorsque vous créez une ressource, Config Connector crée la ressource si elle n'existe pas. Si une ressource Google Cloud existe déjà avec le même nom, Config Connector acquiert la ressource et la gère. Pour en savoir plus sur l'acquisition d'une ressource existante, consultez la page Gérer et supprimer des ressources.

Utilisez la commande kubectl apply pour créer des ressources. Pour créer le sujet Pub/Sub, exécutez la commande suivante:

kubectl apply -f pubsub-topic.yaml 

Décrire une ressource

Utilisez kubectl describe pour obtenir des détails sur une ressource.

Par exemple, pour afficher votre sujet Pub/Sub, exécutez la commande suivante:

kubectl describe pubsubtopics

Dans cette liste, vous devriez voir le sujet Pub/Sub que vous avez créé dans la section précédente.

Vérifier qu'une ressource est prête

Après avoir créé un sujet Pub/Sub, vous pouvez vérifier son status.condition. Par exemple, pour vérifier que votre ressource de sujet Pub/Sub est prête, exécutez la commande suivante:

kubectl wait --for=condition=READY pubsubtopics TOPIC_NAME

Remplacez TOPIC_NAME par le nom de votre sujet Pub/Sub.

Un résultat semblable aux lignes suivantes doit s'afficher :

pubsubtopic.pubsub.cnrm.cloud.google.com/TOPIC_NAME condition met

Mettre à jour une ressource

Vous pouvez mettre à jour les métadonnées pour vos ressources en mettant à jour votre fichier YAML et en le réappliquant avec kubectl.

Pour modifier le libellé du sujet Pub/Sub que vous avez créé dans la section précédente, procédez comme suit:

  1. Modifiez la section metadata de votre fichier pubsub-topic.yaml pour modifier le libellé:

      apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
      kind: PubSubTopic
      metadata:
        labels:
          NEW_LABEL_VALUE
        name: TOPIC_NAME
    

    Remplacez l'élément suivant :

    • NEW_LABEL_VALUE: mise à jour de la valeur du libellé que vous avez ajouté précédemment. Exemple :environment: staging
    • TOPIC_NAME : nom du sujet Pub/Sub
  2. Utilisez kubectl apply pour mettre à jour la ressource. Exécutez la commande suivante :

    kubectl apply -f pubsub-topic.yaml
  3. Vérifiez le changement de nom dans l'instance Pub/Sub:

    kubectl describe pubsubtopics

    Le thème doit maintenant être associé à la nouvelle étiquette.

Supprimer une ressource

Utilisez kubectl delete pour supprimer des ressources. Par exemple, pour supprimer le fichier PubSubTopic que vous avez créé précédemment, exécutez kubectl delete avec votre fichier pubsub-topic.yaml :

kubectl delete -f pubsub-topic.yaml

Vous recevez la confirmation de suppression de la ressource:

pubsubtopic.pubsub.cnrm.cloud.google.com "TOPIC_NAME" deleted

Par défaut, Config Connector supprime la ressource PubSubTopic. Si vous préférez conserver cette ressource, reportez-vous aux instructions de la page Gérer et supprimer des ressources.

Étape suivante