GuidesDevOps
Tuto : déployer un site Astro sur un VPS avec GitHub Actions
1. Préparer le VPS
- Un utilisateur
deployproprié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
- 1Push sur mainAprès relecture de la branche de travail.
- 2BuildDans une machine de GitHub, propre à chaque fois.
- 3Envoirsync ne transfère que les fichiers modifiés.
- 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.