Azure Repos con Slack
Azure DevOps Services
Si usa Slack, puede usar la aplicación Azure Repos para Slack para supervisar fácilmente los repositorios de Azure Repos. Puede configurar y administrar suscripciones para recibir notificaciones en el canal siempre que se inserte o registre el código y cada vez que se crea, actualiza o se intenta combinar una solicitud de incorporación de cambios (PR). Esta aplicación admite eventos de Git y Control de versiones de Team Foundation (TFVC).
Lea este artículo para obtener información sobre cómo:
- Añadir la aplicación Azure Repos al área de trabajo Slack
- Conexión de Azure Repos aplicación a los repositorios
- Administración de suscripciones a eventos relacionados con el repositorio en el canal de Slack
- Usar filtros de forma eficaz para personalizar las suscripciones
- Obtener notificaciones en canales privados de Slack
Requisitos previos
- Para crear suscripciones en un canal de Slack para eventos relacionados con el repositorio, debe ser miembro del grupo Administradores de proyectos o administrador de equipo. Para agregarlo, vea Cambio de permisos de nivel de proyecto o Incorporación de un administrador de equipo.
- Para recibir notificaciones, el acceso a la aplicación de terceros a través de la configuración de OAuth debe estar habilitado para la organización. 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 de Azure Repos para Slack a un proyecto hospedado en Azure DevOps Services en este momento.
Añadir la aplicación Azure Repos al área de trabajo Slack
Vaya a la aplicación de Slack Azure Repos para instalar la aplicación Azure Repos en el área de trabajo de Slack.
Una vez agregado, verá un mensaje de bienvenida de la aplicación, como se muestra en la siguiente imagen.
Use el identificador de Slack
/azrepos
para interactuar con la aplicación. Se proporciona una lista completa de comandos en la sección Referencia de comandos de este artículo.
Conexión de la aplicación Azure Repos a los repositorios
Una vez instalada la aplicación en el área de trabajo de Slack, conéctese y autentíquese para Azure Repos mediante
/azrepos signin
el comando .Para empezar a supervisar todos los repositorios de Git de un proyecto, use el siguiente comando de barra diagonal dentro de un canal:
/azrepos subscribe [project url]
La dirección URL del proyecto puede estar en cualquier página del proyecto (excepto las direcciones URL de los repositorios).
Por ejemplo:
/azrepos subscribe https://dev.azure.com/myorg/myproject/
También puede supervisar un repositorio específico mediante el siguiente comando:
/azrepos subscribe [repository url]
La dirección URL del repositorio puede ser en cualquier página del repositorio que tenga el nombre del repositorio.
Por ejemplo, para repositorios de Git, use:
/azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository
Para los repositorios de TFVC, use:
/azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl
Nota:
Solo puede suscribirse a repositorios públicos.
El comando subscribe le ayudará a empezar con 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 = master) y, para los repositorios TFVC, el canal se suscribe al evento Código protegido.
Administrar suscripciones
Para ver, agregar y quitar suscripciones para un canal, use el comando subscriptions
:
/azrepos subscriptions
Este comando enumera todas las suscripciones actuales para el canal y permite agregar nuevas suscripciones o quitar las existentes. Al agregar suscripciones, puede personalizar las notificaciones que obtiene mediante 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.
Usar filtros de forma eficaz para personalizar las suscripciones
Cuando un usuario se suscribe a un repositorio mediante /azrepos subscribe
el comando , se crea una suscripción predeterminada. A menudo, los usuarios tienen la necesidad de personalizar estas suscripciones. Por ejemplo, es posible que los usuarios quieran recibir notificaciones solo cuando las solicitudes de incorporación de cambios tengan un revisor específico.
En los pasos siguientes se muestra cómo personalizar las suscripciones.
- Ejecute el comando
/azrepos subscriptions
. - En la lista de suscripciones, si hay una suscripción no deseada o que se debe modificar (ejemplo: crear ruido en el canal), seleccione el botón Quitar .
- Seleccione el botón Agregar suscripción.
- Seleccione el repositorio necesario y el evento deseado.
- Seleccione los filtros adecuados para personalizar la suscripción.
Ejemplo: Obtener notificaciones solo cuando mi equipo está en la lista de revisores de una solicitud de incorporación de cambios
Ejemplo: Dígame cuándo se produce un error en los intentos de combinación debido a una infracción de directiva
Nota:
- Todos los filtros suelen ser listas desplegables. Sin embargo, si la lista desplegable tenía más de 100 elementos, se pide a los usuarios que escriban los valores manualmente.
- Para el evento Código insertado en el repositorio de TFVC, el filtro Bajo la ruta debe tener el formato
$/myproject/path
.
Vistas previas de las direcciones URL de la solicitud de incorporación de cambios
Cuando un usuario pega la dirección URL de una solicitud de incorporación de cambios, se muestra una vista previa como la de la imagen siguiente. Esto ayuda a mantener conversaciones relacionadas con pr contextuales y precisas.
Para que esta característica funcione, los usuarios deben iniciar sesión. Una vez que hayan iniciado sesión, esta característica funcionará para todos los canales de un área de trabajo.
Eliminación de suscripciones y repositorios de un canal
Muchas veces, los usuarios quieren limpiar su canal quitando repositorios y suscripciones. Use el comando siguiente para lograr lo mismo.
/azrepos unsubscribe all [project url]
Por ejemplo:
/azrepos unsubscribe all https://dev.azure.com/myorg/myproject
Este comando eliminará todas las suscripciones relacionadas con cualquier repositorio del proyecto y quitará los repositorios del canal. Solo los administradores del proyecto pueden ejecutar este comando.
Referencia de comandos
En la tabla siguiente se enumeran todos los /azrepos commands
elementos que puede usar en el canal de Slack.
Comando de Slash | Funcionalidad |
---|---|
/azrepos subscribe [repository url/ project url] | Suscribirse a un repositorio o a todos los repositorios de un proyecto para recibir notificaciones |
/azrepos subscriptions | Agregar o quitar suscripciones de este canal |
/azrepos signin | Iniciar sesión en la organización de Azure Repos. |
/azrepos signout | Cerrar sesión de la organización de Azure Repos. |
/azrepos feedback | Notificar un problema o sugerir una característica |
/azrepos cancela la suscripción a todas las [dirección URL del proyecto] | Quitar todos los repositorios (que pertenecen a un proyecto) y sus suscripciones asociadas de un canal |
Notificaciones en canales privados
La aplicación Azure Repos también puede ayudarle a supervisar los eventos del repositorio en los canales privados. Deberá invitar el bot al canal privado mediante /invite @azrepos
. Después, puede configurar y administrar las notificaciones de la misma manera que lo haría para un canal público.
Solución de problemas
Si experimenta los siguientes errores al usar la aplicación Azure Repos para Slack, 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, inicie una nueva pestaña, vaya a https://slack.com
, e inicie sesión en el área de trabajo (use el cliente web). Ejecute el comando /azrepos signout
seguido del comando /azrepos signin
.
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.
Artículos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de