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 comment déployer un exemple de conteneur prédéfini sur le cluster.

Vous pouvez également suivre ce guide de démarrage rapide avec un compte de démonstration 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. Installez cURL si vous souhaitez envoyer une requête à l'exemple de service déployé.
  5. Configurez la ligne de commande gcloud, décrite ci-dessous.

Configurer la ligne de commande gcloud

Pour configurer la ligne de commande gcloud pour Cloud Run pour Anthos sur Google Cloud, procédez comme suit :

  1. Installez et initialisez le SDK Cloud.

  2. Définissez la plate-forme sur gke et définissez le paramètre de projet par défaut pour gcloud sur celui que vous venez de créer :

    gcloud config set run/platform gke
    gcloud config set project PROJECT-ID

    Remplacez PROJECT-ID par l'ID du projet que vous avez créé.

  3. Définissez la zone souhaitée pour le nouveau cluster. Vous pouvez utiliser n'importe quelle zone dans laquelle GKE est disponible, par exemple :

    gcloud config set compute/zone ZONE

    Remplacez ZONE par votre zone.

  4. Activez les API suivantes pour le projet, lesquelles sont nécessaires pour créer un cluster, ainsi que pour créer et publier un conteneur dans le dépôt Google Container Registry :

    gcloud services enable container.googleapis.com containerregistry.googleapis.com cloudbuild.googleapis.com
  5. Mettez à jour les composants gcloud installés :

    gcloud components update

Créer un cluster GKE avec Cloud Run activé

Pour créer un cluster et l'activer pour Cloud Run pour Anthos sur Google Cloud, 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 \
      --zone=ZONE

    Remplacer

    • CLUSTER_NAME par le nom souhaité pour votre cluster.
    • ZONE par la zone que vous utilisez pour votre cluster, par exemple us-central1-a. Vous pouvez utiliser n'importe quelle zone compatible avec GKE.

    Notez que bien que ces instructions ne permettent pas à l'autoscaler de cluster de redimensionner les clusters à la demande, Cloud Run pour Anthos sur Google Cloud procède automatiquement au scaling des instances du 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. Vous venez de créer un cluster Google Kubernetes Engine nommé my-cluster dans le projet my-project.

  3. Définissez les valeurs par défaut de gcloud de sorte à utiliser votre nouveau cluster et son emplacement, afin d'éviter d'avoir à les spécifier lorsque vous utilisez la ligne de commande gcloud :

    gcloud config set run/cluster CLUSTER_NAME
    gcloud config set run/cluster_location us-central1-a

    Remplacez CLUSTER_NAME par le nom que vous avez utilisé pour votre cluster et, si nécessaire, remplacez us-central1-a par l'emplacement de cluster compatible de votre choix.

Déployer un exemple de conteneur

Pour déployer un conteneur sur le cluster que vous venez de créer, procédez comme suit :

  1. Accédez à Cloud Run

  2. Cliquez sur Create service (Créer un service) pour afficher le formulaire correspondant.

    image

    Dans le formulaire,

    1. Sélectionnez Cloud Run pour Anthos sur Google Cloud 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 au cours des étapes précédentes.

    3. Indiquez hello comme nom du service. Vous pouvez utiliser un autre nom mais, dans ce cas, veillez à renseigner cette valeur un peu plus loin lorsque vous utiliserez la commande cURL pour accéder au service. Dans ces instructions, nous partons du principe que votre service se nomme hello.

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

    5. Cliquez sur Next (Suivant) pour passer à la deuxième page du formulaire de création de service :

      image

      Dans le formulaire,

      1. Utilisez gcr.io/cloudrun/hello comme image de conteneur.

      2. Cliquez sur Create (Créer) pour déployer l'image sur Cloud Run, puis patientez jusqu'à la fin du déploiement.

Félicitations ! Vous venez de déployer un service sur un cluster activé pour Cloud Run pour Anthos sur Google Cloud.

Accéder à votre service déployé

Après avoir déployé votre service, vous pouvez utiliser cURL pour envoyer une requête et vérifier que le service fonctionne, en utilisant l'adresse IP externe du service d'équilibrage de charge créé pour le contrôleur d'entrée Istio :

  1. Accédez à la page Google Kubernetes Engine dans Cloud Console :

    Accéder à Google Kubernetes Engine

  2. Cliquez sur Services et entrées dans le panneau de navigation de gauche pour afficher la liste des services.

  3. Si la version de votre cluster est 1.15.3-gke.19 ou supérieure, 1.14.3-gke.12 ou supérieure, ou 1.13.10-gke.8 ou supérieure, faites défiler la page jusqu'au service istio-ingress. Pour toutes les autres versions de cluster, faites défiler la page jusqu'au service istio-ingressgateway.

  4. Copiez l'adresse IP externe affichée à côté de l'équilibreur de charge, SANS LE PARAMÈTRE "PORT", le cas échéant. Par exemple, si l'adresse IP est XX.XXX.XX.XXX:15020, omettez :15020. Ignorez les autres adresses IP répertoriées.

  5. Appelez cURL en veillant à remplacer hello dans la chaîne Host par le nom de votre service, si vous avez choisi un autre nom que hello :

    curl -v -H "Host: hello.default.example.com" YOUR-IP

    Remplacez YOUR-IP par l'adresse IP obtenue à l'étape précédente.

Nettoyer

Désactiver Cloud Run pour Anthos sur Google Cloud

Pour désactiver Cloud Run pour Anthos sur Google Cloud dans votre cluster, procédez comme suit :

  1. Accédez à la page Google Kubernetes Engine dans Cloud Console :

    Accéder à Google Kubernetes Engine

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

  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 Save.

É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 à la page :

Pour obtenir une présentation de l'architecture de Cloud Run pour Anthos sur Google Cloud qui aborde les modifications se produisant en cas d'installation de Cloud Run pour Anthos en tant que module complémentaire de votre cluster Google Kubernetes Engine, consultez les pages suivantes :