Uso de Azure Pipelines con Microsoft Teams

Azure DevOps Services

La aplicación Azure Pipelines para Microsoft Teams le permite supervisar eventos para las canalizaciones. Puede configurar y obtener notificaciones en el canal de Teams relacionadas con versiones, aprobaciones pendientes, compilaciones completadas, etc. También puede aprobar versiones desde el canal de Teams.

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 más información, consulte Escala de tiempo de características de Azure DevOps.

Prerrequisitos

• Debe tener un proyecto de Azure DevOps. Para más información, consulte Creación de un proyecto.
• Para configurar suscripciones de canalización, debe ser administrador del proyecto.

Configuración de la aplicación Azure Pipelines

1. En Microsoft Teams, vaya a la tienda de Aplicaciones, busque Azure Pipelines y seleccione Azure Pipelines.

   

2. Seleccione la flecha desplegable Abrir y, a continuación, Agregar a un equipo.

   

3. Seleccione o escriba el nombre del equipo y elija Configurar un bot.

   

4. En el panel de conversación de Teams, escriba @azurePipelines signin.

5. Seleccione Iniciar sesión y complete la autenticación en Azure Pipelines.

Usar comandos

Use los comandos siguientes para supervisar todas las canalizaciones de un proyecto o solo canalizaciones específicas.

• Supervise todas las canalizaciones de un proyecto. La dirección URL puede estar en cualquier página del proyecto, excepto las direcciones URL de las canalizaciones. Por ejemplo, @azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

  @azure pipelines subscribe [project url]
  

• Supervisión de una canalización específica: la dirección URL de la canalización puede estar en cualquier página de la canalización que tenga definitionId o buildId/releaseId en la dirección URL. Por ejemplo, @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

  @azure pipelines subscribe [pipeline url]
  

  Otro ejemplo de una canalización de versión que se suscribe a las notificaciones Implementación de versión iniciada, Implementación de versión completaday Aprobación de implementación de versión pendiente es @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases.

Nota

• No se admiten las aprobaciones de implementación en las que se aplicó la directiva Volver a validar la identidad del aprobador antes de completar la aprobación.
• Habilite el "acceso a aplicaciones de terceros a través de OAuth" para recibir notificaciones para la organización en Azure DevOps.

Administrar suscripciones

Al suscribirse a una canalización, se crean algunas suscripciones de manera predeterminada sin ningún filtro aplicado. Es posible que quiera personalizar estas suscripciones. Por ejemplo, puede que quiera recibir notificaciones solo cuando se produzca un error en las compilaciones o cuando las implementaciones se inserten en un entorno de producción. La aplicación Azure Pipelines admite filtros para personalizar lo que ve en el canal. Para administrar las suscripciones, complete los pasos siguientes.

1. Ejecute el comando @azure pipelines subscriptions.

2. Seleccione Ver todas las suscripciones. En la lista de suscripciones, si hay una suscripción que no desea, seleccione Quitar.

3. Desplácese hacia abajo y seleccione Agregar suscripción.

4. Seleccione la canalización y el evento necesarios.

5. Seleccione los filtros adecuados y, a continuación, seleccione Guardar.

   Ejemplo 1: Obtener notificaciones para compilaciones con errores.

   

   Ejemplo 2: Obtener notificaciones solo si las implementaciones se insertan en el entorno de producción.

   

   Nota

   • Los administradores del equipo no pueden quitar ni modificar las suscripciones creadas por los administradores del proyecto.
   • No se admiten notificaciones dentro de mensajes directos o de chat.

Aprobación de implementaciones desde el canal

Puede aprobar implementaciones desde el canal sin que sea necesario ir al portal de Azure Pipelines. Suscríbase a la notificación Aprobación de implementación de versión pendiente para las versiones clásicas o a la notificación La fase de ejecución está pendiente de aprobación para las canalizaciones de YAML. Ambas suscripciones se crean de manera 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 Azure Pipelines admite todas las comprobaciones y los escenarios de aprobación presentes en el portal de Azure Pipelines. Puede aprobar solicitudes como individuo o para un equipo.

Búsqueda y uso compartido de información de canalizaciones mediante la extensión de redacción

Para ayudar a los usuarios a buscar y compartir información sobre canalizaciones, la aplicación Azure Pipelines para Microsoft Teams admite la extensión de redacción. Ahora puede buscar canalizaciones por identificador de canalización o por nombre de canalización. Para que la extensión de redacción funcione, los usuarios deben iniciar sesión en el proyecto de Azure Pipelines en el que estén interesados mediante la ejecución del comando @azure pipelines signin o iniciando sesión directamente en la extensión de redacción.

Vista previa de direcciones URL de canalización

Al agregar una dirección URL de canalización a Teams, verá una vista previa similar a las imágenes siguientes. La vista previa permite mantener actualizadas las conversaciones relacionadas con la canalización. Puede elegir entre tarjetas compactas y expandidas.

Ejemplo 1: Vista previa de la dirección URL de compilación

Ejemplo 2: Vista previa de la dirección URL de versión

Una vez que haya iniciado sesión, esta característica funciona para todos los canales de un equipo de Microsoft Teams.

Cancelación de la suscripción a un canal de canalización

Use el comando siguiente para cancelar la suscripción a todas las canalizaciones de un proyecto.

@azure pipelines unsubscribe all [project url]

Ejemplo: Cancelación de todas las suscripciones con la dirección URL

@azure pipelines 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 del proyecto pueden ejecutar este comando.

Vinculación de las notificaciones

Todas las notificaciones vinculadas a una ejecución determinada de una canalización se vinculan juntas.

Ejemplo 1: Vista compacta de notificaciones vinculadas.

Ejemplo 2: Vista expandida de notificaciones vinculadas.

Uso de comandos en la aplicación Azure Pipelines

Consulte los comandos siguientes compatibles con la aplicación Azure Pipelines:

Comando de barra oblicua	Funcionalidad
@azure pipelines subscribe [pipeline url/ project url]	Suscribirse a una canalización o a todas las canalizaciones de un proyecto para recibir notificaciones
@azure pipelines subscriptions	Agregar o quitar suscripciones de este canal
@azure pipelines feedback	Notificar un problema o sugerir una característica
@azure pipelines help	Obtener ayuda sobre los comandos de barra oblicua
@azure pipelines signin	Iniciar sesión en la cuenta de Azure Pipelines
@azure pipelines signout	Cerrar sesión en la cuenta de Azure Pipelines
@azure pipelines unsubscribe all [project url]	Quitar todas las canalizaciones (que pertenecen a un proyecto) y sus suscripciones asociadas de un canal

Conexión de varios inquilinos

Si usa un correo electrónico o inquilino diferente para Microsoft Teams y Azure DevOps, siga estos pasos para iniciar sesión y conectarse en función del caso de uso en cuestión.

Caso de uso	ID de correo electrónico y cuenta empresarial en Microsoft Teams	ID de correo electrónico y cuenta empresarial en Azure DevOps	Acción de inicio de sesión
1	email1@abc.com (inquilino 1)	email1@abc.com (inquilino 1)	Seleccione Iniciar sesión.
2	email1@abc.com (inquilino 1)	email2@pqr.com (inquilino 2)	- Inicie sesión en Azure DevOps. - En el mismo explorador, inicie una pestaña nueva y vaya a https://teams.microsoft.com/. - Ejecute el comando sign in y seleccione Iniciar sesión.
3	email1@abc.com (inquilino 1)	email2@pqr.com (inquilino 2)	- Seleccione Iniciar sesión con una dirección de correo electrónico diferente. - En el selector de identificadores de correo electrónico, use email2 para iniciar sesión.
4	email1@abc.com (inquilino 1)	email2@pqr.com (inquilino no predeterminado 3)	No se admite actualmente.

Solución de problemas

En el mismo explorador, abra una pestaña nueva e inicie sesión en https://teams.microsoft.com/. Ejecute el comando @Azure Pipelines signout y, después, ejecute el comando @Azure Pipelines signin en el canal donde está instalada la aplicación Azure Pipelines para Microsoft Teams.

Seleccione el botón Sign in y se lo 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 seleccionó en el paso anterior. Acepte y complete el proceso de inicio de sesión.

Si estos pasos no resuelven el problema de autenticación, póngase en contacto con nosotros en Developer Community.

Artículos relacionados

• Uso de Azure Boards con Microsoft Teams
• Uso de Azure Repos con Microsoft Teams