Tu servidor clona y hace push de tus repositorios por sí mismo, así que necesita su propia vía de acceso a GitHub, GitLab, Bitbucket o tu propio servidor Git. Los repositorios públicos no necesitan nada. Para los privados, da al servidor una clave o un token una sola vez; a partir de entonces cada proyecto simplemente funciona.
Las claves y los tokens se quedan en tu servidor. rdev.cloud solo ve claves públicas, y un token que escribes en el panel se cifra en tu navegador para tu servidor antes de enviarse.
Tres formas de acceder
| Forma | Alcanza | Ideal para |
|---|---|---|
| Clave del servidor | Todos los repositorios que tu cuenta de Git puede abrir | Una cuenta personal |
| Cuentas | Los repositorios de los propietarios que indiques, cada una con su propia clave SSH o token | Varias cuentas, de trabajo y personales, otros hosts |
| Clave de despliegue | Un solo repositorio | El acceso más restringido, repositorios de clientes |
Cuando el servidor clona, elige la primera que encaja: la clave de despliegue del proyecto, luego una cuenta cuyo host y propietario coincidan con la URL, y luego la clave del servidor. Si se rechaza un clon por SSH y el repositorio es público, recurre a HTTPS. Cada clon recuerda cómo se abrió, así que git pull y git push siguen funcionando.
La clave del servidor
Abre el servidor en Servidores, ve a la pestaña Acceso y busca Acceso a Git. Elige Generar clave la primera vez, copia la clave y añádela a tu cuenta: GitHub, GitLab y Bitbucket tienen un botón cada uno que abre la página correcta. La misma clave sirve para hacer push, así que tu agente de IA también puede hacer push.
Desde la terminal del servidor:
rdev git key # print the key (made on first use)
rdev git key --rotate # make a new one; remove the old one from your hosts
Cuentas
Añade todas las cuentas que quieras: dos cuentas de GitHub, un GitLab de empresa, Bitbucket y un Gitea autoalojado, todos a la vez. Cada cuenta tiene:
- Nombre: corto, como
workopersonal. - Host:
github.com,gitlab.com,bitbucket.orgo el tuyo, con:portcuando SSH no está en el 22. - Propietarios: usuarios u organizaciones opcionales. Los repositorios que dependen de ellos usan esta cuenta; sin propietarios, lo hacen todos los repositorios del host.
- Clave SSH o token: una cuenta SSH recibe su propia clave para añadir en el host. Una cuenta con token clona por HTTPS con un token de acceso personal (token de grano fino de GitHub, token personal o de proyecto de GitLab, token de API de Bitbucket, PAT de Azure DevOps). GitLab espera el nombre de usuario
oauth2, Bitbucket tu correo.
En el panel elige Añadir cuenta. En la aplicación para portátil la misma lista está en la pestaña Integraciones. Desde la terminal:
rdev git account add work --host github.com --owner acme
echo "$TOKEN" | rdev git account add lab --host git.example.com --token --user oauth2
rdev git account list
rdev git account remove lab
Claves de despliegue
Una clave de despliegue abre un repositorio. En Claves de despliegue escribe el nombre del proyecto (un proyecto existente o el que vas a añadir) y elige Generar clave de despliegue, y luego añade la clave a las claves de despliegue del repositorio, con acceso de escritura si el agente debe hacer push. Al añadir el proyecto, marca Usar la clave de despliegue del proyecto, o ejecuta:
rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key
Confiar en un host
El servidor ya conoce las claves de GitHub, GitLab y Bitbucket. La primera vez que encuentra otro host no se conecta a ciegas: el host aparece en Hosts pendientes de confianza con su huella digital. Compárala con la que publica tu host de Git y elige Confiar, o ejecuta rdev git trust git.example.com --fingerprint SHA256:….
Probar el acceso
Antes de añadir un proyecto, pega su URL en Probar acceso. El servidor intenta leerlo y, si marcas Comprobar también que puede hacer push, hacer push sin cambiar nada. La respuesta indica qué clave o token usó, o qué hacer a continuación. Desde la terminal: rdev git test <url> [--write].