Escribe al menos dos letras para buscar en todas las páginas de la documentación.

↑ ↓ para navegar ↵ para abrir esc para cerrar

Uso de rdev

Acceso a Git

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 work o personal.
  • Host: github.com, gitlab.com, bitbucket.org o el tuyo, con :port cuando 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].