Démarrage rapide : Procéder au déploiement sur Cloud Run pour Anthos sur Google Cloud

Cette page explique comment créer un cluster activé pour Cloud Run pour Anthos sur Google Cloud, 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 Qwiklabs.

Avant de commencer

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder à la page de sélection du projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Pour vous assurer que vous disposez de la dernière version du SDK Cloud, installez-le ou mettez-le à jour :
    • Installez et initialisez le SDK Cloud.
    • Si vous avez déjà installé le SDK Cloud, mettez à jour les composants installés :
      gcloud components update
    • Installez le composant beta :
      gcloud components install beta

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 pour Anthos et activer les API requises :

  1. Configurez l'outil de ligne de commande gcloud afin d'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 pour Anthos activé

Pour créer un cluster et l'activer pour Cloud Run pour 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=n1-standard-2 \
  --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].

    où 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 pour 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 l'outil de ligne de commande gcloud.

    gcloud config set kuberun/cluster CLUSTER_NAME
gcloud config set kuberun/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 Google Cloud Console pour déployer un exemple de conteneur et créer un service dans votre cluster :

  1. Dans Cloud Console, accédez à la page Cloud Run pour Anthos.

    Accéder à Cloud Run pour Anthos

  2. Ouvrez le formulaire Create service (Créer un service) en cliquant sur Create service :

    1. Sélectionnez Cloud Run pour Anthos comme plate-forme de développement.

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

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

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

    5. Cliquez sur Next (Suivant).

    6. Sélectionnez Deploy one revision from an existing container image (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.

    7. Cliquez sur Next (Suivant).

    8. Sélectionnez External (Externe) sous Connectivity (Connectivité) pour pouvoir appeler le service.

    9. Cliquez sur Create (Créer) pour déployer l'image sur Cloud Run pour Anthos et attendez la fin du déploiement.

Félicitations ! Vous venez de déployer un service sur un cluster dans lequel Cloud Run pour 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 Cloud Console, accédez à la page Cloud Run pour Anthos.

    Accéder à Cloud Run pour Anthos

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

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

  4. Cliquez sur Invoke in Cloud Shell (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 vérifié que votre service traite des requêtes !

Effectuer un nettoyage

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

Désactiver Cloud Run pour Anthos

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

  1. Dans Cloud Console, 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 pour 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 pour Anthos, sélectionnez Désactiver.

  5. Cliquez sur Enregistrer.

Supprimer Cloud Run pour 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 Cloud Console, 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 pour Anthos, qui présente les différences avec l'installation de Cloud Run pour Anthos en tant que module complémentaire pour votre cluster Google Kubernetes Engine, consultez la section suivante :