Manuel d'alchimie du code

Déployer ton site 11ty depuis un devcontainer : une seule exigence, Docker

- 742 mots - Temps de lecture estimé: 4 minutes

(Cet article a été généré par DeepSeek V4 Pro, basé sur une session de travail avec MiMo 2.5)

🧪 La galère du changement de machine

Je viens de revivre ça une fois de trop : nouveau laptop, envie de travailler sur ce site, pis vlan — réinstaller Node, relancer npm ci, refaire la clé SSH. Une heure de gossage avant d’écrire une ligne.

Fait que je me suis dit : c’est correct, ça suffit. Le problème, c’est pas le site. C’est que tout dépend de la machine. Ce site est un site statique généré avec Eleventy (11ty) : Markdown en entrée, npm run build pour produire le HTML, rsync via SSH pour publier. Le tout repose sur des versions précises de Node, des dépendances locales et une clé SSH. Sur une machine neuve? Retour à la case départ.

J’avais déjà parlé de Docker pour l’autohébergement. Là, même outil, autre patente : Docker peut aussi contenir ton environnement de développement.

🧪 La solution : un devcontainer

Au lieu de documenter les étapes d’installation (et de les oublier trois mois plus tard), je décris l’environnement dans deux fichiers, versionnés dans Git. Docker devient la seule exigence. Pas d’abonnement, pas d’agent qui tourne en arrière-plan chez un géant du web. Juste des fichiers.

Deux fichiers dans .devcontainer/ :

🧪 Le Dockerfile

FROM node:24-bookworm

RUN apt-get update && apt-get install -y --no-install-recommends \
    rsync \
    openssh-client \
  && rm -rf /var/lib/apt/lists/*

rsync et openssh-client servent au déploiement, pas au build. Le conteneur couvre tout le cycle : construire, servir, publier. Une seule recette, tous les ingrédients.

🧪 Le devcontainer.json

{
  "name": "site-grav",
  "build": { "dockerfile": "Dockerfile" },
  "postCreateCommand": "npm ci",
  "forwardPorts": [8080],
  "mounts": [
    "source=${localEnv:HOME}/.ssh,target=/root/.ssh,type=bind,readonly"
  ],
  "customizations": {
    "vscode": {
      "extensions": [
        "dbaeumer.vscode-eslint",
        "esbenp.prettier-vscode",
        "ritwickdey.LiveServer"
      ]
    }
  }
}

Les vraies affaires sont dans la config :

  1. postCreateCommand : npm ci roule tout seul à la création du conteneur. Tu ne penses plus jamais à le relancer.
  2. forwardPorts : le port 8080 est redirigé vers la machine hôte. Tu navigues sur ton site comme si de rien n’était.
  3. Le montage SSH : ~/.ssh est monté en lecture seule dans le conteneur. Tu déploies sans copier ta clé privée dans l’image — parce que bon, une clé privée dans une image, tu te vois venir avec ça?

Ça se configure une fois, pis après, on gosse plus.

🧪 Build et serve

npm ci
npm run build
npm run serve:static

La chaîne de build (Sass, vérification des images, visuels sociaux, optimisation, Eleventy, purge CSS, Pagefind) produit environ 1800 fichiers en une dizaine de secondes. Le site est servi sur http://localhost:8080. Et hop : rien ne touche le système hôte. Ton laptop reste propre. C’est magique, non ?

🧪 Déploiement

Le déploiement repose sur rsync via SSH, comme décrit dans l’article sur le déploiement avec un wrapper sudo restreint. rsync et openssh-client étant dans l’image, et la clé SSH montée, deploy.sh fonctionne directement depuis le conteneur. Les variables DEPLOY_USER, DEPLOY_HOST, DEPLOY_PATH et DEPLOY_KEY restent à fournir.

Pas d’éditeur sous la main? Un docker run reproduit le tout :

docker run -it --rm \
  -v "$(pwd)":/workspaces/site-grav \
  -w /workspaces/site-grav \
  -v "$HOME/.ssh":/root/.ssh:ro \
  -e DEPLOY_USER="$DEPLOY_USER" \
  -e DEPLOY_HOST="$DEPLOY_HOST" \
  -e DEPLOY_PATH="$DEPLOY_PATH" \
  -e DEPLOY_KEY=/root/.ssh/id_deploy \
  -p 8080:8080 \
  site-grav npm run deploy

🧪 Limites

Soyons honnêtes : le montage SSH suppose que la clé est sur la machine hôte. Et Docker Desktop a un coût en RAM, disque et abstraction. Pour un usage solo minimaliste, un simple nvm suffit largement. Le devcontainer devient pertinent dès que tu partages l’environnement — ou dès que tu changes de machine plus souvent que tu changes de chaussettes.

🧪 Et maintenant?

Décris l’environnement dans deux fichiers, versionne-les, et Docker devient la seule exigence. Construire, servir et déployer un site 11ty se résume alors à un git clone suivi d’un « reopen in container ». La prochaine fois qu’un laptop meurt, tu vas savoir quoi faire — une heure de gossage en moins pour toi, pas une licence en plus pour les vendeurs de cloud.

Si tu veux creuser, j’ai déjà écrit sur Docker pour l’autohébergement et sur le déploiement avec un wrapper sudo restreint.

Et toi, ta config de dev, elle passerait le test d’un changement de machine?


Comment construire et déployer un site 11ty sur n’importe quelle machine avec une seule exigence ?


Décris ton environnement dans un .devcontainer (une image Node avec rsync et openssh-client, plus une config qui monte ta clé SSH et installe les dépendances). Docker devient la seule dépendance : le site se construit, se sert et se déploie depuis le conteneur de façon reproductible.

Abonne-toi au fil RSS pour ne rien manquer.

Étiquettes