# GitHub

Conecte GitHub una vez y cada <Term id="project">proyecto</Term> de su <Term id="workspace">espacio de trabajo</Term> podrá vincular un repositorio. Cada envío puede <Term id="deploy">desplegar</Term> su aplicación.

<Screenshot src="/docs/_media/github-connector-cover.png" alt="Un proyecto que se despliega desde un repositorio de GitHub vinculado" />

## Antes de empezar [#antes-de-empezar]

<Callout type="warn" title="Solo propietarios y administradores">
  Solo los propietarios y administradores pueden conectar o desconectar GitHub. Los demás ven **Pida a un administrador que lo conecte** y usan los repositorios que conectó un administrador. Consulte [Miembros y roles](/docs/es/workspace/members).
</Callout>

- **Acceso en GitHub.** Permiso para instalar aplicaciones en la cuenta u organización de GitHub dueña de los repositorios.

## Conecte GitHub [#conecte-github]

<ForEveryone>
<Steps>
<Step>
### Inicie la conexión [#inicie-la-conexión]
Vaya a <AppLink to="connectors" />, abra **GitHub** y seleccione **Conectar**. También puede conectarlo desde <AppLink to="settings.connected-accounts" /> o desde la tarjeta para conectar GitHub en Inicio.
</Step>
<Step>
### Instale la aplicación de Klarety en GitHub [#instale-la-aplicación-de-klarety-en-github]
Elija la cuenta u organización y luego **solo los repositorios** de sus aplicaciones. Klarety solo ve esos.
</Step>
<Step>
### Compruebe que funcionó [#compruebe-que-funcionó]
De vuelta en Klarety, GitHub muestra **Conectado**. Los <Term id="studio">Studios</Term> ya pueden vincular un repositorio.
</Step>
</Steps>
</ForEveryone>

<ForDevelopers>
```python title="connect_github.py"
from klarety import Nexus

nx = Nexus.connect("YOUR_API_KEY")

if not nx.github.connected():
    print("Open this in a browser:", nx.github.install_url(return_to="/"))

print(nx.github.repositories())
```

`install_url` devuelve la página de GitHub que debe abrir; luego vuelve a `return_to`. `repositories()` lista los repositorios a los que Klarety tiene acceso.
</ForDevelopers>

## Vincule un repositorio a un proyecto [#vincule-un-repositorio-a-un-proyecto]

Un proyecto guarda su código en un repositorio y se despliega desde él.

<Steps>
<Step>
### Al crear el proyecto [#al-crear-el-proyecto]
En la sección para conectar GitHub, elija un repositorio o cree un **Nuevo repositorio**.
</Step>
<Step>
### O después, en el proyecto [#o-después-en-el-proyecto]
En la **Configuración** del proyecto, en **Despliegue**, **Código**, elija un **Repositorio**. Un Studio lo toma la próxima vez que se abra.
</Step>
<Step>
### Elija la rama que sale en vivo [#elija-la-rama-que-sale-en-vivo]
En **Despliega desde**, escriba una rama o déjelo vacío para la rama predeterminada. Lo que se fusione en ella sale en vivo. Seleccione **Guardar**.
</Step>
</Steps>

<Screenshot src="/docs/_media/github-connector-2.png" alt="Control de versiones en un Studio, con commits en el repositorio vinculado" />

### ¿No ve su repositorio? [#no-ve-su-repositorio]

Seleccione **¿No ve su repositorio?** para cambiar a qué repositorios accede Klarety, incluido uno nuevo. Volverá directamente al proyecto.

## Trabaje con el repositorio en el Studio [#trabaje-con-el-repositorio-en-el-studio]

Los commits que usted o la IA hagan en el Studio se envían al repositorio vinculado. Puede revisar los cambios lado a lado antes de que salgan en vivo.

<Screenshot src="/docs/_media/github-connector-1.png" alt="Comparación de dos versiones de un archivo en el Studio" />

Los envíos a la rama de despliegue inician un despliegue. Consulte [Despliegue su aplicación](/docs/es/deploy/deploy-an-app).

## Cambie el repositorio [#cambie-el-repositorio]

En la **Configuración** del proyecto, **Zona de peligro**, seleccione la opción para cambiar el repositorio. El proyecto guarda y sale en vivo desde el nuevo. El Studio lo abre en su próximo inicio y conserva el trabajo anterior en sus propias ramas. Para otra aplicación, cree un proyecto nuevo.

## Desconecte GitHub [#desconecte-github]

Abra GitHub en <AppLink to="connectors" />, abra las opciones junto a **Conectado** y seleccione **Desconectar**, luego confirme.

<Callout type="warn" title="Qué se detiene al desconectar">
  La aplicación de Klarety se quita de su organización de GitHub. Hasta reconectarla, los envíos no despliegan y los Studios no pueden enviar a GitHub. Sus repositorios y código no se tocan.
</Callout>

## Solución de problemas [#solución-de-problemas]

| Lo que ve | Qué hacer |
| --- | --- |
| **Pida a un administrador que lo conecte** | Usted no es propietario ni administrador. Pídale a uno que conecte GitHub. |
| **GitHub no está conectado** en la configuración del proyecto | Un administrador del espacio de trabajo lo conecta una sola vez para todos los proyectos. |
| No se pudo acceder a GitHub | Inténtelo de nuevo en un momento. |
| Un envío no despliega | Revise la rama de **Despliega desde** del proyecto y que GitHub siga **Conectado**. |

## Siguientes pasos [#siguientes-pasos]

- [Despliegue su aplicación](/docs/es/deploy/deploy-an-app)
- [Cómo funcionan los conectores](/docs/es/connectors)
- [Crear un proyecto](/docs/es/projects/create-a-project)