Utiliser les notifications Cloud Deploy

Cette page explique comment utiliser les notifications de service Cloud Deploy, y compris comment s'y abonner.

Cloud Deploy utilise Pub/Sub pour publier des notifications à deux fins :

  • Pour vous permettre d'intégrer Cloud Deploy à des outils tiers et à d'autres outils Google, tels que les outils de gestion des workflows ou d'infrastructure de test.

  • Pour étendre Cloud Deploy à l'aide d'une logique métier supplémentaire.

Thèmes disponibles

Cloud Deploy publie des messages dans l'ensemble de sujets Google Pub/Sub suivants :

  • clouddeploy-resources

    Lorsqu'une opération (création, mise à jour, suppression) est effectuée sur une ressource Cloud Deploy principale (automatisation, type de cible personnalisée, pipeline de déploiement, exécution de job, version, déploiement, cible).

  • clouddeploy-operations

    • Lorsque Cloud Deploy affiche la configuration Skaffold.
    • Lorsque Cloud Deploy effectue un déploiement sur une cible (Start, Succeed, Failure, Terminated (exécution de job), Cancelled (déploiement)).

  • clouddeploy-approvals

    • Lorsque Cloud Deploy a besoin d'une approbation (ou d'un refus) pour un déploiement.
    • Lorsqu'un déploiement a été approuvé ou refusé.

  • clouddeploy-advances

    • Lorsqu'un déploiement Cloud Deploy est passé d'une phase à la suivante.
    • Lorsqu'un déploiement est prêt à être avancé.

Vous pouvez utiliser un modèle push ou pull avec vos abonnements Pub/Sub.

Recevoir des notifications de service Cloud Deploy

Pour recevoir des notifications du service Cloud Deploy :

  1. Activez l'API Cloud Deploy pour votre projet :

    Activer l'API Cloud Deploy

  2. Activer l'API Pub/Sub :

    Activez l'API Pub/Sub

  3. Créez le ou les sujets Pub/Sub en fonction des types de notifications que vous souhaitez recevoir :

    gcloud pubsub topics create clouddeploy-resources
gcloud pubsub topics create clouddeploy-operations
gcloud pubsub topics create clouddeploy-approvals
gcloud pubsub topics create clouddeploy-advances

    Pour en savoir plus sur la gestion des sujets Pub/Sub, consultez Créer un sujet.

S'abonner aux notifications du service Cloud Deploy

Vous pouvez configurer les notifications du service Cloud Deploy pour les abonnements push et les abonnements pull. Pour savoir comment configurer des abonnements Pub/Sub pour ces notifications, consultez Choisir un type d'abonnement. Vous pouvez également en savoir plus sur les bibliothèques clientes Pub/Sub, qui facilitent le développement d'applications pour les abonnés.

Valeurs des champs

Cette section liste les valeurs possibles pour les champs des messages Cloud Deploy Pub/Sub.

Pour Action

Dans ces notifications, les valeurs possibles pour Action sont les suivantes :

  • Pour les ressources

    • Create
    • Update
    • Delete

  • Pour les opérations :