Azure Pipelines con Slack
Azure Pipelines
Si usa Slack,puede usar la aplicación Azure Pipelines para Slack para supervisar fácilmente los eventos de las canalizaciones. Configure y administre suscripciones para compilaciones, versiones, canalizaciones yaml, aprobaciones pendientes y mucho más de la aplicación y obtenga notificaciones de estos eventos en 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, a continuación, están disponibles en el entorno local en la siguiente versión principal o actualización de Azure DevOps Server. Para obtener más información, consulte Azure DevOps escala de tiempo de características.
Agregar la aplicación Azure Pipelines al área de trabajo de Slack
Vaya a Azure Pipelines aplicación Slack para instalar la aplicación Azure Pipelines en el área de trabajo de Slack. Una vez agregado, verá un mensaje de bienvenida de la aplicación como se indica a continuación. Use el /azpipelines identificador para empezar a interactuar con la aplicación.
Conectar la aplicación Azure Pipelines a las canalizaciones
Una vez instalada la aplicación en el área de trabajo de Slack, puede conectar la aplicación a las canalizaciones que desea supervisar. La aplicación le pedirá que se autentique en Azure Pipelines ejecutar los comandos.
Para empezar a supervisar todas las canalizaciones de un proyecto, use el siguiente comando de barra diagonal dentro de un canal:
/azpipelines subscribe [project url]
La dirección URL del proyecto puede ser en cualquier página del proyecto (excepto las direcciones URL de las canalizaciones).
Por ejemplo:
/azpipelines subscribe https://dev.azure.com/myorg/myproject/
También puede supervisar una canalización específica mediante el siguiente comando:
/azpipelines subscribe [pipeline url]
La dirección URL de canalización puede ser para cualquier página dentro de la canalización que tenga definitionId o en la dirección buildId/releaseId URL.
Por ejemplo:
/azpipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
O bien
/azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases
El comando subscribe le permite empezar a trabajar con algunas suscripciones de forma predeterminada. En el caso de las canalizaciones de compilación, el canal se suscribe a la notificación Compilación completada. En el caso de las canalizaciones de versión, el canal comenzará a recibir las notificaciones Implementaciónde versión iniciada, Implementación de versión completada y Aprobación de implementación de versión pendiente. En el caso de las canalizaciones yaml, se crean suscripciones para el estado de la fase de ejecución cambiado y la fase de ejecución en espera de notificaciones de aprobación.
Administrar suscripciones
Para administrar las suscripciones de un canal, use el siguiente comando:
/azpipelines subscriptions
Este comando enumerará todas las suscripciones actuales del canal y le permitirá agregar nuevas suscripciones.
[! NOTA] Los administradores de equipo no pueden quitar ni modificar las suscripciones creadas por Project administradores.
Uso eficaz de filtros para personalizar suscripciones
Cuando un usuario se suscribe a cualquier canalización, se crean algunas suscripciones de forma predeterminada sin aplicar ningún filtro. A menudo, los usuarios tienen la necesidad de personalizar estas suscripciones. Por ejemplo, es posible que los usuarios solo quieran conocer las compilaciones con errores o recibir una notificación solo cuando las implementaciones se insertan en producción. La Azure Pipelines admite filtros para personalizar lo que ve en el canal.
- Ejecute el comando
/azpipelines subscriptions. - En la lista de suscripciones, si hay una suscripción que no es deseada o debe modificarse (ejemplo: crear ruido en el canal), seleccione el botón Quitar.
- Seleccione el botón Agregar suscripción.
- Seleccione la canalización necesaria y el evento deseado.
- Selección de los filtros adecuados para personalizar la suscripción
Ejemplo: Obtener notificaciones solo para compilaciones con errores
Ejemplo: Obtener notificaciones solo si las implementaciones se insertan en el entorno de producción
Aprobación de implementaciones desde el canal
Puede aprobar implementaciones desde el canal sin tener que ir al portal de Azure Pipelines suscribiéndose a la aprobación de implementación de versión pendiente de notificación para las versiones clásicas o a la fase de ejecución en espera de notificación de aprobación para canalizaciones YAML. Ambas suscripciones se crean de forma predeterminada al suscribirse a la canalización.
Cada vez que la ejecución de una fase está pendiente de aprobación, se publica en el canal una tarjeta de notificación con opciones para aprobar o rechazar la solicitud. Los aprobadores pueden revisar los detalles de la solicitud en la notificación y tomar las medidas adecuadas. En el ejemplo siguiente, la implementación se aprobó y el estado de aprobación se muestra en la tarjeta.
La aplicación admite todas las comprobaciones y escenarios de aprobación presentes en el portal de Azure Pipelines, como aprobador único, varios aprobadores (cualquier usuario, cualquier orden, en secuencia) y equipos como aprobadores. Puede aprobar solicitudes como un usuario individual o en nombre de un equipo.
Versiones preliminares de las direcciones URL de canalización
Cuando un usuario pega una dirección URL de canalización, se muestra una vista previa similar a la de la siguiente imagen. Esto ayuda a mantener las conversaciones relacionadas con la canalización pertinentes y precisas.
Para que esta característica funcione, los usuarios deben haber iniciado sesión. Una vez que haya iniciado sesión, esta característica funcionará para todos los canales de un área de trabajo.
Eliminación de suscripciones y canalizaciones de un canal
Si desea limpiar el canal, use los siguientes comandos para cancelar la suscripción a todas las canalizaciones dentro de un proyecto.
/azpipelines unsubscribe all [project url]
Por ejemplo:
/azpipelines unsubscribe all https://dev.azure.com/myorg/myproject
Este comando elimina todas las suscripciones relacionadas con cualquier canalización del proyecto y quita las canalizaciones del canal.
Importante
Solo los administradores de proyectos pueden ejecutar este comando.
Referencia de comandos
Estos son todos los comandos admitidos por la Azure Pipelines aplicación:
| Comando de barra diagonal | Funcionalidad |
|---|---|
| /azpipelines subscribe [dirección URL de canalización/ dirección URL del proyecto] | Suscripción a una canalización o a todas las canalizaciones de un proyecto para recibir notificaciones |
| /azpipelines subscriptions | Agregar o quitar suscripciones para este canal |
| Comentarios de /azpipelines | Notificar un problema o sugerir una característica |
| Ayuda de /azpipelines | Obtener ayuda sobre los comandos de barra diagonal |
| /azpipelines signin | Inicie sesión en su cuenta Azure Pipelines aplicación |
| /azpipelines signout | Cerrar sesión desde su cuenta Azure Pipelines cliente |
| /azpipelines cancelar la suscripción a todo [dirección URL del proyecto] | Quitar todas las canalizaciones (que pertenecen a un proyecto) y sus suscripciones asociadas de un canal |
Notificaciones en canales privados
La Azure Pipelines aplicación también puede ayudarle a supervisar la actividad de canalizaciones en los canales privados. Tendrá que invitar al bot a su canal privado mediante /invite @azpipelines .
Después, puede configurar y administrar las notificaciones de la misma manera que lo haría para un canal público.
Nota:
- Puede usar la aplicación Azure Pipelines para Slack solo con un proyecto hospedado en Azure DevOps Services en este momento.
- El usuario debe ser administrador del proyecto que contiene la canalización para configurar las suscripciones.
- Las notificaciones no se admiten actualmente dentro de los mensajes directos
- No se admiten las aprobaciones de implementación que tienen aplicada la directiva "Revalidar la identidad del aprobador antes de completar la aprobación".
- "El acceso a aplicaciones de terceros a través de OAuth" debe estar habilitado para recibir notificaciones para la organización en Azure DevOps (Organización Configuración seguridad > - > Directivas)
Solución de problemas
Si experimenta los siguientes errores al usar Azure Pipelines App for Slack,siga los procedimientos de esta sección.
- Lo sentimos, algo salió mal. Inténtelo de nuevo.
- Error de configuración. Asegúrese de que la organización "{nombre de organización}" existe y de que tiene permisos suficientes.
Lo sentimos, algo salió mal. Inténtelo de nuevo.
La Azure Pipelines usa el protocolo de autenticación de OAuth y requiere que se habilite el acceso a aplicaciones de terceros a través de OAuth para la organización. Para habilitar esta configuración, vaya aOrganization Configuración Security Policies (Directivas de seguridad de la organización) y establezca el acceso a aplicaciones de terceros a través de OAuth para la configuración de la organización en On (En).
Error de configuración. Asegúrese de que la organización "{nombre de organización}" existe y de que tiene permisos suficientes.
Para cerrar sesión Azure DevOps, vaya a https://aka.ms/VsSignout mediante el explorador.
Abra una ventana del explorador En privado o incógnito y vaya a e inicie sesión. En la lista desplegable bajo el icono de perfil de la izquierda, seleccione el directorio que contiene la organización que contiene la canalización a la que desea suscribirse.
En el mismo explorador,inicie una nueva pestaña, vaya a e inicie sesión en el espacio de trabajo(use el cliente web). Ejecute el /azpipelines signout comando seguido del comando /azpipelines signin .
Seleccione el Sign in botón y se le redirigirá a una página de consentimiento como la del ejemplo siguiente. Asegúrese de que el directorio que se muestra junto al correo electrónico es el mismo que el que se eligió en el paso anterior. Acepte y complete el proceso de inicio de sesión.
Si estos pasos no resuelven el problema de autenticación, puede comunicarse con nosotros en Developer Community.