Créer des conteneurs

Cloud Run accepte les images de conteneur créées avec n'importe quel outil capable de générer des images de conteneur, pour autant qu'elles respectent le contrat relatif au conteneur. En particulier, votre code doit écouter les requêtes HTTP sur le port défini par la variable d'environnement PORT. Cette variable d'environnement PORT est automatiquement injectée par Cloud Run dans votre conteneur.

Cette page décrit plusieurs façons de créer des images de conteneur :

• Utiliser un fichier Dockerfile
• Utiliser les buildpacks Google Cloud

Avant de commencer

• Vous avez besoin de Google Cloud CLI pour exécuter certaines des commandes de cette page.

• Créez un dépôt dans un registre de conteneurs compatible. Pour créer un dépôt Artifact Registry, exécutez la commande suivante :

      gcloud artifacts repositories create REPOSITORY \
          --repository-format=docker \
          --location=LOCATION \
          --description="DESCRIPTION" \
          --immutable-tags \
          --async
  

• Vous pouvez configurer Docker pour accéder à Artifact Registry à l'aide de l'assistant d'identification de la gcloud CLI.

  gcloud auth configure-docker LOCATION-docker.pkg.dev

Attention : Container Registry est obsolète et son abandon est planifié. Les organisations n'ayant pas utilisé Container Registry avant le 8 janvier 2024 disposeront par défaut des nouveaux dépôts gcr.io hébergés sur Artifact Registry. Depuis le 15 mai 2024, les projets Google Cloud qui n'utilisaient pas Container Registry précédemment n'accepteront que l'hébergement et la gestion des images dans Artifact Registry pour le domaine gcr.io.

L'arrêt de Container Registry est prévu pour le 18 mars 2025. Pour en savoir plus sur cet arrêt, consultez la page Abandon de Container Registry.

Compiler à l'aide d'un fichier Dockerfile

Attention : N'incluez pas le fichier ~/.config/gcloud/gce dans votre image. Ce fichier est généré si vous exécutez des commandes Google Cloud CLI lors de la compilation de votre image. Il peut entraîner des problèmes d'authentification lorsque l'image s'exécute dans Cloud Run.

Avant de compiler en local vos sources dans une image de conteneur ("conteneurisation") à l'aide de Docker ou Cloud Build, vous devez disposer d'un fichier Dockerfile et de sources. Les exemples Hello World contiennent des exemples d'applications et des fichiers Dockerfile dans de nombreux langages courants.

Si vous utilisez des fichiers Dockerfile, vous pouvez procéder de l'une ou l'autre des manières suivantes :

• Compiler à l'aide de Cloud Build
• Compiler localement à l'aide de Docker

Compiler à l'aide de Cloud Build

Vous pouvez créer une image sur Google Cloud en utilisant Cloud Build comme suit :

1. Naviguez jusqu'au dossier contenant vos sources et votre fichier Docker.

2. Exécutez la commande suivante :

   gcloud builds submit --tag IMAGE_URL

   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.

Pour obtenir des conseils sur l'amélioration des performances de compilation, consultez la page Bonnes pratiques pour accélérer les compilations.

Créer des images localement et les transférer à l'aide de Docker

Si Docker est installé localement, vous pouvez utiliser docker build au lieu d'utiliser Cloud Build ou les buildpacks Google Cloud.

Pour créer une image de conteneur à l'aide de Docker, procédez comme suit :

1. Accédez au dossier contenant vos sources et votre fichier Dockerfile.

2. Exécutez la commande suivante :

   docker build . --tag IMAGE_URL

   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 utilisez un Mac avec Apple Silicon, vous devez spécifier --platform linux/amd64 dans la ligne de commande.

3. Transférez l'image de conteneur vers un registre de conteneurs compatible :

   docker push IMAGE_URL

   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.

Pour exclure les fichiers locaux de ce processus, suivez les instructions du fichier de configuration .dockerignore.

Compiler à l'aide des buildpacks Google Cloud

Les buildpacks de Google Cloud sont un ensemble de packs de création compatibles avec CNCF qui compilent du code source dans des images de conteneurs conçues pour s'exécuter sur les plates-formes de conteneurs Google Cloud, y compris Cloud Run.

Pour obtenir la liste des langages acceptés, consultez la documentation sur les buildpacks de Google Cloud.

Compiler avec les buildpacks de Google Cloud à l'aide de Cloud Build

Pour compiler avec les buildpacks Google Cloud :

1. Accédez au dossier contenant vos sources.

2. Exécutez la commande suivante :

   gcloud builds submit --pack image=IMAGE_URL

   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.

3. Attendez la fin de la compilation.

Compiler avec les buildpacks Google Cloud à l'aide de la ligne de commande pack

Pour compiler à l'aide de la ligne de commande pack :

1. Si vous ne l'avez pas déjà fait, installez Docker.

2. Si vous ne l'avez pas déjà fait, installez pack.

3. Accédez au dossier contenant vos sources.

4. Exécutez la commande suivante pour créer des conteneurs et les transférer vers votre registre de conteneurs compatible :

   pack build --publish IMAGE_URL

   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.

5. Attendez que pack ait terminé.

Pour en savoir plus, consultez les instructions de la section Créer une application.

Étape suivante

• Une fois votre conteneur créé, vous pouvez effectuer des tests en local avant de le déployer sur Cloud Run. Pour en savoir plus, consultez la section Tester un service Cloud Run localement.
• Pour en savoir plus sur le contrat que vos conteneurs doivent respecter pour pouvoir être déployés dans Cloud Run, consultez la page Contrat relatif aux conteneurs.
• Pour déployer vos conteneurs créés sur Cloud Run, suivez les consignes Déployer des services.
• Pour automatiser les versions et les déploiements de vos services Cloud Run à l'aide des déclencheurs Cloud Build, configurez le déploiement continu.
• Pour optimiser la création de conteneurs pour une application Java, consultez la page Créer des conteneurs Java avec Jib.