Uso de Azure Repos con Microsoft Teams
Azure DevOps Services
Si usa Microsoft Teams y Azure Repos, puede usar la aplicación Azure Repos para Teams a fin de supervisar los repositorios. La aplicación admite la supervisión de repositorios de Git y de Control de versiones de Team Foundation (TFVC), pero no admite la integración con repositorios de GitHub.
En este artículo, descubrirá cómo realizar las tareas siguientes:
- Agregar la aplicación Azure Repos al equipo en Microsoft Teams
- Conexión de la aplicación Azure Repos a los repositorios
- Administrar suscripciones a eventos relacionados con el repositorio en el canal
- Buscar y compartir información de PR mediante la extensión de redacción
- Obtener una vista previa de las direcciones URL de PR
- Eliminar suscripciones y repositorios de un canal
Requisitos previos
- Administre la suscripción para recibir notificaciones en el canal cada vez que se envían cambios en el código o se inserta, o cuando se cree, actualice o fusione mediante combinación una PR. A fin de crear suscripciones para eventos relacionados con el repositorio, debe ser miembro del grupo Administradores de proyectos o de un administrador de equipo. Para agregarlo, vea Cambio de permisos de nivel de proyecto o Incorporación de un administrador de equipo.
- A fin de recibir notificaciones, habilite el acceso a la aplicación de terceros mediante la configuración de OAuth para la organización de Azure DevOps. Vea 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.
Incorporación de la aplicación Azure Repos a un equipo en Microsoft Teams
Vaya a la aplicación Azure Repos en Microsoft Teams, Microsoft Teams > Azure Repos.
Seleccione Agregar o, si ya ha descargado la aplicación, seleccione el menú desplegable situado junto a Abrir y, después, seleccione Agregar a un equipo.
Escriba un nombre de equipo o canal y, después, seleccione Configurar un bot.
Conexión de la aplicación Azure Repos a los repositorios
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 diferentes inquilinos, seleccione Sign in with different email (Iniciar sesión con un correo electrónico diferente).
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 estar 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 estar 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 los repositorios de TFVC,@azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.El comando
subscribele ayudará a empezar con una suscripción predeterminada. En el caso de los repositorios de Git, el canal se suscribe al evento PR creada (con la rama de destino = principal). En el caso de los repositorios de TFVC, el canal se suscribe al evento Código insertado en el repositorio.
Administrar suscripciones
A fin de ver, agregar y quitar suscripciones para un canal, escriba el texto siguiente: @azure repos subscriptions.
Verá una lista de todas las suscripciones actuales para el canal y podrá agregar nuevas suscripciones o quitar las existentes. Personalice las notificaciones con varios filtros, tal como se describe en la sección siguiente.
Nota:
Los administradores del equipo no pueden quitar ni modificar suscripciones que hayan creado los administradores del proyecto.
Uso de filtros para obtener solo las notificaciones que se quieran
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 PR.
Escriba el texto siguiente en el canal:
@azure repos subscriptions.En la lista de suscripciones, si hay una suscripción que no quiere o que debe modificarse, seleccione Quitar para eliminarla.
Seleccione el botón Agregar suscripción.
Elija un tipo de evento y, después, seleccione Siguiente.
Elija un repositorio y, después, seleccione Siguiente.
Seleccione los filtros adecuados para personalizar la suscripción y, después, seleccione Enviar.
Nota:
- Todos los filtros suelen ser listas desplegables. Pero si la lista desplegable tiene más de 100 elementos, tendrá que escribir manualmente los valores.
- Para el evento Código insertado en el repositorio de TFVC, el filtro Bajo la ruta debe tener el formato
$/myproject/path.
Búsqueda y uso compartido de información de PR mediante la extensión de redacción
Para ayudar a los usuarios a buscar y compartir información sobre las PR, la aplicación Azure Repos para Microsoft Teams admite una extensión de redacción. Puede buscar PR por id. o por 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.
Vista previa de las direcciones URL de PR
Al pegar la dirección URL de una PR, se muestra una vista previa como la de la imagen siguiente, lo que ayuda a mantener el contexto y la precisión de las conversaciones relacionadas con PR. Debe iniciar sesión y, después, puede obtener una vista previa de las PR de las direcciones URL de todos los canales de un equipo.
Eliminar 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 de subproceso
Para vincular un conjunto de notificaciones relacionadas y también para reducir el espacio que ocupan las notificaciones en un canal, las notificaciones se subprocesan. Todas las notificaciones vinculadas a una PR determinada están vinculadas juntas.
Vista compacta de las notificaciones de subproceso
Vista expandida de las notificaciones de subproceso
Referencia de comandos
En la tabla siguiente se muestran todos los comandos azure repos que puede usar en el canal de Teams.
| Comando | 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 de este canal. |
@azure repos signin |
Iniciar sesión en la organización de Azure Repos. |
@azure repos signout |
Cerrar 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 a fin de iniciar sesión, en función del caso de uso.
| Caso de uso | Id. de correo electrónico + inquilino de Microsoft Teams | Id. de correo electrónico + 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 de inicio de sesión y seleccione Iniciar sesión. |
| 3 | email1@abc.com (inquilino 1) | email2@pqr.com (inquilino 2) | Seleccione Sign in with different email address (Iniciar sesión con una dirección de correo electrónico diferente) y, después, en el selector de id. de correo electrónico, use el correo electrónico 2 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 errores siguientes al usar la aplicación de Azure Repos, siga los procedimientos de esta sección.
- Algo ha ido mal. Inténtelo de nuevo.
- Error de configuración. Asegúrese de que la organización "{nombre de la organización}" existe y que tiene permisos suficientes.
Algo ha ido mal. Inténtelo de nuevo.
La aplicación Azure Repos usa el protocolo de autenticación de OAuth y requiere que la opción Third-party application access via OAuth for the organization (Acceso a aplicaciones de terceros mediante OAuth para la organización) esté habilitada. Para habilitar esta configuración, vaya a Configuración de la organización>Seguridad>Directivas y establezca la configuración de Third-party application access via OAuth for the organization (Acceso a aplicaciones de terceros mediante OAuth para la organización) en Activado.
Error de configuración. Asegúrese de que la organización "{nombre de la organización}" existe y que tiene permisos suficientes.
Cierre la sesión en Azure DevOps; para ello, vaya a https://aka.ms/VsSignout mediante el explorador.
Abra una ventana del explorador Privada o en modo Incógnito, vaya a https://aex.dev.azure.com/me e inicie sesión. En la lista desplegable del icono de perfil situado a la izquierda, seleccione el directorio que incluye la organización que contiene el repositorio al que quiere suscribirse.
En el mismo explorador, abra una nueva pestaña e inicie sesión en https://teams.microsoft.com/. Ejecute el comando @Azure Repos signout y, después, ejecute el comando @Azure Repos signin en el canal donde está instalada la aplicación Azure Repos para Microsoft Teams.
Seleccione el botón Sign in 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 seleccionado 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.