Configurar una directiva de rama para un servicio externo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Las directivas de rama son una característica eficaz para garantizar un código de alta calidad en el repositorio mediante el establecimiento de requisitos para todas las solicitudes de incorporación de cambios. Los servicios externos pueden usar la API de estado de solicitud de incorporación de cambios para publicar un estado detallado de las solicitudes de incorporación de cambios. La directiva de rama para servicios externos ofrece la posibilidad a esos servicios de terceros de participar en el flujo de trabajo de las solicitudes de incorporación de cambios y establecer requisitos de directiva. Este artículo le guía por el proceso de configuración de una directiva de rama para un servicio que publica el estado de una solicitud de incorporación de cambios. Para obtener más información sobre el estado de una solicitud de incorporación de cambios, consulte Personalización y ampliación de los flujos de trabajo de solicitud de incorporación de cambios con el estado de solicitud de incorporación de cambios.

Requisitos previos

• Una organización en Azure DevOps con un repositorio de Git. Si no tiene una organización, regístrese para cargar y compartir código en repositorios de Git privados gratuitos e ilimitados.
• Un servicio que envía el estado a las solicitudes de incorporación de cambios. Consulte Creación de un servidor de estado de solicitud de incorporación de cambios.

Configuración de la directiva de rama

1. Vaya a Código>Ramas y busque la rama en la que quiere configurar la directiva (normalmente main o develop). En el menú contextual, seleccione la opción Directivas de rama.

   

2. Desplácese hacia abajo hasta encontrar Comprobaciones de estado. Haga clic en el botón +.

   

3. Seleccione el servicio para el que quiere crear una directiva en la lista. Si el estado se ha publicado anteriormente, puede elegirlo de la lista; si se trata de una directiva nueva, puede escribir su nombre.

   

   • El requisito de directiva determina si esta directiva es opcional o necesaria para completar las solicitudes de incorporación de cambios en la rama.
   • La identidad autorizada se usa para garantizar que solo el estado de la identidad especificada se contará para el cumplimiento de la directiva.
   • Las condiciones de restablecimiento se usan para determinar cuándo un estado publicado ya no es válido. Si el estado publicado es específico del código más reciente (es decir, una compilación), active Restablecer el estado cada vez que haya nuevos cambios para restablecer el estado cuando cambie la rama de origen.
   • Opcionalmente, establezca un filtro de ruta de acceso. Obtenga más información sobre los filtros de ruta de acceso en las directivas de rama.
   • La aplicabilidad de la directiva determina si esta se aplica tan pronto como se crea una PR o si se aplica solo después de que se publique el primer estado en la PR.
   • El nombre para mostrar predeterminado permite especificar un nombre para mostrar opcional para la directiva.

Creación de una nueva solicitud de incorporación de cambios

1. Cree una nueva solicitud de incorporación de cambios en la rama donde se define la directiva. Para obtener más información, consulte Creación de una solicitud de incorporación de cambios.

2. Después de crear la solicitud de incorporación de cambios, la nueva directiva aparecerá en la sección Directivas de la vista de detalles de la solicitud de incorporación de cambios. Inicialmente, la directiva aparecerá como no establecida hasta que el servicio externo haya publicado el estado.

   

   Cuando el servicio haya publicado el estado, la directiva se actualizará en consecuencia. La finalización se bloqueará hasta que la directiva apruebe la solicitud de incorporación de cambios.

   

   Cuando se cumplan los criterios de la directiva y el servicio publique un estado succeeded, se aprobará la solicitud de incorporación de cambios y se desbloqueará la finalización.

   

Resumen

En este artículo, ha aprendido a configurar una directiva de rama para un servicio externo.