GuíasDevOps

Tutorial: desplegar un sitio Astro en un VPS con GitHub Actions

Por el equipo de Banzai LabsActualizado el 3 min de lectura

git pushnpm ciastro buildrsyncGitHub ActionsTu VPSCada push a main publica el sitio, sin conexión manual
Un push lanza el build en GitHub Actions y luego envía los archivos al VPS.

1. Preparar el VPS

  • Un usuario deploy propietario 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

  1. 1Push a mainTras revisar la rama de trabajo.
  2. 2BuildEn una máquina de GitHub, limpia cada vez.
  3. 3Envíorsync solo transfiere los archivos modificados.
  4. 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.

Para leer después

Todas las guías