Uso Azure Pipelines con Microsoft Teams

Azure Pipelines

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

Requisitos previos

• Debe tener un proyecto Azure DevOps proyecto. Para obtener más información, vea Crear un proyecto.
• Para configurar suscripciones de canalización, debe ser un administrador Project administrador.

Configuración de la Azure Pipelines aplicación

1. En Microsoft Teams, vaya a la Tienda de aplicaciones, busque Azure Pipelines y,a continuación, seleccione Azure Pipelines.

   

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

   

3. Seleccione o escriba el nombre del equipo y, a continuación, elija Configurar un bot.

   

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

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

Usar comandos

Use los siguientes comandos 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 en 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 dentro de la canalización que tenga o presente en la dirección buildId/releaseId 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 está suscrita a las notificaciones Implementación de versión iniciada,Implementación de versión completada y Aprobación de implementación de versión pendiente es .

Administrar suscripciones

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

1. Ejecute el comando @azure pipelines subscriptions.

2. Seleccione Ver todo 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, Guarde.

   Ejemplo 1: Obtenga notificaciones para las compilaciones con errores.

   

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

   

   Nota

   • Los administradores de equipo no pueden quitar ni modificar las suscripciones creadas por Project administradores.
   • Las notificaciones no se admiten dentro de mensajes directos o de chat.

Aprobación de implementaciones desde el canal

Puede aprobar implementaciones desde el canal sin ir al portal Azure Pipelines web. Suscríbase a la notificación aprobación de implementación de versión pendiente para las versiones clásicas o a la fase de ejecución en espera de la notificación de aprobación para las canalizaciones de 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 Azure Pipelines admite todas las comprobaciones y escenarios de aprobación presentes en Azure Pipelines portal. Puede aprobar solicitudes como un individuo o para un equipo.

Búsqueda y uso compartido de información de canalización mediante la extensión compose

Para ayudar a los usuarios a buscar y compartir información sobre canalizaciones, Azure Pipelines app for Microsoft Teams admite la extensión compose. Ahora puede buscar canalizaciones por identificador de canalización o por nombre de canalización. Para que la extensión compose 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 o iniciando sesión directamente en la @azure pipelines signin extensión compose.

Versiones preliminares de las direcciones URL de canalización

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

Ejemplo 1: Versión preliminar de la dirección URL de compilación

Ejemplo 2: Versión preliminar 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 siguiente comando para cancelar la suscripción a todas las canalizaciones dentro de un proyecto.

@azure pipelines unsubscribe all [project url]

Ejemplo: Cancelar la suscripción a todo 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.

Vinculación de las notificaciones

Vincule un conjunto de notificaciones relacionadas para reducir el espacio ocupado por las notificaciones en un canal. Todas las notificaciones vinculadas a una ejecución determinada de una canalización se vinculan juntas.

Ejemplo 1: Vista compacta de las notificaciones vinculadas.

Ejemplo 2: Vista ampliada de las notificaciones vinculadas.

Uso de comandos en Azure Pipelines aplicación

Consulte los siguientes comandos admitidos por la Azure Pipelines aplicación:

Conectar varios inquilinos

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

Solución de problemas

• 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 el acceso a aplicaciones de terceros a través de OAuth para que la organización esté habilitada. 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 e inicie sesión en . Ejecute el @Azure Pipelines signout comando y, a continuación, ejecute el comando en el canal donde Azure Pipelines la aplicación @Azure Pipelines signin Microsoft Teams está instalada.

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 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.

Artículos relacionados

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