Conexión de Azure DevOps Server a GitHub (en el entorno local)

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Requisitos previos

• Integración con GitHub:
  • Para conectarse a repositorios de GitHub.com, instale Azure DevOps Server 2020.1.1, revisión 2. Sin esta revisión, solo podrá conectarse a los repositorios de GitHub Enterprise Server.
  • Instalar la aplicación Azure Boards para GitHub en las organizaciones o la cuenta de GitHub.
• Conexión de proyecto: conéctese a un proyecto de Azure Boards o Azure DevOps. Si todavía no tiene un proyecto, cree uno.
• Permisos:
  • Ser miembro del grupo Administradores de colecciones de proyectos y del grupo Colaboradores del proyecto. Si ha creado el proyecto, tiene permisos.
  • Ser administrador del servidor de GitHub Enterprise al que se conecta.

Opciones de autenticación

Entre las opciones de autenticación disponibles se admiten las siguientes.

Conexión de Azure DevOps Server a GitHub Enterprise Server

1. Abra el portal web de Azure DevOps Server.

2. Seleccione el logotipo de Azure DevOps para abrir Proyectos y, a continuación, elija el proyecto de Azure Boards que desea configurar para conectarse a los repositorios de GitHub Enterprise.

Conectarse con un token de acceso personal

1. Para crear un PAT, consulte Creación de un token de acceso personal.

   Sugerencia

   Al crear el PAT de GitHub, asegúrese de que incluye estos ámbitos: repo, admin:repo_hook, read:user, user:email.

2. Escriba la dirección URL del servidor de GitHub Enterprise y las credenciales del token de acceso personal reconocidas por ese servidor. Y, a continuación, seleccione Conectar.

Conectar con nombre de usuario y contraseña

1. Escriba la dirección URL del servidor de GitHub Enterprise y las credenciales de la cuenta de administrador reconocidas por ese servidor. A continuación, seleccione Conectar.

2. En el cuadro de diálogo se enumeran todos los repositorios para los que tiene derechos de administración de GitHub. Puede alternar entre Míos y Todos para determinar si aparecen otros y, a continuación, comprobar los que desea agregar. Seleccione Guardar cuando haya terminado.

   

3. Para conectarse a una cuenta u organización de GitHub desde Azure Boards por primera vez, también debe instalar la aplicación Azure Boards para GitHub. Complete la integración siguiendo los procedimientos que se indican en Confirmación de la conexión.

Solución de problemas de conexión

La integración de Azure Boards y GitHub se basa en varios protocolos de autenticación para admitir la conexión. Los cambios en el ámbito de permisos o las credenciales de autenticación de un usuario pueden provocar la revocación de los repositorios de GitHub conectados a Azure Boards.

Para información general sobre la integración que admite la aplicación Azure Boards para GitHub, consulte Integración de Azure Boards con GitHub.

Opciones de autenticación admitidas

Las siguientes opciones de autenticación se admiten en función de la plataforma de GitHub a la que desea conectarse.

Plataforma

GitHub.com

Servidor de GitHub Enterprise

Azure DevOps Services

• Cuenta de usuario de GitHub.com
• Un token de acceso personal (PAT)

• OAuth
• PAT
• Nombre de usuario más contraseña

Azure DevOps Server 2020

No aplicable

• PAT
• Nombre de usuario más contraseña

Azure DevOps Server 2019

No aplicable

• OAuth
• PAT
• Nombre de usuario más contraseña

Nota:

Con la aplicación Azure Boards para GitHub, Azure Boards y Azure DevOps Services se integran con repositorios de GitHub.com y GitHub Enterprise Server. Azure DevOps Server 2019 y versiones posteriores admiten la integración solo con repositorios de GitHub Enterprise Server. No se admite la integración con otros repositorios de Git.

Resolución de problemas de acceso

Cuando la conexión de Azure Boards a GitHub ya no tiene acceso, muestra un estado de alerta en la interfaz de usuario con una X roja. Mantenga el puntero sobre la alerta e indicará que las credenciales ya no son válidas. Para corregir el problema, quite la conexión y vuelva a crear una nueva.

Considere las siguientes soluciones:

• Si la conexión usa OAuth:

  • La aplicación Azure Boards tenía denegado su acceso para uno de los repositorios.

  • GitHub podría no estar disponible o no accesible. Esta falta de disponibilidad podría deberse a una interrupción en el servicio o un problema de infraestructura o red en el entorno local. Puede comprobar el estado del servicio en los vínculos siguientes:

    • GitHub
    • Azure DevOps

    Elimine la conexión con el repositorio de GitHub y vuélvala a crear. Esta conexión recién creada hace que GitHub pida que vuelva a autorizar Azure Boards.

• Si la conexión usa un PAT:

  • Es posible que se revoque el PAT o que se cambien los ámbitos de permisos necesarios y que sean insuficientes.

  • El usuario quizá perdió permisos administrativos en el repositorio de GitHub.

    Vuelva a crear el PAT y asegúrese de que el ámbito del token incluye los permisos necesarios: repo, read:user, user:email, admin:repo_hook.

Actualización de las definiciones XML para tipos de elementos de trabajo elegidos

Si su organización personaliza el seguimiento del trabajo mediante el modelo de proceso XML hospedado o XML local y quiere integrar tipos de vínculo de GitHub en la sección Desarrollo de formularios de elementos de trabajo, debe actualizar las definiciones XML para los tipos de elementos de trabajo correspondientes.

Por ejemplo, para vincular casos de usuario y errores a confirmaciones y solicitudes de incorporación de cambios en la sección Desarrollo de formularios de elementos de trabajo, debe actualizar las definiciones XML de estos tipos de elementos de trabajo.

Para modificar las definiciones XML, realice los pasos descritos en Modelo de proceso XML hospedado. Para cada tipo de elemento de trabajo:

1. Localice la sección Group Label="Development".
2. Para admitir los tipos de vínculo externo, la confirmación de GitHub y la solicitud de incorporación de cambios de GitHub, agregue las siguientes líneas de código:

Esta integración permite realizar un seguimiento sin problemas de las actividades de GitHub directamente desde los elementos de trabajo de Azure Boards.

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  

Cuando se actualiza, la sección debe aparecer como se muestra a continuación.

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>  

Pasos siguientes

Vínculo de confirmaciones y solicitudes de incorporación de cambios de GitHub a los elementos de trabajo

Artículos relacionados

• ¿Obtenga información sobre Azure Boards?
• Solución de problemas de la integración entre GitHub y Azure Boards
• Compilación de repositorios de GitHub Enterprise Server