Conectar Azure Boards a GitHub (nube)

Azure BoardsAzure DevOps Server 2020 | Azure DevOps Server 2019

Para admitir la vinculación de GitHub y solicitudes de extracción Azure Boards elementos de trabajo, conecte el proyecto de Azure Boards GitHub.com. A continuación, use GitHub desarrollo de software mientras usa Azure Boards para planear y realizar un seguimiento del trabajo. Para obtener información general sobre la aplicación Azure Boards para GitHub, consulte Integración de Azure Boards-GitHub azure.

Al realizar la conexión desde Azure Boards, la lista de repositorios de GitHub corresponde a los que se permiten Azure Boards acceso. Puede limitar a qué repositorios Azure Boards pueden acceder en general y limitar a qué puede acceder un proyecto determinado o dividir la administración del trabajo entre diferentes Azure Boards proyectos.

Nota:

Azure Boards y Azure DevOps Services admiten la integración con repositorios de GitHub.com y GitHub Enterprise Server. Si desea conectarse desde un servidor local Azure DevOps Server, consulte Conectar Azure DevOps Server a GitHub Enterprise Server.

Requisitos previos

  • Conectar a un Azure Boards o Azure DevOps proyecto. Si aún no tiene un proyecto, cree uno.
  • Debe ser miembro del grupo Project administradores y del grupo Colaboradores del proyecto. Si creó el proyecto, tendrá permisos.
  • Debe ser administrador o propietario del repositorio GitHub al que se conectará. Puede conectarse a varios GitHub repositorios, siempre que sea administrador de esos repositorios.

Opciones de autenticación

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

GitHub.com

Servidor de GitHub Enterprise

Abra Project Configuración > GitHub conexiones.

  1. Inicie sesión Azure Boards el proyecto al que desea conectarse a GitHub repositorios.

  2. Elija (1) Project Configuración (2) GitHub conexiones.

    Captura de pantalla de las conexiones Project Configuración  GitHub abiertas.

  3. Si es la primera vez que realiza una conexión desde el proyecto, elija Conectar cuenta de GitHub para usar las credenciales de GitHub cuenta.

    Captura de pantalla de la primera vez que se conecta GitHub credenciales.

    En caso contrario, elija Nueva conexióny seleccione el método de autenticación en el cuadro de diálogo Nueva conexión.

    Cuando se conecta con su cuenta GitHub, usa las credenciales GitHub cuenta de usuario para autenticarse. Si se conecta mediante PAT, consulte Agregar una conexión GitHub mediante PAT. Si se conecta a un servidor GitHub Enterprise, consulte Registrar Azure DevOps en GitHub como una aplicación de OAuth.

Agregar una conexión GitHub con GitHub credenciales

Puede conectar hasta 250 repositorios de GitHub a un proyecto de Azure Boards.

  1. Si es la primera vez que se conecta a GitHub desde Azure Boards, se le pedirá que inicie sesión con sus GitHub credenciales. Elija una cuenta para la que sea administrador para los repositorios a los que desea conectarse.

  2. Si pertenece a más de una cuenta GitHub organización, elija el repositorio cuyos repositorios desea conectar. Solo se enumeran las organizaciones que posee o para las que es administrador.

    Captura de pantalla de la elección entre varias GitHub a las que conectarse.

    Si todos los repositorios de una organización ya se han conectado a Azure Boards, verá el mensaje siguiente.

    Captura de pantalla del mensaje donde no existen más repositorios para conectarse.

  3. Cuando se le pregunte, escriba GitHub credenciales.

    GitHub diálogo de inicio de sesión
    Si ha habilitado la autenticación en dos fases, escriba el código de autenticación GitHub le ha enviado y elija Comprobar.

    GitHub diálogo de autenticación en dos fases

    De lo contrario, el sistema reconocerá automáticamente GitHub organización, ya que la cuenta GitHub se ha asociado previamente a la cuenta Azure DevOps Services cuenta.

Elección de los repositorios

Una vez que se haya autenticado, puede seleccionar los repositorios que desea conectar.

  1. El cuadro GitHub de diálogo Agregar repositorios de GitHub.com muestra y selecciona automáticamente todos los repositorios de GitHub.com para los que sea administrador de la organización seleccionada. Anule la selección de los repositorios que no desee participar en la integración.

    Elija sus GitHub repositorios.

    Sugerencia

    Se recomienda conectar solo un repositorio de GitHub a los proyectos definidos en una sola Azure DevOps organización. La conexión del mismo repositorio de GitHub a proyectos definidos en dos o más organizaciones de Azure DevOps puede dar lugar a una vinculación de menciones AB# inesperada. Para más información, consulte Solución de GitHub Azure Boards integración.

    Si todos los repositorios ya se han conectado a la organización actual u otra, se muestra el mensaje siguiente.

    Captura de pantalla del mensaje donde no existen más repositorios para conectarse.

  2. Cuando haya terminado, elija Guardar.

Confirmación de la conexión

En este paso, instalará la aplicación Azure Boards para GitHub en la cuenta de GitHub u organización asociada a los repositorios a los que eligió conectarse.

  1. Revise la página GitHub que se muestra y, a continuación, elija Aprobar, Instalar, Autorizar.

    Confirmación de los GitHub repositorios

  2. Proporcione su GitHub contraseña para confirmar.

  3. Cuando haya terminado, debería ver la nueva conexión con los repositorios seleccionados en la lista.

    GitHub repositorios conectados

Para cambiar la configuración o administrar la aplicación Azure Boards para GitHub, consulte Cambio del acceso del repositorio a Azure Boards.

Adición de GitHub conexión mediante PAT

Se recomienda usar las credenciales de GitHub para conectarse al repositorio GitHub usuario. Sin embargo, si necesita usar un PAT, puede usarlo siguiendo estos procedimientos.

Sugerencia

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

  1. Para elegir un PAT al conectar un GitHub, elija Token de acceso personal al realizar una conexión por primera vez.

    Primera conexión, elija Token de acceso personal.

    O bien, en el cuadro de diálogo GitHub conexión.

    Nuevo GitHub de conexión, elija Token de acceso personal.

    Para crear un GitHub PAT, vaya a GitHub Developer Configuración Personal access tokens (Tokens de acceso personal).

  2. Escriba el PAT y elija Conectar.

    Escriba el PAT y elija Conectar.

  3. Elija los repositorios que desea conectar al proyecto siguiendo los procedimientos descritos en Elección de los repositorios anteriormente en este artículo.

  4. Si se conecta por primera vez a una cuenta u organización de GitHub desde Azure Boards, también instalará la aplicación Azure Boards para GitHub. Complete la integración siguiendo los procedimientos descritos en Confirmar la conexión anteriormente en este artículo.

Registro Azure DevOps en GitHub como una aplicación de OAuth

Si tiene previsto usar OAuth para conectarse Azure DevOps Services Azure DevOps Server con GitHub Enterprise Server, primero debe registrar la aplicación como una aplicación de OAuth. Para más información, consulte Creación de una aplicación de OAuth.

Registro Azure DevOps Services

  1. Inicie sesión en el portal web del GitHub Enterprise web.

    Inicio de sesión en GitHub Enterprise servidor

  2. Abra Configuración developer settings > Oauth Apps (Aplicaciones de Oauth) y >

    Abra Configuración  developer settings > Oauth Apps (Aplicaciones de Oauth) y elija New OAuth App (Nueva aplicación de OAuth).

  3. Rellene el formulario para registrar la Azure DevOps Server aplicación.

    En Dirección URL de la página principal,especifique la dirección URL de la organización.
    Para la dirección URL de devolución de llamada de autorización,use el siguiente patrón para construir la dirección URL.

    {Azure DevOps Services Organization URL}/_admin/oauth2/callback

    Por ejemplo:

    https://dev.azure.com/fabrikam/_admin/oauth2/callback

    Registro del Azure DevOps Server proyecto

  4. Elija Registrar aplicación.

  5. Si se completa correctamente, verá una página que proporciona el identificador de cliente y el secreto de cliente para la aplicación OAuth registrada.

    Identificador de cliente y secreto de cliente para la aplicación OAuth registrada.

Registre la configuración de OAuth en Azure DevOps Services

  1. Inicie sesión en el portal web para Azure DevOps Services.

  2. Agregue la GitHub Enterprise de Oauth a su organización.

  3. Abra Configuración de la organización Configuraciones de Oauthy, a continuación, elija Agregar configuración de Oauth.

    Abra la Configuración de organización, configuraciones de OAuth.

  4. Rellene el formulario que aparece y, a continuación, elija Crear.

    Cuadro de diálogo de configuraciones de OAuth.

Conectar Azure DevOps Services a GitHub Enterprise Server

Importante

Para conectar Azure DevOps Services a GitHub Enterprise Server, GitHub Enterprise Server debe ser lo suficientemente accesible desde Internet. Asegúrese de que Azure DNS puede resolver el nombre GitHub Enterprise Server y que el firewall permite el acceso desde las direcciones IP del Centro de datos de Azure. Para determinar el intervalo de direcciones IP, consulte Microsoft Azure Intervalos IP delcentro de datos . Un mensaje de error común encontrado cuando existen problemas de conectividad es:

No se pudo resolver el nombre remoto: "github-enterprise-server.contoso.com"

Si se produce este error, compruebe que el servidor es accesible. Para obtener más información, consulte Azure DNS preguntas más frecuentessobre .

  1. En la página Project Configuración GitHub, elija GitHub Enterprise Server, elija GitHub Enterprise Server al realizar una conexión de primera hora.

    Primera conexión, elija GitHub Enterprise Server.

    O bien, en el cuadro de diálogo GitHub conexión, elija GitHub Enterprise Server.

    Nuevo GitHub de conexión, elija GitHub Enterprise Servidor.

  2. Seleccione el método de autenticación.

    Cuadro de diálogo Seleccionar método de autenticación.

    Conectar con OAuth

    Elija la configuración que ha configurado en el paso 4 de Registro de la configuración de OAuthen Azure DevOps Services y, a continuación, elija Conectar.

    Nueva conexión GitHub Enterprise, cuadro de diálogo de conexión de OAuth

    Conectar un token de acceso personal

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

    Nueva conexión GitHub Enterprise, cuadro de diálogo Conexión de token de acceso personal

    Conectar un nombre de usuario y una contraseña

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

    Nueva conexión GitHub Enterprise usuario, cuadro de diálogo de conexión de nombre de usuario

    Elección de los repositorios a los que conectarse

  3. En el cuadro de diálogo se enumeran todos los repositorios para los que GitHub derechos de administración. Puede alternar entre Mineríay Todo para determinar si aparecen otros y, a continuación, comprobar los que desea agregar. Elija Guardar cuando haya terminado.

    Elija los repositorios que desea agregar.

    Sugerencia

    Solo puede establecer una conexión a repositorios definidos en una GitHub organización. Para conectar un proyecto a otros repositorios definidos en otra GitHub organización, debe agregar otra conexión.

  4. Si se conecta por primera vez a una cuenta u organización de GitHub desde Azure Boards, también instalará la aplicación Azure Boards para GitHub. Complete la integración siguiendo los procedimientos descritos en Confirmar la conexión anteriormente en este artículo.

Solución de problemas de conexión

Consulte Solución de GitHub conexión del repositorio.

Pruebe esto a continuación