GuíasDevOps
Tutorial: desplegar un sitio Astro en un VPS con GitHub Actions
1. Preparar el VPS
- Un usuario
deploypropietario de/var/www/site. - Su clave pública en
~/.ssh/authorized_keys. - Caddy sirviendo
/var/www/site: ver instalar Caddy.
2. Los secretos del repositorio
En GitHub: Settings, Secrets and variables, Actions. Añade SSH_KEY (la clave privada), HOST y USER.
3. El workflow
# .github/workflows/deploy.yml
name: Desplegar
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci
- run: npm run build
- name: Envío al VPS
run: |
install -m 600 -D /dev/null ~/.ssh/id_ed25519
echo "${{ secrets.SSH_KEY }}" > ~/.ssh/id_ed25519
ssh-keyscan -H "${{ secrets.HOST }}" >> ~/.ssh/known_hosts
rsync -az --delete dist/ "${{ secrets.USER }}@${{ secrets.HOST }}:/var/www/site/"
4. El circuito
- 1Push a mainTras revisar la rama de trabajo.
- 2BuildEn una máquina de GitHub, limpia cada vez.
- 3Envíorsync solo transfiere los archivos modificados.
- 4En líneaCaddy sirve la nueva versión al instante.
El principio: CI/CD, desplegar en cada push. El servidor: alojar en un VPS.
Preguntas frecuentes
- ¿Hay que instalar Node.js en el VPS?
- No para un sitio estático: el build se hace en GitHub y el VPS solo recibe los archivos. Un servidor web como Caddy los sirve.
- ¿Cómo proteger la clave SSH?
- Una clave dedicada al despliegue, guardada en los secretos del repositorio, vinculada a un usuario del VPS que solo accede a la carpeta del sitio.
- ¿Y si falla el build?
- El workflow se detiene antes del envío: el sitio en línea no cambia. GitHub te avisa por correo.