Ctrlk
Atención al cliente
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Conectar un repositorio de GitHub

Resumen

Este artículo le muestra cómo conectar su repositorio de GitHub a DevOps para que los metadatos de Salesforce administrados en las ramas de DevOps se sincronicen automáticamente con su repositorio de GitHub. Esto garantiza que sus ramas, commits y solicitudes de extracción se rastreen completamente en su sistema de control de versiones basado en Git.

Tokens de acceso personal de GitHub

DevOps se conecta a un repositorio de GitHub mediante un token de acceso personal. Puede usar ya sea un Clásico token o un De granularidad fina token, según los requisitos de su empresa. Las instrucciones a continuación cubren ambos métodos, pero solo necesita crear un tipo de token.

Requisitos previos de GitHub

1

Repositorio

La integración de DevOps con GitHub sincroniza todas las ramas, commits y solicitudes de extracción con un único repositorio de GitHub. Este repositorio puede ser público o privado y puede pertenecer a una organización o a un usuario individual.

La captura de pantalla a continuación muestra un repositorio privado flosum-devops-example que forma parte de la Flosum-Example organización.

2

Token de acceso personal - Clásico

Un Clásico token se aplica a todos los repositorios a los que puede acceder su cuenta de GitHub y solo necesita dos alcances. Las siguientes instrucciones explican cómo crear uno.

  1. Inicie sesión en su cuenta de GitHub.

  2. Haga clic en la imagen de su perfil en la esquina superior derecha para abrir el menú desplegable.

  3. Haga clic en Configuración.

  4. Acceso Configuración de desarrollador > Tokens de acceso personal > Tokens (clásicos).

  5. Haga clic en el Generar nuevo token menú desplegable.

  6. Haga clic en Generar nuevo token (clásico).

  7. Introduzca una descripción del token en el Nota cuadro de texto.

  8. Haga clic en el Expiración menú desplegable y seleccione la fecha en la que desea que expire el token.

  9. Seleccione lo siguiente Ámbitos:

    1. repo

    2. workflow

  10. Haga clic en Generar token en la parte inferior de la página.

  11. Copie el token y guárdelo de forma segura. Necesitará este token al conectar DevOps con su cuenta de GitHub.

3

Token de acceso personal - De granularidad fina

Un De granularidad fina el token se limita a los repositorios y permisos que seleccione, por lo que le da a DevOps un acceso más restringido que un Clásico token. Las siguientes instrucciones explican cómo crear uno.

  1. Inicie sesión en su cuenta de GitHub.

  2. Haga clic en la imagen de su perfil en la esquina superior derecha para abrir el menú desplegable.

  3. Haga clic en Configuración.

  4. Acceso Configuración de desarrollador > Tokens de acceso personal > Tokens de granularidad fina.

  5. Haga clic en Generar nuevo token.

  6. Introduzca un nombre para el token en el Nombre del token cuadro de texto.

  7. Haga clic en el Propietario del recurso menú desplegable y seleccione el usuario u organización propietaria del repositorio para el que es este token.

  8. Haga clic en el Expiración menú desplegable y seleccione la fecha en la que desea que expire el token.

  9. En Acceso al repositorio, seleccione Seleccionar solo repositorios para limitar el alcance de este token solo a los repositorios que seleccione.

También puede seleccionar Todos los repositorios, pero entonces el token tendrá acceso a cualquier nuevo repositorio agregado a la Propietario del recurso.

No seleccione Repositorios públicos. Esta opción otorga acceso de solo lectura, y la integración de DevOps con GitHub requiere permisos de lectura y escritura.

  1. Haga clic en el Seleccionar repositorios menú desplegable y marque todos los repositorios que incluir con este token.

  2. En Permisos, haga clic en Agregar permisos para agregar cada uno de los permisos de la tabla a continuación.

  3. Configure el Acceso menú desplegable de cada permiso para que coincida con la columna Acceso de la tabla siguiente.

Permiso
Acceso

Administración

Lectura y escritura

Contenido

Lectura y escritura

Metadatos

Solo lectura

Webhooks

Lectura y escritura

El Metadatos permiso se agrega automáticamente cuando se agrega otro permiso.

  1. Haga clic en Generar token.

  2. Revise la configuración del token en el cuadro de confirmación y haga clic en Generar token.

  3. Copie el token y guárdelo de forma segura. Necesitará este token al conectar DevOps con su cuenta de GitHub.

Conectar DevOps con GitHub

1

Acceder a la configuración de integración de Git

  1. Haga clic en Integración de Git en la Configuración sección del menú de la barra lateral izquierda.

  2. Haga clic en el Configuración pestaña.

2

Conectar GitHub

  1. Haga clic en el Tipo de servicio menú desplegable.

  2. Seleccione GitHub.

  3. En el Organización cuadro de texto, introduzca el nombre de la organización de GitHub propietaria del repositorio al que se está conectando. Déjelo en blanco si se conecta a un repositorio propiedad de su cuenta de usuario de GitHub.

Ruta del repositorio

La ruta del repositorio de GitHub a la que la integración intenta conectarse depende de si el Organización campo tiene un valor.

Si el Organización campo tiene un valor, la ruta del repositorio es:

  • github.com/{Organization}/{Repository name}

Si el Organización campo está en blanco, la ruta del repositorio es:

  • github.com/{Username}/{Repository name}

  1. En el Nombre de usuario cuadro de texto, introduzca el nombre de usuario de GitHub con el que está conectando esta integración.

  2. En el Token cuadro de texto, introduzca el token de acceso personal de GitHub que creó en la sección anterior.

  3. En el Nombre del repositorio cuadro de texto, introduzca el nombre del repositorio de GitHub al que se está conectando.

  4. Haga clic en Conectar.

  5. Si la integración de Git se conecta correctamente a su repositorio de GitHub, aparece un mensaje de éxito. La GitHub conexión entonces enumera la organización y muestra su estado como Conectado.

Si la conexión de integración de Git falla, revise el mensaje de error para determinar la causa. Una vez corregido, intente conectarse de nuevo.

3

Sincronización de GitHub

Una vez conectado, todas las ramas de DevOps comenzarán a sincronizarse con el repositorio de GitHub. Puede comprobar el progreso de la sincronización en la Actividades pestaña.

4

Repositorio de GitHub

La captura de pantalla a continuación muestra un ejemplo de un repositorio de GitHub que está conectado y sincronizado con DevOps.

AnteriorInformación general de las integraciones con Git
SiguienteVer la actividad de sincronización de Git

Última actualización

¿Te fue útil?