Guide de démarrage rapide : Déployer dans Cloud Run for Anthos

Découvrez comment créer un cluster activé pour Cloud Run for Anthos, puis déployer un exemple de conteneur prédéfini sur ce cluster.

Si vous possédez un compte de démonstration, vous pouvez suivre ce guide de démarrage rapide sur Google Cloud Skills Boost.

Avant de commencer

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  2. Make sure that billing is enabled for your Google Cloud project.

  3. Pour vous assurer que vous disposez de la dernière version de la Google Cloud CLI, installez ou mettez à jour la Google Cloud CLI :

Configurer l'environnement de ligne de commande et activer les API requises

Suivez les étapes ci-dessous pour configurer votre environnement de ligne de commande pour Cloud Run for Anthos et activer les API requises :

  1. Configurez la Google Cloud CLI pour utiliser l'ID de votre projet Cloud par défaut :

    gcloud config set project PROJECT-ID

    Remplacez PROJECT-ID par l'ID de votre projet.

  2. Définissez la zone dans laquelle vous souhaitez déployer le nouveau cluster. Vous pouvez utiliser n'importe quelle zone dans laquelle GKE est disponible. Exemple :

    gcloud config set compute/zone ZONE

    Remplacez ZONE par la zone souhaitée.

  3. Exécutez la commande gcloud services pour activer les API suivantes dans votre projet Cloud :

    • API Google Kubernetes Engine : créer des clusters GKE.
    • API Cloud Build : créer des conteneurs.
    • API Container Registry : publier des conteneurs dans Container Registry.
    gcloud services enable container.googleapis.com containerregistry.googleapis.com cloudbuild.googleapis.com

    Cette opération peut prendre plusieurs secondes. Une fois les API activées, la ligne de commande affiche un message semblable à celui-ci :

    Operation "operations/..." finished successfully.

Créer un cluster GKE avec Cloud Run for Anthos activé

Pour créer un cluster et l'activer pour Cloud Run for Anthos, procédez comme suit :

  1. Créez un cluster à l'aide de la commande suivante :

    gcloud container clusters create CLUSTER_NAME \
      --addons=HttpLoadBalancing,CloudRun \
      --machine-type=e2-standard-4 \
      --num-nodes=4 \
      --enable-stackdriver-kubernetes

    Remplacez CLUSTER_NAME par le nom souhaité pour votre cluster.

  2. Patientez pendant la création du cluster. Un résultat semblable aux lignes suivantes doit s'afficher au cours du processus :

    Creating cluster my-cluster...done.
    Created [https://container.googleapis.com/v1beta1/ \
    projects/my-project/zones/us-central1-b/clusters/my-cluster].
    

    my-project est l'ID de votre projet Cloud et my-cluster est le cluster que vous venez de créer.

  3. Définissez les valeurs par défaut gcloud pour vos ressources Cloud Run for Anthos sur le nom de votre nouveau cluster et son emplacement. Vous définissez ces valeurs par défaut afin d'éviter d'avoir à les spécifier chaque fois que vous utilisez la Google Cloud CLI.

    gcloud config set run/platform gke
    gcloud config set run/cluster CLUSTER_NAME
    gcloud config set run/cluster_location ZONE

    Remplacez CLUSTER_NAME et ZONE par les mêmes valeurs que celles utilisées pour créer votre cluster.

Déployer un exemple de conteneur

Utilisez la console Google Cloud pour déployer un exemple de conteneur et créer un service dans votre cluster :

  1. Dans la console Google Cloud, accédez à la page Cloud Run for Anthos.

    Accéder à Cloud Run pour Anthos

  2. Ouvrez le formulaire Créer un service en cliquant sur Créer un service.

  3. Dans le menu déroulant des clusters disponibles, sélectionnez le cluster que vous venez de créer.

  4. Laissez default comme nom de l'espace de noms.

  5. Saisissez un nom de compte de service, tel que hello.

  6. Cliquez sur Suivant.

  7. Sélectionnez Déployer une révision à partir d'une image de conteneur existante, puis sélectionnez hello dans la liste déroulante des conteneurs de démonstration.

  8. Cliquez sur Suivant.

  9. Sélectionnez Externe sous Connectivité pour pouvoir appeler le service.

  10. Cliquez sur Créer pour déployer l'image sur Cloud Run for Anthos et attendez la fin du déploiement.

Félicitations ! Vous venez de déployer un service sur un cluster dans lequel Cloud Run for Anthos est activé.

Accéder à votre service déployé

Maintenant que votre service est en cours d'exécution, vous pouvez lui envoyer des requêtes. Dans cette section, cURL est utilisé pour montrer comment accéder à votre service et vérifier qu'il fonctionne :

  1. Dans la console Google Cloud, accédez à la page Cloud Run for Anthos.

    Accéder à Cloud Run pour Anthos

  2. Cliquez sur le nom de votre nouveau service Cloud Run for Anthos pour accéder à la page Détails du service.

  3. Cliquez sur info , à droite de l'URL du service.

  4. Cliquez sur Appeler dans Cloud Shell pour exécuter la commande cURL générée pour votre service dans Cloud Shell.

La requête cURL renvoie le code source de l'exemple de conteneur exécuté par votre service. Vous avez validé le fait que votre service traite des requêtes !

Effectuer un nettoyage

Vous pouvez soit désactiver Cloud Run for Anthos, soit supprimer le cluster et le service Cloud Run for Anthos afin d'éviter d'avoir à payer les coûts d'exécution de ces ressources.

Désactiver Cloud Run for Anthos

Pour désactiver Cloud Run pour Anthos et conserver votre cluster, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Google Kubernetes Engine.

    Accéder à Google Kubernetes Engine

  2. Cliquez sur le cluster dans lequel vous souhaitez désactiver Cloud Run for Anthos.

  3. Cliquez sur Modifier.

  4. Faites défiler la page vers le bas jusqu'à Fonctionnalités Anthos et, dans le menu déroulant Cloud Run for Anthos, sélectionnez Désactiver.

  5. Cliquez sur Enregistrer.

Supprimer Cloud Run for Anthos

Pour supprimer définitivement votre cluster GKE, y compris le service Cloud Run pour Anthos et toutes les ressources associées, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Google Kubernetes Engine.

    Accéder à Google Kubernetes Engine

  2. Sélectionnez le cluster que vous souhaitez supprimer.

  3. Cliquez sur Supprimer, puis à nouveau sur Supprimer pour confirmer votre choix.

Étapes suivantes

Pour savoir comment créer un conteneur à partir d'un code source, le transférer dans Container Registry, puis le déployer, reportez-vous à cette page :

Pour obtenir une vue d'ensemble de l'architecture de Cloud Run for Anthos, qui présente les différences avec l'installation de Cloud Run for Anthos en tant que module complémentaire pour votre cluster Google Kubernetes Engine, consultez la section suivante :