Configuración de una directiva de rama para un servicio externo

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Las directivas de rama son una característica eficaz para garantizar código de alta calidad en el repositorio mediante el establecimiento de requisitos para todas las solicitudes de extracción. Los servicios externos pueden usar la API de estado de pr para publicar el estado detallado en las solicitudes de solicitud. La directiva de rama para servicios externos ofrece la posibilidad de que esos servicios de terceros participen en el flujo de trabajo de la pr. y establezcan 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 la solicitud de cambio. Para obtener más información sobre el estado de la solicitud de solicitud de extracción, consulte Personalización y extensión de flujos de trabajo de solicitud de extracción con el estado de solicitud de extracción.

Requisitos previos

• Una organización de 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 ilimitados gratuitos.
• Un servicio que publica el estado en las PR. Consulte Creación de un servidor de estado de solicitud de extracción.

Configuración de la directiva de rama

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

   

2. Desplácese hacia abajo para buscar comprobaciones de estado. Haga clic en el botón +.

   

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

   

   • El requisito de directiva determina si esta directiva es opcional o necesaria para completar las solicitudes de extracción en la rama.
   • La identidad autorizada se usa para exigir que el estado de solo la identidad especificada se cuente 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 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 directiva se aplica en cuanto se crea una solicitud de extracción, o si la directiva se aplica solo después de que el primer estado se publique en la solicitud de extracción.
   • 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 extracción en la rama donde se define la directiva. Para más información, consulte Creación de una solicitud de extracción.

2. Después de crear la pr, la nueva directiva aparecerá en la sección Directivas de la vista de detalles de la pr. 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 cambio.

   

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

   

Resumen

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