Manuales de usuarioServicios TI en ColombiaAyuda y recursos eCloud

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.

Versión 4.0 · propuesta para revisión · 28/10/2026

Manuales eCloud
  1. Tu equipo
  2. Repositorio Git
  3. 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.

01

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.

El intento SSH devuelve 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.

02

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.

  1. Revisa tus claves existentes con ls -la ~/.ssh. Si ya existe una clave autorizada, consulta antes de crear otra.
  2. Para una clave nueva, ejecuta el ejemplo cambiando el correo por el tuyo. No sobrescribas archivos existentes.
  3. Cuando pregunte dónde guardarla, utiliza una ruta nueva si la predeterminada ya está ocupada. Añade una frase de protección.
  4. 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_ed25519
03

02 · Registra solo la clave pública

  1. Muestra cat ~/.ssh/id_ed25519.pub. La terminación .pub es esencial.
  2. En GitHub abre tu perfil → Settings → SSH and GPG keys → New SSH key.
  3. Asigna un título identificable al equipo, elige clave de autenticación y pega la clave pública completa.
  4. Guarda con Add SSH key y completa la autenticación que solicite GitHub.
Clave pública · .pub

Se registra en GitHub.

Clave privada · sin .pub

Se queda protegida en tu equipo. Nunca se pega en GitHub, correos o manuales.

Ilustración explicativa · datos ficticios
GitHub → Settings → SSH and GPG keys
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.

04

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
Ilustración explicativa · datos ficticios
Comprobación de identidad
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.
Captura de referencia · interfaz en español

Permission denied (publickey)

Permission denied (publickey)
Pulsa 1 para destacar la indicación.

01La autenticación falló. Revisa usuario remoto, clave cargada y clave pública registrada. Resuelve el acceso antes de repetir push.

05

04 · Abre el repositorio correcto

  1. Abre el repositorio de tu organización en GitHub. Si es nuevo, créalo como privado y sigue las reglas de la empresa.
  2. En Code → Local → SSH, copia la dirección del repositorio.
  3. 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 con cd NOMBRE_CARPETA.
  4. Si ya tienes la copia local, entra a ella; no clones encima ni ejecutes de nuevo una inicialización.
  5. Comprueba git remote -v y git branch --show-current. La dirección SSH comienza normalmente por git@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.

Ilustración explicativa · datos ficticios
GitHub → Code → Local → SSH
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.

06

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.

  1. Copia únicamente módulos autorizados y compatibles con tu versión de Odoo.
  2. Configura tu nombre/correo Git en este repositorio si aún no están definidos: git config user.name "Tu nombre" y git config user.email "usuario@example.com".
  3. Revisa git status y git diff.
  4. Prepara solo las rutas acordadas. El ejemplo añade addons; si también cambiaste requirements.txt, añádelo expresamente.
  5. 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 main

El 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.

Ilustración explicativa · datos ficticios
Qué hace cada comando
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.
Captura de referencia · interfaz en español

addons

addons
Pulsa 1 para destacar la indicación.

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 ↗

GitHub · SSH ↗

GitHub · Fingerprints ↗