feat: dockerization

.dockerignore

@@ -0,0 +1,34 @@
+# Include any files or directories that you don't want to be copied to your
+# container here (e.g., local build artifacts, temporary files, etc.).
+#
+# For more help, visit the .dockerignore file reference guide at
+# https://docs.docker.com/go/build-context-dockerignore/
+
+**/.classpath
+**/.dockerignore
+**/.env
+**/.git
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/.next
+**/.cache
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/charts
+**/docker-compose*
+**/compose.y*ml
+**/Dockerfile*
+**/node_modules
+**/npm-debug.log
+**/obj
+**/secrets.dev.yaml
+**/values.dev.yaml
+**/build
+**/dist
+LICENSE
+README.md

Dockerfile

@@ -0,0 +1,72 @@
+# syntax=docker/dockerfile:1
+
+# Comments are provided throughout this file to help you get started.
+# If you need more help, visit the Dockerfile reference guide at
+# https://docs.docker.com/go/dockerfile-reference/
+
+# Want to help us make this template better? Share your feedback here: https://forms.gle/ybq9Krt8jtBL3iCk7
+
+ARG NODE_VERSION=20
+
+################################################################################
+# Use node image for base image for all stages.
+FROM node:${NODE_VERSION}-alpine as base
+
+# Set working directory for all build stages.
+WORKDIR /usr/src/app
+
+
+################################################################################
+# Create a stage for installing production dependecies.
+FROM base as deps
+
+# Download dependencies as a separate step to take advantage of Docker's caching.
+# Leverage a cache mount to /root/.npm to speed up subsequent builds.
+# Leverage bind mounts to package.json and package-lock.json to avoid having to copy them
+# into this layer.
+RUN --mount=type=bind,source=package.json,target=package.json \
+ --mount=type=bind,source=package-lock.json,target=package-lock.json \
+ --mount=type=cache,target=/root/.npm \
+ npm ci --omit=dev
+
+################################################################################
+# Create a stage for building the application.
+FROM deps as build
+
+# Download additional development dependencies before building, as some projects require
+# "devDependencies" to be installed to build. If you don't need this, remove this step.
+RUN --mount=type=bind,source=package.json,target=package.json \
+ --mount=type=bind,source=package-lock.json,target=package-lock.json \
+ --mount=type=cache,target=/root/.npm \
+ npm ci
+
+# Copy the rest of the source files into the image.
+COPY . .
+# Run the build script.
+RUN npm run build
+
+################################################################################
+# Create a new stage to run the application with minimal runtime dependencies
+# where the necessary files are copied from the build stage.
+FROM base as final
+
+# Use production node environment by default.
+ENV NODE_ENV production
+
+# Run the application as a non-root user.
+USER node
+
+# Copy package.json so that package manager commands can be used.
+COPY package.json .
+
+# Copy the production dependencies from the deps stage and also
+# the built application from the build stage into the image.
+COPY --from=deps /usr/src/app/node_modules ./node_modules
+COPY --from=build /usr/src/app/_site ./_site
+
+
+# Expose the port that the application listens on.
+EXPOSE 8080
+
+# Run the application.
+CMD npm start

README.Docker.md

@@ -0,0 +1,22 @@
+### Building and running your application
+
+When you're ready, start your application by running:
+`docker compose up --build`.
+
+Your application will be available at http://localhost:8080.
+
+### Deploying your application to the cloud
+
+First, build your image, e.g.: `docker build -t myapp .`.
+If your cloud uses a different CPU architecture than your development
+machine (e.g., you are on a Mac M1 and your cloud provider is amd64),
+you'll want to build the image for that platform, e.g.:
+`docker build --platform=linux/amd64 -t myapp .`.
+
+Then, push it to your registry, e.g. `docker push myregistry.com/myapp`.
+
+Consult Docker's [getting started](https://docs.docker.com/go/get-started-sharing/)
+docs for more detail on building and pushing.
+
+### References
+* [Docker's Node.js guide](https://docs.docker.com/language/nodejs/)

compose.yaml

@@ -0,0 +1,51 @@
+# Comments are provided throughout this file to help you get started.
+# If you need more help, visit the Docker Compose reference guide at
+# https://docs.docker.com/go/compose-spec-reference/
+
+# Here the instructions define your application as a service called "server".
+# This service is built from the Dockerfile in the current directory.
+# You can add other services your application may depend on here, such as a
+# database or a cache. For examples, see the Awesome Compose repository:
+# https://github.com/docker/awesome-compose
+services:
+ server:
+ build:
+ context: .
+ environment:
+ NODE_ENV: production
+ ports:
+ - 8080:8080
+
+# The commented out section below is an example of how to define a PostgreSQL
+# database that your application can use. `depends_on` tells Docker Compose to
+# start the database before your application. The `db-data` volume persists the
+# database data between container restarts. The `db-password` secret is used
+# to set the database password. You must create `db/password.txt` and add
+# a password of your choosing to it before running `docker-compose up`.
+# depends_on:
+# db:
+# condition: service_healthy
+# db:
+# image: postgres
+# restart: always
+# user: postgres
+# secrets:
+# - db-password
+# volumes:
+# - db-data:/var/lib/postgresql/data
+# environment:
+# - POSTGRES_DB=example
+# - POSTGRES_PASSWORD_FILE=/run/secrets/db-password
+# expose:
+# - 5432
+# healthcheck:
+# test: [ "CMD", "pg_isready" ]
+# interval: 10s
+# timeout: 5s
+# retries: 5
+# volumes:
+# db-data:
+# secrets:
+# db-password:
+# file: db/password.txt
+

making-of.md

@@ -574,6 +574,80 @@ _includes/layout.html
 </head>
 ```
 
+## Dockerisation
+
+J'ai appris récemment l'existence de la commande `docker init`.
+Elle permet de générer les configurations pour "dockeriser" une application.
+
+```shell
+docker init
+```
+
+```
+Welcome to the Docker Init CLI!
+
+This utility will walk you through creating the following files with sensible defaults for your project:
+ - .dockerignore
+ - Dockerfile
+ - compose.yaml
+ - README.Docker.md
+
+Let's get started!
+
+? What application platform does your project use? [Use arrows to move, type to filter]
+> Node - (detected) suitable for a Node server application
+ Go - suitable for a Go server application
+? What application platform does your project use? Node
+? What version of Node do you want to use? 20
+? Which package manager do you want to use? npm
+? Do you want to run "npm run build" before starting your server? Yes
+? What directory is your build output to? (comma-separate if multiple) _site
+? What command do you want to use to start the app? npm start
+? What port does your server listen on? 8080
+
+✔ Created → .dockerignore
+✔ Created → Dockerfile
+✔ Created → compose.yaml
+✔ Created → README.Docker.md
+
+→ Your Docker files are ready!
+ Review your Docker files and tailor them to your application.
+ Consult README.Docker.md for information about using the generated files.
+
+What's next?
+ Start your application by running → docker compose up --build
+ Your application will be available at http://localhost:8080
+❯ docker compose up --build
+```
+
+J'ai du déplacer la dépendance `eleventy` dans les `dependencies` plutôt que `devDependencies`.
+
+Il semblerait que seules les dependencies sont accessibles depuis les scripts du `package.json`.
+
+Index: package.json
+```diff
+ "build": "eleventy"
+ },
+ "devDependencies": {
+- "@11ty/eleventy": "^3.0.0-alpha.17",
+ "@11ty/eleventy-img": "^5.0.0-beta.8",
+ "@11ty/webc": "^0.11.4",
+ "@types/11ty__eleventy-img": "^4.0.0"
+ },
+ "dependencies": {
++ "@11ty/eleventy": "^3.0.0-alpha.17",
+ "@11ty/eleventy-plugin-rss": "^2.0.2",
+ "@11ty/eleventy-plugin-syntaxhighlight": "^5.0.0",
+ "@11ty/eleventy-plugin-webc": "^0.11.2"
+
+```
+
+Pour construire et lancer le site via docker :
+
+```shell
+docker compose up --build
+```
+
 ## Next time
 
 - Test RSS feed in a real RSS client against github page

package.json

@@ -12,12 +12,12 @@
  "build": "eleventy"
  },
  "devDependencies": {
- "@11ty/eleventy": "^3.0.0-alpha.17",
  "@11ty/eleventy-img": "^5.0.0-beta.8",
  "@11ty/webc": "^0.11.4",
  "@types/11ty__eleventy-img": "^4.0.0"
  },
  "dependencies": {
+ "@11ty/eleventy": "^3.0.0-alpha.17",
  "@11ty/eleventy-plugin-rss": "^2.0.2",
  "@11ty/eleventy-plugin-syntaxhighlight": "^5.0.0",
  "@11ty/eleventy-plugin-webc": "^0.11.2"