> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-es/configuracion/integraciones-con-git/conectar-un-repositorio-de-github.md).
# 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.
{% hint style="info" %}
#### 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.
{% endhint %}
## Requisitos previos de GitHub
{% stepper %}
{% step %}
### 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.
{% endstep %}
{% step %}
### Token de acceso personal - Clásico
{% hint style="info" %}
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.
{% endhint %}
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.
{% endstep %}
{% step %}
### Token de acceso personal - De granularidad fina
{% hint style="info" %}
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.
{% endhint %}
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.
{% hint style="info" %}
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.
{% endhint %}
10. Haga clic en el **Seleccionar repositorios** menú desplegable y marque todos los repositorios que incluir con este token.
11. En **Permisos**, haga clic en **Agregar permisos** para agregar cada uno de los permisos de la tabla a continuación.
12. 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 |
{% hint style="info" %}
El **Metadatos** permiso se agrega automáticamente cuando se agrega otro permiso.
{% endhint %}
13. Haga clic en **Generar token**.
14. Revise la configuración del token en el cuadro de confirmación y haga clic en **Generar token**.
15. Copie el token y guárdelo de forma segura. Necesitará este token al conectar DevOps con su cuenta de GitHub.
{% endstep %}
{% endstepper %}
## Conectar DevOps con GitHub
{% stepper %}
{% step %}
### 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.
{% endstep %}
{% step %}
### 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.
{% hint style="info" %}
#### 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}`
{% endhint %}
4. En el **Nombre de usuario** cuadro de texto, introduzca el nombre de usuario de GitHub con el que está conectando esta integración.
5. En el **Token** cuadro de texto, introduzca el token de acceso personal de GitHub que creó en la sección anterior.
6. En el **Nombre del repositorio** cuadro de texto, introduzca el nombre del repositorio de GitHub al que se está conectando.
7. Haga clic en **Conectar**.
8. 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**.
{% hint style="warning" %}
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.
{% endhint %}
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.flosum.com/devops/devops-es/configuracion/integraciones-con-git/conectar-un-repositorio-de-github.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
