Gérer les révisions du pool de nœuds de calcul

Lorsque vous déployez sur un pool de nœuds de calcul ou modifiez la configuration d'un pool de nœuds de calcul, Cloud Run crée une révision immuable.

Les considérations suivantes s'appliquent aux révisions :

  • Vous n'avez pas besoin de supprimer manuellement les révisions, mais c'est possible si vous le souhaitez.
  • Les révisions inactives ne consomment aucune ressource et ne sont pas facturées.
  • Le nombre maximal de révisions par pool de nœuds de calcul est de 1 000. Si vous dépassez cette limite, les anciennes révisions sont automatiquement supprimées.
  • Le suffixe de révision est attribué automatiquement. Si vous souhaitez utiliser votre propre suffixe, vous pouvez utiliser le faire en utilisant le paramètre de gcloud CLI --revision-suffix.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les pools de nœuds de calcul et les révisions de pools de nœuds de calcul Cloud Run, demandez à votre administrateur de vous accorder le rôle IAM Développeur Cloud Run (roles/run.developer) sur votre pool de nœuds de calcul Cloud Run.

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 pool de nœuds de calcul 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.

Afficher la liste des révisions pour un pool de nœuds de calcul

gcloud

Pour afficher la liste des révisions associées à un pool de nœuds de calcul donné :

  1. Recherchez le nom de votre pool de nœuds de calcul dans la liste des pools de nœuds de calcul disponibles dans votre projet :

    gcloud beta run worker-pools list

  2. Utilisez la commande suivante pour obtenir toutes les révisions de ce pool de nœuds de calcul :

    gcloud beta run worker-pools revisions list
   --worker-pool=WORKER_POOL
   --region=REGION

    Remplacez :

    • WORKER_POOL par le nom de votre pool de nœuds de calcul.
    • REGION par la Google Cloud région du pool de nœuds de calcul.

Afficher les détails d'une révision

gcloud

Pour afficher les détails d'une révision dans votre projet, procédez comme suit :

  1. Recherchez le nom de votre pool de nœuds de calcul dans la liste des pools de nœuds de calcul disponibles dans votre projet :

    gcloud beta run worker-pools list

  2. Utilisez la commande suivante pour obtenir toutes les révisions du pool de nœuds de calcul que vous venez de rechercher : 

    gcloud beta run worker-pools revisions list
    --worker-pool=WORKER_POOL
    --region=REGION

    Remplacer

    • WORKER_POOL par le nom de votre pool de nœuds de calcul.
    • REGION par la Google Cloud région du pool de nœuds de calcul.

  3. Utilisez la commande suivante pour afficher plus de détails sur une révision spécifique : 

    gcloud beta run worker-pools revisions describe REVISION --region=REGION --worker-pool=WORKER_POOL

    Remplacer

    • REVISION par le nom de la révision sur laquelle vous souhaitez en savoir plus.
    • REGION par la Google Cloud région du pool de nœuds de calcul.
    • WORKER_POOL par le nom du pool de nœuds de calcul.

    Vous pouvez utiliser l'option --format pour formater le résultat. Par exemple, pour mettre en forme le résultat au format YAML : 

    gcloud beta run worker-pools revisions describe REVISION
    --region=REGION
    --worker-pool=WORKER_POOL
    --format yaml

Sachez qu'une révision obsolète peut avoir le statut RETIRED, ce qui signifie que Cloud Run a retiré l'infrastructure nécessaire à cette révision particulière.

Supprimer les révisions

Pour s'assurer qu'une révision particulière ne sera pas utilisée accidentellement, une pratique courante consiste à la supprimer.

Vous ne pouvez pas supprimer une révision si elle est :

  • Il s'agit de la seule révision du pool de nœuds de calcul.
  • Dernière révision du pool de nœuds de calcul.

Lorsque vous supprimez une révision, l'image de conteneur utilisée par cette révision n'est pas automatiquement supprimée d'Artifact Registry. Pour supprimer une image de conteneur d'Artifact Registry, consultez les instructions de suppression pour Artifact Registry.

Vous ne pouvez pas annuler la suppression d'une révision.

Utilisez la Google Cloud CLI pour supprimer une révision :

gcloud

Pour supprimer une révision, utilisez la commande suivante :

gcloud beta run worker-pools revisions delete REVISION 
    --region=REGION
    --worker-pool=WORKER_POOL

Remplacer

  • REVISION par le nom de la révision que vous supprimez.
  • WORKER_POOL par le nom de votre pool de nœuds de calcul.
  • REGION par la Google Cloud région du pool de nœuds de calcul.

Étapes suivantes

Après avoir déployé une révision, vous pouvez effectuer les opérations suivantes :