GuidesDevOps

Tuto : déployer un site Astro sur un VPS avec GitHub Actions

Par l’équipe Banzai LabsMis à jour le 3 min de lecture

git pushnpm ciastro buildrsyncGitHub ActionsVotre VPSChaque push sur main publie le site, sans connexion manuelle
Un push déclenche le build sur GitHub Actions, puis l’envoi des fichiers sur le VPS.

1. Préparer le VPS

  • Un utilisateur deploy propriétaire de /var/www/site.
  • Sa clé publique dans ~/.ssh/authorized_keys.
  • Caddy qui sert /var/www/site : voir installer Caddy.

2. Les secrets du dépôt

Dans GitHub : Settings, Secrets and variables, Actions. Ajoutez SSH_KEY (la clé privée), HOST et USER.

3. Le workflow

# .github/workflows/deploy.yml
name: Déployer
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: Envoi sur le 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. Le circuit

  1. 1Push sur mainAprès relecture de la branche de travail.
  2. 2BuildDans une machine de GitHub, propre à chaque fois.
  3. 3Envoirsync ne transfère que les fichiers modifiés.
  4. 4En ligneCaddy sert la nouvelle version immédiatement.

Le principe : CI/CD, déployer à chaque push. Le serveur : héberger sur un VPS.

Questions fréquentes

Faut-il installer Node.js sur le VPS ?
Non pour un site statique : le build se fait chez GitHub, le VPS ne reçoit que les fichiers. Un serveur web comme Caddy les sert.
Comment protéger la clé SSH ?
Une clé dédiée au déploiement, rangée dans les secrets du dépôt, liée à un utilisateur du VPS qui n’a accès qu’au dossier du site.
Et si le build échoue ?
Le workflow s’arrête avant l’envoi : le site en ligne ne change pas. GitHub vous prévient par e-mail.

À lire ensuite

Tous les guides