Compartir a través de

Uso de Azure Pipelines con Slack

Azure DevOps Services

En este artículo se muestra cómo usar la aplicación Azure Pipelines para Slack para supervisar los eventos de canalización. Puede establecer y administrar suscripciones para eventos de canalización, como compilaciones, versiones y aprobaciones pendientes. Las notificaciones de estos eventos se entregan directamente a los canales de Slack.

Nota:

Esta característica solo está disponible en Azure DevOps Services. Normalmente, las nuevas características se introducen primero en el servicio en la nube y, luego, se pone a disposición local en la siguiente versión principal o actualización de Azure DevOps Server. Para obtener más información, consulte Escala de tiempo de características de Azure DevOps.

Requisitos previos

  • Una cuenta de Slack con permiso para instalar una aplicación en el área de trabajo de Slack.
  • Un proyecto de Azure DevOps con permisos de administradores de colecciones de proyectos o administradores de proyectos.
  • No debe ser un usuario externo en Microsoft Entra.

Instalación de la aplicación Azure Pipelines

Instale la aplicación Slack de Azure Pipelines en el área de trabajo de Slack. Una vez que se instala la aplicación, verá el siguiente mensaje de bienvenida. Escriba /azpipelines para empezar a interactuar con la aplicación.

Captura de pantalla que muestra el mensaje de bienvenida de la aplicación Azure Pipelines.

Conéctese a la canalización

Una vez instalada la aplicación en el área de trabajo de Slack, puede conectar la aplicación a cualquier canalización que quiera supervisar. Debe autenticarse en Azure Pipelines antes de ejecutar los comandos.

Captura de pantalla que muestra el mensaje de solicitud de inicio de sesión.

Nota:

Si la organización de Azure DevOps está conectada a un inquilino de Microsoft Entra ID, debe iniciar sesión con un miembro nativo de ese inquilino. Los usuarios externos reciben el siguiente error si intentan iniciar sesión en la aplicación Azure Pipelines: Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.

Suscripción a canalizaciones

Para empezar a supervisar todas las canalizaciones de un proyecto, escriba /azpipelines subscribe <project url> en un canal y reemplace por <project url> la dirección URL del proyecto de Azure DevOps. La dirección URL del proyecto puede vincularse a cualquier página del proyecto, excepto las páginas de canalización, por ejemplo /azpipelines subscribe https://dev.azure.com/myorg/myproject/.

Puede supervisar una canalización específica mediante /azpipelines subscribe <pipeline url>. La dirección URL de la canalización puede vincularse a cualquier página de la canalización que tenga definitionId o buildId/releaseId en la dirección URL. Por ejemplo:

  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases

El subscribe comando le suscribe a las siguientes notificaciones de forma predeterminada:

  • Para canalizaciones de YAML:
    • Estado de fase de ejecución cambiado
    • Fase de ejecución en espera de aprobación
  • Para canalizaciones de compilación clásicas, compilaciones completadas
  • Para canalizaciones de versión clásicas:
    • Implementación de versión iniciada
    • Implementación de versión completada
    • Aprobación de implementación de versión pendiente

Captura de pantalla que muestra una notificación de ejemplo.

Administrar suscripciones

Para administrar las suscripciones de un canal, escriba /azpipelines subscriptions. Este comando muestra todas las suscripciones actuales para el canal y le permite agregar o quitar suscripciones.

Captura de pantalla que muestra una lista de suscripciones.

Nota:

Los administradores del equipo no pueden quitar ni modificar suscripciones creadas por los administradores de proyectos.

Personalización de suscripciones

Las suscripciones predeterminadas no tienen ningún filtro aplicado, pero puede personalizar estas suscripciones según sus preferencias. Por ejemplo, es posible que quiera recibir notificaciones solo para compilaciones o implementaciones con errores en producción. Puede aplicar filtros para personalizar los mensajes que recibe en el canal.

Para personalizar una suscripción:

  1. Ejecute el comando /azpipelines subscriptions para enumerar todas las suscripciones.
  2. Seleccione Agregar suscripción.
  3. Seleccione el evento al que desea suscribirse y, a continuación, seleccione la configuración deseada.
  4. Seleccione Guardar.

Por ejemplo, para obtener notificaciones solo para compilaciones con errores, seleccione Error en Estado de compilación.

Captura de pantalla que muestra cómo personalizar una suscripción.

Aprobación de implementaciones

Puede aprobar implementaciones desde el canal de Slack sin ir a Azure Pipelines. Suscríbase a la fase de ejecución esperando notificaciones de aprobación para canalizaciones de YAML o notificaciones pendientes de aprobación de implementación de versión para versiones clásicas. Ambas suscripciones se crean de forma predeterminada al suscribirse a una canalización.

Captura de pantalla que muestra la aprobación de la canalización en Slack.

La aplicación Azure Pipelines para Slack le permite controlar todos los escenarios de comprobación y aprobación que están disponibles en el portal de Azure Pipelines. Estos escenarios incluyen aprobador único, varios aprobadores y aprobación basada en equipo. Puede aprobar solicitudes individualmente o en nombre de un equipo.

Captura de pantalla que muestra una canalización de implementación previa aprobada en Slack.

Eliminación de todas las suscripciones

Para desconcluir el canal, puede usar el comando para cancelar la /azpipelines unsubscribe all <project url> suscripción a todas las canalizaciones de un proyecto. Por ejemplo, /azpipelines unsubscribe all https://dev.azure.com/myorg/myproject.

Importante

Solo los administradores del proyecto pueden ejecutar este comando.

Referencia de comandos

La aplicación Azure Pipelines para Slack admite los siguientes comandos:

Comando Descripción
/azpipelines subscribe <pipeline url or project url> Suscríbase a una canalización o a todas las canalizaciones de un proyecto y reciba notificaciones.
/azpipelines subscriptions Agregar o quitar suscripciones de este canal.
/azpipelines feedback Notificar un problema o sugerir una característica.
/azpipelines help Obtener ayuda sobre los comandos.
/azpipelines signin Inicie sesión en su cuenta de Azure Pipelines.
/azpipelines signout Cierre la sesión de la cuenta de Azure Pipelines.
/azpipelines unsubscribe all <project url> Quite todas las canalizaciones de proyecto y sus suscripciones asociadas de un canal.

Notificaciones en canales privados

La aplicación Azure Pipelines también puede ayudarle a supervisar la actividad de las canalizaciones en los canales privados. Debe invitar al bot al canal privado mediante /invite @azpipelines. Una vez que agregue el bot, puede configurar y controlar las notificaciones de la misma manera que para un canal público.

Solución de problemas

Si recibe los siguientes errores al usar la aplicación Azure Pipelines para Slack, pruebe el procedimiento siguiente.

Error de configuración. Asegúrese de que la organización existe y de que tiene permisos suficientes.

Si ve este error, lo más probable es que sea un usuario invitado en el inquilino de Microsoft Entra conectado a su organización de Azure DevOps. Necesita que un miembro de Microsoft Entra realice los pasos de configuración.

  • Last updated on