WordPress Lightsail

Lightsail → GitHub | Documentación Técnica
Documentación técnica

Conectar WordPress en Lightsail
con GitHub via SSH

Guía paso a paso para versionar el código fuente de una instalación Bitnami WordPress en Amazon Lightsail usando autenticación por clave SSH.

AWS Lightsail GitHub SSH WordPress / Bitnami Git Ubuntu / Debian
01 Conectarse a la instancia por SSH SSH

Desde tu terminal local o usando el botón "Connect using SSH" en la consola de Lightsail.

bash
ssh -i /ruta/llave.pem bitnami@IP_PUBLICA
02 Instalar Git APT

Las instancias Bitnami en Lightsail no incluyen Git por defecto. Instálalo con:

bash
sudo apt update
sudo apt install git -y

Verifica que quedó instalado:

bash
git --version
# git version 2.34.1
03 Ir al directorio de WordPress BASH

En instalaciones Bitnami, WordPress siempre se encuentra en:

bash
cd /opt/bitnami/wordpress
ls        # Deberías ver wp-config.php, wp-content/, etc.
04 Inicializar Git y hacer el primer commit GIT

Inicializa el repositorio local, configura tu identidad y registra todos los archivos actuales.

bash
git init
git config --global user.name  "Tu Nombre"
git config --global user.email "tu@email.com"
git add .
git commit -m "Primer commit"
💡

Puedes crear un .gitignore antes del git add . para excluir uploads, cache y logs de WordPress.

05 Generar clave SSH y agregarla a GitHub SSH

Genera el par de claves en el servidor y registra la clave pública en tu cuenta de GitHub.

bash — generar clave
ssh-keygen -t ed25519 -C "tu@email.com"
# Presiona ENTER en todas las preguntas
bash — mostrar clave pública
cat ~/.ssh/id_ed25519.pub
# Copia TODO el texto que aparece
🔑

Ve a GitHub → Settings → SSH and GPG keys → New SSH key, ponle un nombre (ej. lightsail) y pega la clave.

06 Conectar el repositorio remoto (SSH) GIT

Agrega la URL remota usando el formato SSH. Si ya existe un origin, elimínalo primero.

bash
# Si ya existe un origin anterior:
git remote remove origin

# Agregar con URL SSH (nunca HTTPS):
git remote add origin git@github.com:USUARIO/REPO.git
⚠️

Importante: usa siempre el formato git@github.com:usuario/repo.git. La URL https:// requiere usuario y contraseña, que GitHub ya no acepta.

07 Pull si el repo remoto ya tiene archivos GIT

Si el repositorio en GitHub fue creado con un README o .gitignore, hay que traer esos cambios primero para evitar el error [rejected].

bash
git pull --rebase origin main

Si aparece un conflicto en .gitignore, el archivo lucirá así:

⚡ Conflicto detectado en .gitignore
<<<<<<< HEAD
wp-content/uploads/
wp-content/cache/
*.log
=======
node_modules/
.env
>>>>>>> origin/main

Edita el archivo, deja el contenido correcto y continúa el rebase:

bash — resolver conflicto
nano .gitignore      # edita y guarda (Ctrl+O, Ctrl+X)
git add .gitignore
git rebase --continue
🔄

Si quieres cancelar el rebase y volver al estado anterior: git rebase --abort

08 Subir el código a GitHub PUSH

Con la autenticación SSH configurada, el push no pedirá usuario ni contraseña.

bash
git push -u origin main

Si ves Branch 'main' set up to track remote branch 'main' from 'origin', todo quedó correctamente configurado.

// resumen de comandos
# Descripción Comando
01 Conectar por SSH ssh -i llave.pem bitnami@IP
02 Instalar Git sudo apt install git -y
03 Ir a WordPress cd /opt/bitnami/wordpress
04 Inicializar repo git init
05 Primer commit git add . && git commit -m "..."
06 Generar clave SSH ssh-keygen -t ed25519 -C "email"
07 Agregar remote SSH git remote add origin git@github.com:…
08 Pull previo (si es necesario) git pull --rebase origin main
09 Subir código git push -u origin main
Documentación generada para Lightsail → GitHub · WordPress Bitnami · SSH Authentication