Créer et gérer des instances Cloud Run

Cette page explique comment créer et gérer des instances Cloud Run singleton adressables individuellement. Contrairement aux services Cloud Run qui évoluent en fonction du trafic entrant, une instance est un conteneur de calcul dédié que vous gérez manuellement à l'aide de transitions de cycle de vie (créer, arrêter, démarrer, mettre à jour, supprimer).

Régions où le service est disponible

Vous pouvez créer des instances Cloud Run dans n'importe quelle région compatible, à l'exception des régions suivantes :

• europe-west1
• us-central1
• us-east1

Avant de commencer

1. Configurez un nouveau projet pour Cloud Run, comme décrit sur la page de configuration.

2. Activez l'API Cloud Run Admin :

   gcloud services enable run.googleapis.com
   

3. Mettez à jour les composants gcloud vers la dernière version :

   gcloud components update

4. Si vous êtes soumis à une règle d'administration de restriction de domaine limitant les appels non authentifiés pour votre projet, vous devez accéder au service déployé comme décrit dans la section Tester les services privés.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer et déployer des instances Cloud Run, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Développeur Cloud Run (roles/run.developer) sur l'instance Cloud Run
• Utilisateur du compte de service (roles/iam.serviceAccountUser) sur l'identité du service

Pour obtenir la liste des rôles et des autorisations IAM associés à Cloud Run, consultez les sections Rôles IAM Cloud Run et Autorisations IAM Cloud Run. Si votre instance Cloud Run communique avec des APIGoogle Cloud , telles que des bibliothèques clientes Cloud, consultez le guide de configuration de l'identité du service. Pour en savoir plus sur l'attribution de rôles, consultez les pages Autorisations de déploiement et Gérer les accès.

Créer une instance

Vous pouvez déployer une image de conteneur pour créer une instance. Si vous ne fournissez pas de nom, un nom est généré automatiquement.

gcloud beta run instances create INSTANCE_NAME \
    --image IMAGE_URL \
    --region REGION

gcloud beta run instances deploy INSTANCE_NAME \
    --image IMAGE_URL \
    --region REGION

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "containers": [{
      "image": "IMAGE_URL",
      "ports": [{"containerPort": PORT}]
    }],
    "ingress": "INGRESS_TRAFFIC_ALL",
    "invokerIamDisabled": true,
    "timeout": "3600s"
  }' \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances?instance_id=INSTANCE_NAME"

Une fois l'instance créée, elle reçoit une URL Cloud Run au format suivant :

https://INSTANCE_NAME-PROJECT_NUMBER.REGION.run.app

Mettre à jour une instance

Lorsque vous mettez à jour une instance, par exemple son image de conteneur, son port ou ses variables d'environnement, elle est redémarrée.

gcloud beta run instances update INSTANCE_NAME \
    --image NEW_IMAGE_URL \
    --region REGION

gcloud beta run instances deploy INSTANCE_NAME \
    --image IMAGE_URL \
    --region REGION

curl -H "Content-Type: application/json" \
  -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME"

Arrêter une instance

Utilisez la commande ou la méthode d'arrêt pour arrêter une instance Cloud Run en cours d'exécution.

gcloud beta run instances stop INSTANCE_NAME \
    --region REGION

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME:stop"

Démarrer ou redémarrer une instance

Utilisez la commande ou la méthode "start" pour démarrer une instance arrêtée ou forcer le redémarrage d'une instance existante.

gcloud beta run instances start INSTANCE_NAME \
    --region REGION

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME:start"

Afficher la liste des instances de votre projet

Vous pouvez afficher toutes les instances actives et inactives de votre projet.

gcloud beta run instances list \
    --region REGION

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"

Afficher les détails de l'instance

Utilisez la commande ou la méthode "describe" pour afficher les détails de la configuration et l'état actuel.

gcloud beta run instances describe INSTANCE_NAME \
    --region REGION

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME"

Supprimer une instance

Supprimez une instance pour supprimer définitivement sa configuration, ses métadonnées, son mappage d'URL directe publique et ses rôles d'identité de votre projet.

gcloud beta run instances delete INSTANCE_NAME \
    --region REGION

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME"

Étapes suivantes

• Pour afficher les transactions de journalisation de vos instances, consultez Journalisation et affichage des journaux dans Cloud Run.
• Configurez votre instance Cloud Run :
  • Limites de mémoire
  • Limites de processeur
  • Port du conteneur et point d'entrée
  • Variables d'environnement
  • Installations de volumes
  • Vérification de l'état du conteneur
  • Secrets
  • Identité du service
  • URL par défaut
  • Règles de redémarrage
  • IAP