Configura notificaciones de Cloud Pub/Sub

Puedes recibir notificaciones de cambios en tus repositorios de GCP con Cloud Pub/Sub. Estas notificaciones te informan cuando un usuario crea un repositorio nuevo, borra un repositorio o envía un cambio en un repositorio existente. Puedes elegir configurar notificaciones para repositorios específicos o durante un proyecto completo.

Para obtener más información sobre Cloud Pub/Sub, consulta el tema ¿Qué es Google Cloud Pub/Sub?

Antes de comenzar

  • Si aún no lo has hecho, sigue los pasos de la Guía de inicio rápido para crear un proyecto, instalar Git y luego inicializar el SDK de Google Cloud.
  • Verifica que tengas los permisos adecuados para crear temas y suscripciones. Para obtener más información, consulta Control de acceso.

Crea un tema de Cloud Pub/Sub

Para cada proyecto o repositorio de Cloud Source Repositories del cual te gustaría recibir notificaciones, debes crear un tema de Cloud Pub/Sub. Puedes crear un tema con la consola o con la herramienta de línea de comandos de gcloud.

Cuando creas un tema, necesitas usar un URI calificado para tu repositorio. El siguientes es el URI calificado:

projects/[PROJECT_ID]/topics/[TOPIC_NAME]

en el que [PROJECT_ID] es tu ID del proyecto de Google Cloud Platform y [TOPIC_NAME] es el nombre del tema.

Sigue los pasos a continuación para crear un tema:

Console

  1. Ve a la página de temas de Cloud Pub/Sub en GCP Console.

    Ir a la página de Cloud Pub/Sub

  2. Haz clic en Crear tema.

  3. Ingresa un nombre de tema con el siguiente URI:

    projects/[PROJECT-ID]/topics/[TOPIC_NAME]
    

    en el que [PROJECT-ID] es tu ID del proyecto de Google Cloud Platform.

  4. Haz clic en Crear.

gcloud

Desde una ventana de terminal, ejecuta el siguiente comando:

gcloud alpha pubsub topics create projects/[PROJECT-ID]/topics/[TOPIC_NAME]

Para obtener más información sobre el comando gcloud alpha pubsub topics, consulta la documentación de topics.

Crea una suscripción a Cloud Pub/Sub

Para recibir eventos publicados de un tema, debes crear una suscripción a Pub/Sub.

Una aplicación de suscriptor recibe mensajes del tema de tu repositorio. Los suscriptores pueden responder a los eventos de tu repositorio cuando envían notificaciones o activan una compilación.

Sigue los pasos a continuación para crear una suscripción:

Console

  1. Ve a la página de temas de Cloud Pub/Sub en GCP Console.

    Ir a la página de Cloud Pub/Sub

  2. Haz clic en el tema de tu proyecto.

  3. Haz clic en Crear suscripción.

  4. Ingresa un nombre de suscripción.

    projects/[PROJECT-ID]/subscriptions/[SUBSCRIPTION_NAME]
    

    Configura el tipo de entrega como extracción.

  5. Haz clic en Crear.

gcloud

Desde una ventana de terminal, ejecuta el siguiente comando:

gcloud alpha pubsub subscriptions create [SUBSCRIPTION_NAME] --topic=[TOPIC_NAME]

Para obtener más información sobre el comando gcloud alpha pubsub subscriptions, consulta la documentación de subscriptions.

Agrega un tema

Puedes agregar una asociación entre un proyecto o repositorio y un tema de Cloud Pub/Sub con la herramienta de línea de comandos de gcloud.

Para agregar un tema a un proyecto completo, escribe el siguiente comando:

gcloud beta source project-configs update --add-topic=[TOPIC_NAME]

Para agregar un tema a un repositorio específico, escribe el siguiente comando:

gcloud beta source repos update [REPOSITORY_NAME] --add-topic=[TOPIC_NAME]

Quita un tema

Puedes quitar una asociación entre un proyecto o repositorio y un tema de Cloud Pub/Sub con la herramienta de línea de comandos de gcloud.

Para quitar un tema de un proyecto completo, escribe el siguiente comando:

gcloud beta source project-configs update --remove-topic=[TOPIC_NAME]

Para quitar un tema de un repositorio específico, escribe el siguiente comando:

gcloud beta source repos update [REPOSITORY_NAME] --remove-topic=[TOPIC_NAME]

Configura el formato del tema

Las notificaciones para Cloud Source Repositories pueden usar el formato JSON o el de búferes de protocolo. Para configurar el formato de un tema, puedes usar el parámetro --message-format cuando agregas el tema, como el siguiente ejemplo:

gcloud beta source project-configs update --add-topic=[TOPIC_NAME] --message-format=[json|protobuf]

También puedes usar el comando de set-format:

gcloud beta source project-configs update --update-topic[TOPIC_NAME] --message-format=[json|protobuf]

¿Qué sigue?

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Cloud Source Repositories