Uso de Azure Repos con Microsoft Teams

  • Artículo

Azure DevOps Services

Si usa Microsoft Teams y Azure Repos, puede usar la aplicación Azure Repos para Teams para supervisar los repositorios. La aplicación admite la supervisión de repositorios de Git y Control de versiones de Team Foundation (TFVC), pero no admite la integración con repositorios de GitHub.

En este artículo, aprenderá a realizar las siguientes tareas:

  • Agregar la aplicación Azure Repos al equipo en Microsoft Teams
  • Conexión de la aplicación Azure Repos a los repositorios
  • Administración de suscripciones a eventos relacionados con el repositorio en el canal
  • Búsqueda y uso compartido de información de solicitud de incorporación de cambios mediante la extensión compose
  • Obtener una vista previa de las direcciones URL de solicitud de incorporación de cambios
  • Eliminación de suscripciones y repositorios de un canal

Requisitos previos

  • Administre la suscripción, por lo que recibirá notificaciones en el canal siempre que el código se inserte o se proteja, o cuando se cree, actualice o combine una solicitud de incorporación de cambios (PR). Para crear suscripciones para eventos relacionados con el repositorio, debe ser miembro del grupo Administradores de proyectos o de un administrador de equipo. Para agregarlo, consulte Cambiar permisos de nivel de proyecto o Agregar un administrador de equipo.
  • Para recibir notificaciones, habilite el acceso de la aplicación de terceros a través de la configuración de OAuth para la organización de Azure DevOps. Consulte Cambio de directivas de acceso a aplicaciones para su organización.

Nota

  • Actualmente, no se admiten notificaciones dentro de mensajes directos.
  • Solo puede vincular la aplicación Azure Repos para Microsoft Teams a un proyecto hospedado en Azure DevOps Services.

Agregar la aplicación Azure Repos a un equipo en Microsoft Teams

  1. Vaya a la aplicación Azure Repos en Microsoft Teams, microsoft Teams > Azure Repos.

  2. Seleccione Agregar o, si ya descargó la aplicación, seleccione el menú desplegable situado junto a Abrir y, a continuación, seleccione Agregar a un equipo.

  3. Escriba un nombre de equipo o canal y, a continuación, seleccione Configurar un bot.

    Captura de pantalla del mensaje de bienvenida de Azure Repos en Teams.

Conexión de la aplicación Azure Repos a los repositorios

  1. Una vez instalada la aplicación en el equipo, escriba el texto siguiente en el campo de respuesta: @azure repos signin

    Si microsoft Teams y Azure Boards están en distintos inquilinos, seleccione Iniciar sesión con otro correo electrónico.

    Captura de pantalla que muestra la entrada de inicio de sesión de Teams para Azure Repos.

    Captura de pantalla que muestra la respuesta completa de inicio de sesión.

  2. Para supervisar todos los repositorios de Git de un proyecto, escriba @azure repos subscribe [project url] en el canal. Asegúrese de agregar la dirección URL del proyecto. La dirección URL del proyecto puede ser en cualquier página del proyecto (excepto las direcciones URL de los repositorios).

    También puede supervisar un repositorio específico mediante: @azure repos subscribe [repo url].

    La dirección URL del repositorio puede ser en cualquier página del repositorio que tenga el nombre del repositorio, por ejemplo, @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepoo para repositorios TFVC: @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

  3. El subscribe comando le permite empezar a usar una suscripción predeterminada. En el caso de los repositorios de Git, el canal se suscribe al evento de solicitud de incorporación de cambios ( con la rama de destino = main). En el caso de los repositorios de TFVC, el canal se suscribe al evento Código protegido .

    Captura de pantalla que muestra el mensaje de creación de suscripciones predeterminada.

Administrar suscripciones

Para ver, agregar y quitar suscripciones de un canal, escriba el texto siguiente: @azure repos subscriptions.

Verá una lista de todas las suscripciones actuales para el canal y puede agregar nuevas suscripciones o quitar las existentes. Personalice las notificaciones con varios filtros, como se describe en la sección siguiente.

Nota

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

Ver suscripciones

Usar filtros para obtener solo las notificaciones que desee

Cuando se suscribe a un repositorio con @azure repos subscribe, se crea una suscripción predeterminada sin filtros aplicados. A menudo, los usuarios deben personalizar estas suscripciones para recibir notificaciones solo cuando se cumplen determinadas condiciones. En las capturas de pantalla siguientes se muestra un ejemplo de configuración de notificaciones solo cuando nuestro equipo está en la lista de revisores de una solicitud de incorporación de cambios.

  1. Escriba el texto siguiente en el canal: @azure repos subscriptions.

  2. En la lista de suscripciones, si hay una suscripción que no desea o debe modificarse, seleccione Quitar para eliminarla.

  3. Seleccione el botón Agregar suscripción .

  4. Elija un tipo de evento y, a continuación, seleccione Siguiente.

    Captura de pantalla que muestra la selección del tipo de evento.

  5. Elija un repositorio y, a continuación, seleccione Siguiente.

    Captura de pantalla que muestra la selección del repositorio.

  6. Seleccione los filtros adecuados para personalizar la suscripción y, a continuación, seleccione Enviar.

    Captura de pantalla que muestra los filtros elegidos.

Nota

  • Normalmente, todos los filtros son listas desplegables. Sin embargo, si la lista desplegable tiene más de 100 elementos, debe escribir manualmente los valores.
  • Para el evento TfVC Code Checked in , el filtro Under path debe tener el formato $/myproject/path.

Búsqueda y uso compartido de información de solicitud de incorporación de cambios mediante la extensión compose

Para ayudar a los usuarios a buscar y compartir información sobre las solicitudes de incorporación de cambios, Azure Repos aplicación para Microsoft Teams admite una extensión de redacción. Puede buscar solicitudes de incorporación de cambios por identificador o nombre. Para que la extensión funcione, inicie sesión en el proyecto de Azure Repos escribiendo @azure repos signin o iniciando sesión directamente en la extensión de redacción.

Captura de pantalla que muestra la extensión de redacción.

Obtener una vista previa de las direcciones URL de solicitud de incorporación de cambios

Al pegar la dirección URL de una solicitud de incorporación de cambios, una vista previa se muestra como la de la siguiente imagen, lo que ayuda a mantener las conversaciones relacionadas con pr contextuales y precisas. Debe haber iniciado sesión y, a continuación, puede obtener una vista previa de las direcciones URL de todos los canales de un equipo.

Captura de pantalla en la que se muestra la implementación de la dirección URL.

Eliminación de suscripciones y repositorios de un canal

Para eliminar todas las suscripciones relacionadas con cualquier repositorio del proyecto y quitar los repositorios del canal, escriba el texto siguiente en Teams: @azure repos unsubscribe all [project url]. Asegúrese de escribir la dirección URL del proyecto. Solo los administradores del proyecto pueden realizar esta tarea.

Notificaciones en subprocesos

Para vincular un conjunto de notificaciones relacionadas y también para reducir el espacio ocupado por las notificaciones en un canal, las notificaciones se subprocesan. Todas las notificaciones vinculadas a una solicitud de incorporación de cambios determinada están vinculadas juntas.

Vista compacta de notificaciones subprocesadasCaptura de pantalla que muestra la vista compacta de las notificaciones con subprocesos.

Vista expandida de notificaciones subprocesadasCaptura de pantalla en la que se muestra la vista expandida de las notificaciones con subprocesos.

Referencia de comandos

En la tabla siguiente se enumeran todos los azure repos comandos que puede usar en el canal de Teams.

Get-Help Funcionalidad
@azure repos subscribe [repo url/ project url] Suscribirse a un repositorio o a todos los repositorios de un proyecto para recibir notificaciones
@azure repos subscriptions Agregar o quitar suscripciones para este canal
@azure repos signin Inicie sesión en su organización de Azure Repos
@azure repos signout Cierre la sesión de la organización de Azure Repos
@azure repos feedback Notificar un problema o sugerir una característica
@azure repos unsubscribe all [project url] Quitar todos los repositorios (que pertenecen a un proyecto) y sus suscripciones asociadas de un canal

Compatibilidad multiinquilino

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

Caso de uso Email id. + inquilino de Microsoft Teams identificador de Email + inquilino de Azure DevOps Pasos
1 email1@abc.com (inquilino 1) email1@abc.com (inquilino 1) Seleccione Iniciar sesión.
2 email1@abc.com (inquilino 1) email1@abc.com (inquilino 2) Inicie sesión en Azure DevOps. En el mismo explorador, inicie una nueva pestaña y vaya a https://teams.microsoft.com/. Ejecute el comando signin 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 y, a continuación, en el selector de identificadores de correo electrónico, use el correo electrónico2 para iniciar sesión en Azure DevOps.
4 email1@abc.com (inquilino 1) email2@pqr.com (inquilino no predeterminado 3) Este escenario no se admite.

Solución de problemas

Si experimenta los siguientes errores al usar la aplicación de Azure Repos, siga los procedimientos de esta sección.

Algo ha ido mal. Inténtelo de nuevo.

La aplicación Azure Repos usa el protocolo de autenticación de OAuth y requiere que se habilite el acceso de aplicaciones de terceros a través de OAuth para que la organización esté habilitada. Para habilitar esta configuración, vaya a Directivas deseguridad>de configuración> de la organización y establezca el acceso a la aplicación de terceros a través de OAuth para la configuración de la organización en Activado.

Habilitación del acceso a la aplicación de terceros a través de OAuth para la configuración de la organización

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

Cierre sesión en Azure DevOps; para ello, vaya a https://aka.ms/VsSignout mediante el explorador.

Abra una ventana del explorador En privado o de incógnito y vaya a https://aex.dev.azure.com/me e inicie sesión. En la lista desplegable del icono de perfil de la izquierda, seleccione el directorio que contiene la organización que contiene el repositorio al que desea suscribirse.

Seleccione el directorio que contiene la organización que contiene el proyecto.

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

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 elegido en el paso anterior. Acepte y complete el proceso de inicio de sesión.

Consentimiento de los permisos de aplicación solicitados

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