Déployer des images de conteneurs dans Cloud Run

Console

Pour déployer une image de conteneur, procédez comme suit :

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

   Accédez à Cloud Run

2. Cliquez sur Déployer un conteneur et sélectionnez Service pour afficher le formulaire Créer un service.

   1. Dans le formulaire, sélectionnez l'option de déploiement :

      1. Si vous souhaitez déployer manuellement un conteneur, sélectionnez Déployer une révision à partir d'une image de conteneur existante, puis spécifiez l'image de conteneur.

      2. Pour une automatisation à des fins de déploiement continu, sélectionnez Déployer de nouvelles révisions en continu à partir d'un dépôt source et suivez les instructions pour les déploiements continus.

   2. Saisissez le nom du service requis. Les noms de service doivent comporter un maximum de 49 caractères et être uniques par région et par projet. Un nom de service ne peut pas être modifié ultérieurement et il est visible publiquement.

   3. Sélectionnez la région dans laquelle vous souhaitez créer votre service. Le sélecteur de région indique le niveau de tarification et la disponibilité des mappages de domaines, et met en évidence les régions avec l'impact carbone le plus faible.

   4. Définissez l'allocation et la tarification du processeur si nécessaire.

   5. Sous Autoscaling, spécifiez des instances minimum et maximum.

   6. Définissez les paramètres de l'objet Ingress dans le formulaire, le cas échéant.

   7. Sous Authentification, configurez les éléments suivants :

      • Si vous créez une API ou un site Web public, sélectionnez Allow unauthenticated invocations (Autoriser les appels non authentifiés). En sélectionnant cette option, le rôle Demandeur IAM est attribué à l'identifiant spécial allUser. Vous pouvez utiliser IAM pour modifier ce paramètre ultérieurement après avoir créé le service.
      • Si vous souhaitez qu'un service sécurisé soit protégé par authentification, sélectionnez Require authentication (Exiger l'authentification).

3. Cliquez sur Conteneur(s), volumes, mise en réseau et sécurité pour définir d'autres paramètres facultatifs dans les onglets appropriés :

   • Simultanéité
   • Configuration des conteneurs
   • Limites de processeur
   • Limites de mémoire
   • Délai avant expiration de la requête
   • Secrets
   • Variables d'environnement
   • Environnement d'exécution
   • HTTP/2
   • Comptes de service
   • Connexions Cloud SQL
   • Connexion VPC

4. Une fois la configuration du service terminée, cliquez sur Créer pour déployer l'image sur Cloud Run, puis patientez jusqu'à la fin du déploiement.

5. Cliquez sur le lien URL affiché pour ouvrir le point de terminaison unique et stable de votre service déployé.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Pour déployer une image de conteneur, procédez comme suit :

   1. Exécutez la commande suivante :

      gcloud run deploy SERVICE --image IMAGE_URL

      • Remplacez SERVICE par le nom du service sur lequel vous souhaitez déployer l'image. Les noms de service doivent comporter un maximum de 49 caractères et être uniques par région et par projet. Si le service n'existe pas encore, cette commande le crée lors du déploiement. Vous pouvez omettre ce paramètre, mais dans ce cas le nom du service vous sera demandé.
      • Remplacez IMAGE_URL par une référence à l'image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/hello:latest. Si vous utilisez Artifact Registry, le dépôt REPO_NAME doit déjà être créé. L'URL se présente sous la forme suivante : LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. Notez que si vous ne fournissez pas l'option --image, la commande de déploiement tente d'effectuer le déploiement à partir du code source.

      Si vous créez une API ou un site Web public, autorisez les appels non authentifiés de votre service à l'aide de l'option --allow-unauthenticated. Cela attribue le rôle IAM Demandeur Cloud Run à allUsers. Vous pouvez également spécifier --no-allow-unauthenticated pour interdire les appels non authentifiés. Si vous omettez l'une de ces options, vous êtes invité à confirmer l'exécution de la commande deploy.

   2. Patientez jusqu'à la fin du déploiement. Une fois l'opération achevée, un message de réussite indiquant l'URL du service déployé s'affiche.

   Notez que pour effectuer un déploiement dans un emplacement différent de celui que vous avez défini à l'aide des propriétés run/region et gcloud, vous devez exécuter les commandes suivantes :

   gcloud run deploy SERVICE --region REGION

YAML

Vous pouvez stocker votre spécification de service dans un fichier YAML, puis la déployer à l'aide de gcloud CLI.

1. Créez un fichier service.yaml avec le contenu suivant :

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - image: IMAGE

   Remplacer

   • SERVICE par le nom de votre service Cloud Run ; Les noms de service doivent comporter un maximum de 49 caractères et être uniques par région et par projet.
   • IMAGE par l'URL de votre image de conteneur

   Vous pouvez également spécifier d'autres éléments de configuration, tels que des variables d'environnement ou des limites de mémoire.

2. Déployez le nouveau service à l'aide de la commande suivante :

   gcloud run services replace service.yaml

3. Vous pouvez éventuellement rendre votre service public si vous souhaitez autoriser un accès non authentifié à celui-ci.

Cloud Code

Pour déployer avec Cloud Code, consultez les guides IntelliJ et Visual Studio Code.

Terraform

Si vous utilisez Terraform, définissez votre service dans une configuration Terraform à l'aide de la ressource google_cloud_run_v2_service du fournisseur Google Cloud Platform.

1. Créez un fichier main.tf avec le contenu suivant :

   provider "google" {
     project = "PROJECT-ID"
   }
   
   resource "google_cloud_run_v2_service" "default" {
     name     = "SERVICE"
     location = "REGION"
     client   = "terraform"
   
     template {
       containers {
         image = "IMAGE"
       }
     }
   }
   
   resource "google_cloud_run_v2_service_iam_member" "noauth" {
     location = google_cloud_run_v2_service.default.location
     name     = google_cloud_run_v2_service.default.name
     role     = "roles/run.invoker"
     member   = "allUsers"
   }
   

   Remplacer

   • PROJECT-ID par l'ID du projet Google Cloud
   • REGION par la région Google Cloud
   • SERVICE par le nom de votre service Cloud Run ; Les noms de service doivent comporter un maximum de 49 caractères et être uniques par région et par projet.
   • IMAGE_URL par une référence à l'image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/hello:latest. Si vous utilisez Artifact Registry, le dépôt REPO_NAME doit déjà être créé. L'URL se présente sous la forme suivante : LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG

   Cette configuration autorise l'accès public (l'équivalent de --allow-unauthenticated). Pour rendre le service privé, supprimez le stanza google_cloud_run_v2_service_iam_member.

2. Initialisez Terraform :

   terraform init

3. Appliquez la configuration Terraform :

   terraform apply

   Confirmez que vous souhaitez appliquer les actions décrites en saisissant yes.

Bibliothèques clientes

Pour déployer un service à partir du code, procédez comme suit :

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Pour déployer un service, envoyez une requête HTTP POST au point de terminaison service de l'API Cloud Run Admin.

Exemple, à l'aide de curl :

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services?serviceId=SERVICE

Remplacez :

• ACCESS_TOKEN par un jeton d'accès valide pour un compte disposant des autorisations IAM pour déployer les services. Par exemple, si vous êtes connecté à gcloud, vous pouvez récupérer un jeton d'accès à l'aide de gcloud auth print-access-token. À partir d'une instance de conteneur Cloud Run, vous pouvez récupérer un jeton d'accès via le serveur de métadonnées d'instance de conteneur.
• IMAGE_URL par une référence à l'image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/hello:latest. Si vous utilisez Artifact Registry, le dépôt REPO_NAME doit déjà être créé. L'URL se présente sous la forme suivante : LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
• SERVICE par le nom du service sur lequel vous souhaitez déployer l'image. Les noms de service doivent comporter un maximum de 49 caractères et être uniques par région et par projet.
• REGION par la région Google Cloud du service.
• PROJECT-ID par l'ID du projet Google Cloud.

Console

Pour déployer une nouvelle révision d'un service existant, procédez comme suit :

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

   Accédez à Cloud Run

2. Recherchez le service que vous souhaitez mettre à jour dans la liste des services, puis cliquez dessus pour en afficher les détails.

3. Cliquez sur Modifier et déployer la nouvelle révision pour afficher le formulaire de déploiement de version.

   1. Si nécessaire, fournissez l'URL de la nouvelle image de conteneur que vous souhaitez déployer.

   2. Configurez le conteneur si nécessaire.

   3. Définissez l'allocation et la tarification du processeur si nécessaire.

   4. Sous "Capacité", spécifiez les limites de mémoire et les limites de processeur.

   5. Spécifiez le délai d'expiration de requête et la simultanéité si nécessaire.

   6. Spécifiez l'environnement d'exécution si nécessaire.

   7. Sous Autoscaling, spécifiez des instances minimum et maximum.

   8. Utilisez les autres onglets si nécessaire pour configurer les éléments suivants si vous le souhaitez :

      • Secrets
      • Variables d'environnement
      • HTTP/2
      • Comptes de service
      • Connexions Cloud SQL
      • Connexion VPC

4. Pour envoyer l'ensemble du trafic vers la nouvelle révision, sélectionnez Diffuser immédiatement la révision. Pour déployer progressivement une nouvelle révision, décochez cette case. Cela se traduit par un déploiement dans lequel aucun trafic n'est envoyé à la nouvelle révision. Suivez les instructions de déploiement progressif après avoir effectué votre déploiement.

5. Cliquez sur Déployer et attendez la fin du déploiement.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Pour déployer une image de conteneur, procédez comme suit :

   1. Exécutez la commande suivante :

      gcloud run deploy SERVICE --image IMAGE_URL

      • Remplacez SERVICE par le nom du service sur lequel vous déployez l'image. Vous pouvez omettre ce paramètre, mais dans ce cas le nom du service vous sera demandé.
      • Remplacez IMAGE_URL par une référence à l'image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/hello:latest. Si vous utilisez Artifact Registry, le dépôt REPO_NAME doit déjà être créé. L'URL se présente sous la forme suivante : LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

      Le suffixe de révision est attribué automatiquement aux nouvelles révisions. Si vous souhaitez spécifier votre propre suffixe de révision, utilisez le paramètre --revision-suffix de gcloud CLI.

   2. Patientez jusqu'à la fin du déploiement. Une fois l'opération achevée, un message de réussite indiquant l'URL du service déployé s'affiche.

YAML

Si vous devez télécharger ou consulter la configuration d'un service existant, exécutez la commande suivante pour enregistrer les résultats dans un fichier YAML :

gcloud run services describe SERVICE --format export > service.yaml

Dans un fichier YAML de configuration de service, modifiez les attributs enfants spec.template en fonction de vos besoins pour mettre à jour les paramètres de révision, puis déployez la nouvelle révision :

gcloud run services replace service.yaml

Cloud Code

Pour déployer une nouvelle révision d'un service existant avec Cloud Code, consultez les guides IntelliJ et Visual Studio Code.

Terraform

Assurez-vous d'avoir configuré Terraform comme décrit dans l'exemple Déployer un nouveau service.

1. Apportez une modification au fichier de configuration.

2. Appliquez la configuration Terraform :

   terraform apply

   Confirmez que vous souhaitez appliquer les actions décrites en saisissant yes.

Bibliothèques clientes

Pour déployer une nouvelle révision à partir du code, procédez comme suit :

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Pour déployer une révision, envoyez une requête HTTP PATCH au point de terminaison service de l'API Cloud Run Admin.

Exemple, à l'aide de curl :

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE

Remplacez :

• ACCESS_TOKEN par un jeton d'accès valide pour un compte disposant des autorisations IAM pour déployer les révisions. Par exemple, si vous êtes connecté à gcloud, vous pouvez récupérer un jeton d'accès à l'aide de gcloud auth print-access-token. À partir d'une instance de conteneur Cloud Run, vous pouvez récupérer un jeton d'accès via le serveur de métadonnées d'instance de conteneur.
• IMAGE_URL par une référence à l'image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/hello:latest. Si vous utilisez Artifact Registry, le dépôt REPO_NAME doit déjà être créé. L'URL se présente sous la forme suivante : LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
• SERVICE par le nom du service sur lequel vous déployez l'image.
• REGION par la région Google Cloud du service.
• PROJECT-ID par l'ID du projet Google Cloud.

Console

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

   Accédez à Cloud Run

   • Pour déployer un service existant, recherchez-le dans la liste des services et cliquez pour l'ouvrir, puis cliquez sur MODIFIER ET DÉPLOYER LA NOUVELLE RÉVISION pour afficher le formulaire de déploiement de révision.
   • Cliquez sur Déployer un conteneur et sélectionnez Service pour afficher le formulaire Créer un service.

2. Pour un nouveau service :

   1. Indiquez le nom du service et l'URL de l'image de conteneur d'entrée que vous souhaitez déployer.
   2. Cliquez sur Conteneur(s), volumes, mise en réseau, sécurité.

3. Dans la fiche Modifier le conteneur, configurez le conteneur d'entrée si nécessaire.

4. Cliquez sur Ajouter un conteneur et configurez un conteneur side-car que vous souhaitez ajouter avec le conteneur d'entrée. Si le side-car dépend d'un autre conteneur dans le service, indiquez-le dans le menu déroulant Ordre de démarrage du conteneur. Répétez cette étape pour chaque conteneur side-car que vous déployez.

5. Pour envoyer l'ensemble du trafic vers la nouvelle révision, sélectionnez Diffuser immédiatement la révision. Pour un déploiement progressif, décochez cette case. Cela se traduit par un déploiement dans lequel aucun trafic n'est envoyé à la nouvelle révision. Suivez les instructions de déploiement progressif après avoir effectué votre déploiement.

6. Cliquez sur Créer pour un nouveau service ou sur Déployer pour un service existant, puis attendez la fin du déploiement.

gcloud

Les paramètres container dans Google Cloud CLI sont disponibles en version bêta.

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Pour déployer plusieurs conteneurs sur un service, exécutez la commande suivante :

   gcloud run deploy SERVICE \
    --container INGRESS_CONTAINER_NAME \
    --image='INGRESS_IMAGE' \
    --port='CONTAINER_PORT' \
    --container SIDECAR_CONTAINER_NAME \
    --image='SIDECAR_IMAGE'

   Remplacez :

   • SERVICE par le nom du service sur lequel vous déployez l'image. Vous pouvez omettre ce paramètre, mais dans ce cas le nom du service vous sera demandé.
   • INGRESS_CONTAINER_NAME par le nom du conteneur recevant les requêtes, par exemple app.
   • INGRESS_IMAGE par une référence à l'image de conteneur qui doit recevoir des requêtes, par exemple us-docker.pkg.dev/cloudrun/container/hello:latest.
   • CONTAINER_PORT par le port sur lequel le conteneur d'entrée écoute les requêtes entrantes. Contrairement au scénario avec service à conteneur unique, il n'existe pas de port par défaut pour le conteneur d'entrée d'un service incluant des side-cars. Vous devez configurer explicitement le port du conteneur pour le conteneur d'entrée, et le port ne peut être exposé que sur un seul conteneur.
   • SIDECAR_CONTAINER_NAME par le nom du conteneur side-car, par exemple sidecar.
   • SIDECAR_IMAGE par une référence à l'image de conteneur side-car.

   Si vous souhaitez configurer chaque conteneur dans la commande de déploiement, indiquez la configuration de chaque conteneur après les paramètres container, par exemple :

   gcloud run deploy SERVICE \
     --container CONTAINER_1_NAME \
     --image='INGRESS_IMAGE' \
     --set-env-vars=KEY=VALUE \
     --port='CONTAINER_PORT' \
     --container SIDECAR_CONTAINER_NAME \
     --image='SIDECAR_IMAGE' \
     --set-env-vars=KEY_N=VALUE_N

3. Patientez jusqu'à la fin du déploiement. Une fois l'opération réussie, un message de réussite s'affiche indiquant l'URL du service déployé.

YAML

Ces instructions présentent un fichier YAML de base pour votre service Cloud Run avec side-cars. Créez un fichier nommé service.yaml et insérez-y les éléments suivants :

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  annotations:
  name: SERVICE
spec:
  template:
    spec:
      containers:
      - image: INGRESS_IMAGE
        ports:
          - containerPort: CONTAINER_PORT
      - image: SIDECAR_IMAGE
      

Remplacer

• SERVICE par le nom de votre service Cloud Run ; Les noms de service ne doivent pas comporter plus de 49 caractères.
• CONTAINER_PORT par le port sur lequel le conteneur d'entrée écoute les requêtes entrantes. Contrairement au scénario avec service à conteneur unique, il n'existe pas de port par défaut pour le conteneur d'entrée d'un service incluant des side-cars. Vous devez configurer explicitement le port du conteneur pour le conteneur d'entrée, et le port ne peut être exposé que sur un seul conteneur.
• INGRESS_IMAGE par une référence à l'image de conteneur qui doit recevoir des requêtes, par exemple us-docker.pkg.dev/cloudrun/container/hello:latest.
• SIDECAR_IMAGE par une référence à l'image de conteneur side-car. Vous pouvez spécifier plusieurs side-cars en ajoutant plus d'éléments dans le tableau containers du fichier YAML.

Après avoir mis à jour le fichier YAML pour inclure les conteneurs d'entrée et side-car, déployez sur Cloud Run à l'aide de la commande suivante :

gcloud run services replace service.yaml

Terraform

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez la page Commandes Terraform de base.

Ajoutez les éléments suivants à une ressource google_cloud_run_v2_service dans votre configuration Terraform.

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE"
  location = "REGION"
  ingress = "INGRESS_TRAFFIC_ALL"
  template {
    containers {
      name = "INGRESS_CONTAINER_NAME"
      ports {
        container_port = CONTAINER_PORT
      }
      image = "INGRESS_IMAGE"
      depends_on = ["SIDECAR_CONTAINER_NAME"]
    }
    containers {
      name = "SIDECAR_CONTAINER_NAME"
      image = "SIDECAR_IMAGE"
      }
    }
  }

Le CONTAINER_PORT représente le port sur lequel le conteneur d'entrée écoute les requêtes entrantes. Contrairement au scénario avec service à conteneur unique, il n'existe pas de port par défaut pour le conteneur d'entrée d'un service incluant des side-cars. Vous devez configurer explicitement le port du conteneur pour le conteneur d'entrée, et le port ne peut être exposé que sur un seul conteneur.