Compartir vía


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

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.

    Selección de Directivas de rama en el menú contextual

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

    Selección del botón Agregar directiva

  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.

    Selección de la directiva de la lista

    • 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.

    Estado de la directiva visible en la sección Directivas

    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.

    Actualizaciones del estado de la directiva

    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.

    Estado de la directiva aprobado y finalización desbloqueada

Resumen

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