Configuration DevContainer

zer0-mistakes fournit un .devcontainer/devcontainer.json qui vous permet d’ouvrir un environnement de développement Jekyll entièrement configuré en un seul clic — sans installation locale de Ruby, Bundler ou Node.

Environnements pris en charge

Fichier de configuration

.devcontainer/devcontainer.json

Ce qui est préinstallé

Au lieu de récupérer une image de base générique et d’installer les gems à chaque lancement, le devcontainer se construit à partir du propre docker/Dockerfile du dépôt (l’étape dev-test). Cette étape exécute bundle install au moment de la construction de l’image, si bien que toute la chaîne d’outils Jekyll est préchargée dans l’image — les gems correspondent toujours au Gemfile.lock de la branche extraite, et il n’y a aucun bundle install lent au premier démarrage.

Docker-in-Docker et une installation Node autonome sont intentionnellement non inclus — ils ne sont pas nécessaires au rendu du site (Playwright/Sass s’exécutent sur l’hôte), et leur suppression accélère la création de Codespace et les prebuilds.

Lancement quasi instantané avec les prebuilds

Parce que l’image est autonome, les prebuilds GitHub Codespaces peuvent la construire à l’avance afin que les nouveaux Codespaces se restaurent depuis une image prête en quelques secondes. Activez-les dans Settings → Codespaces → Set up prebuild (cible main, déclencheur On configuration change). Consultez .devcontainer/README.md.

Hook post-création

git config --global --add safe.directory ${containerWorkspaceFolder} && (bundle check || bundle install --jobs 4 --retry 3)

bundle check est une opération quasi instantanée lorsque les gems sont déjà intégrés à l’image ; il ne se rabat sur une installation complète que si le lockfile a divergé.

Hook post-démarrage

bundle exec jekyll serve \
  --config '_config.yml,_config_dev.yml' \
  --host 0.0.0.0 --port 4000 --livereload --force_polling

Le serveur de développement Jekyll démarre automatiquement à chaque démarrage du conteneur (nohup le maintient actif après le retour du hook ; --force_polling rend la surveillance des fichiers fiable sur le bind mount de Codespaces ; les logs arrivent dans /tmp/jekyll-serve.log). Le site est disponible à http://localhost:4000 et redirigé automatiquement dans VS Code et Codespaces.

Ports redirigés

Extensions VS Code

La configuration recommande ces extensions :

• sissel.shopify-liquid — Coloration syntaxique des templates Liquid
• yzhang.markdown-all-in-one — Édition Markdown
• DavidAnson.vscode-markdownlint — Linting Markdown
• streetsidesoftware.code-spell-checker — Vérification orthographique
• esbenp.prettier-vscode — Formatage du code
• ms-azuretools.vscode-docker — Gestion de Docker

Utiliser le DevContainer en local

Si Docker Desktop est installé, vous pouvez utiliser le devcontainer sans Codespaces :

1. Installez l’extension VS Code Dev Containers
2. Ouvrez le dossier du dépôt dans VS Code
3. Cliquez sur la notification Reopen in Container (ou utilisez la palette de commandes → Dev Containers: Reopen in Container)
4. Attendez que le conteneur se construise (~2 à 3 minutes lors de la première exécution)
5. Le site démarre automatiquement sur le port 4000

Relation avec Docker Compose

Le devcontainer et docker-compose.yml servent des objectifs différents :

Vous pouvez utiliser l’un ou l’autre (ou les deux) selon votre flux de travail.

Voir aussi

• Développement Docker
• Guide de démarrage rapide
• Publication Docker locale

Voir aussi

• [[Development]]
• [[Docker]]
• [[Getting Started]]