ECLOUD / 07
Conecta GitHub por SSH y prepara tus módulos
Organiza el código, configura el acceso y verifica que tus cambios llegaron al repositorio correcto.
- Tu equipo
- Repositorio Git
- AppCloud en pruebas
Las flechas señalan controles reales. Puedes ampliar cada detalle. Los nombres y opciones pueden variar según la versión y los permisos de tu cuenta.
Entiende qué vas a conectar
Git guarda el historial de cambios del código. GitHub aloja el repositorio, una carpeta de proyecto con ese historial. SSH permite autenticar tu equipo mediante una clave privada y una pública.
Este procedimiento corresponde al responsable autorizado del código. No es necesario para quien solo usa Odoo. Necesitas Git, OpenSSH, tu cuenta GitHub y permiso sobre el repositorio.
Permission denied (publickey); después se utiliza GitHub CLI con HTTPS.Primero autentica tu equipo con SSH y verifica el acceso. Después sube el código. El acceso del panel AppCloud al repositorio se configura por separado.
01 · Prepara una clave sin sobrescribir otras
Ejemplo en Terminal Linux; en Windows usa Git Bash. Comprueba primero git --version y ssh -V. Si faltan, pide instalarlos desde los canales oficiales.
- Revisa tus claves existentes con
ls -la ~/.ssh. Si ya existe una clave autorizada, consulta antes de crear otra. - Para una clave nueva, ejecuta el ejemplo cambiando el correo por el tuyo. No sobrescribas archivos existentes.
- Cuando pregunte dónde guardarla, utiliza una ruta nueva si la predeterminada ya está ocupada. Añade una frase de protección.
- Carga la clave privada en el agente; si elegiste otro nombre, adapta la ruta.
ssh-keygen -t ed25519 -C "usuario@example.com"
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed2551902 · Registra solo la clave pública
- Muestra
cat ~/.ssh/id_ed25519.pub. La terminación .pub es esencial. - En GitHub abre tu perfil → Settings → SSH and GPG keys → New SSH key.
- Asigna un título identificable al equipo, elige clave de autenticación y pega la clave pública completa.
- Guarda con Add SSH key y completa la autenticación que solicite GitHub.
Se registra en GitHub.
Se queda protegida en tu equipo. Nunca se pega en GitHub, correos o manuales.
- Acción
- New SSH key
- Title
- portatil-demo
- Key type
- Authentication Key
- Key
- Pega solo el contenido completo de id_ed25519.pub.
Add SSH key guarda la clave pública. La privada permanece en tu equipo.
03 · Verifica SSH antes de subir archivos
Ejecuta ssh -T git@github.com. En la primera conexión compara la huella con las huellas oficiales de GitHub antes de aceptar.
Resultado esperado: GitHub reconoce tu usuario e informa que autenticó, pero no proporciona acceso de shell. Eso es normal: estás conectando Git, no entrando a un escritorio o servidor remoto.
Si aparece Permission denied (publickey), revisa ssh-add -l, la clave pública registrada y la cuenta con permisos. No pases al envío hasta resolverlo. Si tu organización usa SSO, puede requerir autorizar la clave.
ssh -T git@github.com- Antes de aceptar
- Compara la huella con la documentación oficial.
- Respuesta correcta
- GitHub reconoce TU usuario e indica que no ofrece acceso shell.
- Si falla
- ssh-add -l muestra las claves cargadas; revisa cuenta y clave pública.
Permission denied (publickey)

01La autenticación falló. Revisa usuario remoto, clave cargada y clave pública registrada. Resuelve el acceso antes de repetir push.
04 · Abre el repositorio correcto
- Abre el repositorio de tu organización en GitHub. Si es nuevo, créalo como privado y sigue las reglas de la empresa.
- En Code → Local → SSH, copia la dirección del repositorio.
- En una carpeta de trabajo autorizada ejecuta
git clone DIRECCION_SSH, sustituyendo el marcador por la dirección copiada. Luego entra a la carpeta creada concd NOMBRE_CARPETA. - Si ya tienes la copia local, entra a ella; no clones encima ni ejecutes de nuevo una inicialización.
- Comprueba
git remote -vygit branch --show-current. La dirección SSH comienza normalmente porgit@github.com:. Confirma la rama acordada antes de editar.
La conexión local SSH y el formulario AppCloud son distintos: el formulario de construcción mostrado en eCloud solicita una URL HTTPS y, si corresponde, un token de lectura.
- SSH
- git@github.com:empresa-demo/odoo-addons.git
- HTTPS
- https://github.com/empresa-demo/odoo-addons.git
Direcciones ficticias: copia las de tu repositorio. SSH autentica tu computador; AppCloud utiliza su acceso de lectura independiente.
05 · Organiza, revisa y envía tus cambios
La estructura que espera AppCloud es addons/nombre_tecnico/__manifest__.py. Cada módulo debe estar descomprimido en su carpeta. requirements.txt es opcional, solo para dependencias requeridas. No subas bases de datos, archivos .conf de VPN, claves privadas ni tokens.
- Copia únicamente módulos autorizados y compatibles con tu versión de Odoo.
- Configura tu nombre/correo Git en este repositorio si aún no están definidos:
git config user.name "Tu nombre"ygit config user.email "usuario@example.com". - Revisa
git statusygit diff. - Prepara solo las rutas acordadas. El ejemplo añade addons; si también cambiaste requirements.txt, añádelo expresamente.
- Revisa lo preparado antes de crear el commit (un registro del cambio). Envía únicamente a la rama aprobada.
git add addons/
git diff --cached --stat
git diff --cached --check
git commit -m "Update approved modules"
git push -u origin mainEl ejemplo usa main; adáptalo a tu rama. Si se rechaza el envío, revisa con el responsable las reglas o cambios remotos; no uses --force. En GitHub confirma que aparecen el commit y las carpetas correctas. Subir código no lo publica en producción.
- git status / git diff
- Muestra archivos modificados y cambios antes de prepararlos.
- git add addons/
- Selecciona esos archivos para el próximo commit.
- git diff --cached --stat / --check
- Resume los cambios preparados y detecta problemas de espacios.
- git commit
- Registra el cambio local; todavía no lo envía.
- git push
- Envía a la rama remota. Verifica el commit en GitHub.
addons

01Comprueba la raíz del repositorio con pwd y ls. requirements.txt es opcional y se ubica en la raíz cuando se necesitan dependencias adicionales.
Ayuda y referencias
Las opciones disponibles dependen del servicio, la versión y los permisos de tu cuenta.
Pedir soporte ↗