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

Servicios de Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Sugerencia

Puede usar la inteligencia artificial para ayudar con las tareas de Azure DevOps. Consulte Habilitar la asistencia de IA con Azure DevOps MCP Server para comenzar.

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 PR para publicar el estado detallado en tus PRs. 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.

Prerrequisitos

Categoría Requisitos
Acceso al proyecto Miembro de un proyecto.
Permisos - Ver código en proyectos privados: al menos acceso básico.
- Clonar o contribuir al código en proyectos privados: ser miembro del grupo de seguridad Contribuidores o contar con los permisos correspondientes en el proyecto.
- Establecer permisos de rama o repositorio: administre permisos para la rama o el repositorio.
- Establezca directivas de rama, comprobaciones de estado o cambie la rama predeterminada: edite el permiso de directivas para el repositorio o rama o la pertenencia al grupo de seguridad administradores de Project.
- Importar un repositorio: miembro del grupo de seguridad de Administradores de proyecto o repositorio Git a nivel de proyecto Crear repositorio con la opción Permitir. Para obtener más información, consulte Establecimiento de permisos de repositorio de Git.
Servicios Repositorios habilitados.
Herramientas Optional. Uso de az repos comandos: CLI de Azure DevOps.
Categoría Requisitos
Acceso al proyecto Miembro de un proyecto.
Permisos - Ver código: al menos acceso básico.
- Clonar o contribuir al código: Miembro de la Colaboradores grupo de seguridad o los permisos correspondientes en el proyecto.
Servicios Repositorios habilitados.

Configura la directiva de sucursal

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

    Seleccione Directivas de rama en el menú contextual.

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

    Seleccione el botón Agregar directiva.

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

    Seleccione 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.
    • Identidad autorizada se utiliza para garantizar que solo el estado de la identidad especificada se tenga en cuenta a la hora de cumplir 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), compruebe Restablecer estado siempre que haya nuevos cambios para restablecer el estado cuando cambie la rama de origen.
    • Opcionalmente, establezca un filtro de ruta. Obtenga más información sobre los filtros de ruta en las directivas de ramificación.
    • La aplicabilidad de la directiva determina si esta directiva se aplica tan pronto como se crea una solicitud de incorporación de cambios, o si la directiva solo se aplica después de que el primer estado se publique en la solicitud de incorporación de cambios.
    • Nombre de visualización predeterminado te permite especificar un nombre de visualización opcional para tu directiva.

Crear una nueva solicitud de pull

  1. Cree un nuevo pull request 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.

    El estado de la directiva está visible en la sección Directivas

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

    Actualizaciones de 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 política de sucursal para un servicio externo.