La plus petite image Docker pour des sites web statiques

-

Jusqu’à récemment, je pensais que servir des sites Web statiques à partir de Docker était un gaspillage de bande passante et de stockage. L’intégration de nginx ou de divers autres moteurs d’exécution lourds dans une image Docker dans le seul but de servir des fichiers statiques ne semblait pas être la meilleure idée – Netlify ou les pages Github peuvent gérer cela bien mieux. Mais mon serveur amateur était triste et pleurait des larmes numériques.

J’ai lu récemment un article de HackerNews sur redbean, un serveur de fichiers statiques à single-binary et super minuscule, m’a fait réfléchir. C’est ainsi que commence mon voyage pour trouver l’image Docker la plus efficace en termes de temps et de stockage pour servir un site Web statique.

Après avoir évalué quelques serveurs de fichiers statiques aux caractéristiques similaires, j’ai opté pour thttpd, qui présente une empreinte similaire, mais qui semble un peu plus éprouvé.

L’exécution de thttpd se déroule comme suit :

thttpd -D -h 0.0.0.0 -p 3000 -d /static-website -u static-user -l - -M 60
  • Lancera le serveur en avant-plan (-D),
  • en écoutant sur l’hôte 0.0.0.0 (-h),
  • le port 3000 (-p),
  • en servant tous les fichiers dans /static-website (-d)
  • qui sont accessibles à static-user (-u).
  • Il imprimera les journaux d’accès sur STDOUT (-l -)
  • et fixera l’en-tête Cache-Control à 60 secondes (-M).

Il y a quelques autres fonctionnalités intéressantes, comme l’authentification de base, le throttling et les hôtes virtuels, que vous pouvez lire dans la documentation.

Les premiers tests

Ma première tentative utilise la petite image alpine, qui emballe déjà thttpd :

FROM alpine:3.15.4

# Install thttpd
RUN apk add thttpd

# Create a non-root user to own the files and run our server
RUN adduser -D static
USER static
WORKDIR /home/static

# Copy the static website
# Use the .dockerignore file to control what ends up inside the image!
COPY . .

# Run thttpd
CMD ["thttpd", "-D", "-h", "0.0.0.0", "-p", "3000", "-d", "/home/static", "-u", "static", "-l", "-", "-M", "60"]

Vous pouvez construire et exécuter l’image en appelant :

docker build -t static:latest .
docker run -it --rm -p 3000:3000 static:latest

…puis naviguer jusqu’à http://localhost:3000.

L’image se construit rapidement et, à 7,77 Mo, elle est assez petite :

> docker images | grep static
static              latest              cb1750e32562        About an hour ago    7.77MB

Seconds tests

Nous pouvons aller plus loin en utilisant Docker scratch, qui est en fait une image no-op, légère comme le vide. Le problème avec scratch est que vous ne pouvez pas vraiment faire grand-chose à l’intérieur : vous ne pouvez pas créer de nouveaux utilisateurs, il n’y a pas de gestionnaire de paquets ni d’exécutable d’ailleurs – à part ceux que vous avez copiés vous-même.

L’utilisation de l’image scratch nécessite généralement une approche en plusieurs étapes. Nous partons d’alpine, téléchargeons et compilons thttpd en tant que binaire statique, créons un utilisateur, puis copions ces actifs sur scratch et ajoutons nos fichiers statiques au mélange :

FROM alpine:3.15.4 AS builder

ARG THTTPD_VERSION=2.29

# Install all dependencies required for compiling thttpd
RUN apk add gcc musl-dev make

# Download thttpd sources
RUN wget http://www.acme.com/software/thttpd/thttpd-${THTTPD_VERSION}.tar.gz \
  && tar xzf thttpd-${THTTPD_VERSION}.tar.gz \
  && mv /thttpd-${THTTPD_VERSION} /thttpd

# Compile thttpd to a static binary which we can copy around
RUN cd /thttpd \
  && ./configure \
  && make CCOPT='-O2 -s -static' thttpd

# Create a non-root user to own the files and run our server
RUN adduser -D static

# Switch to the scratch image
FROM scratch

EXPOSE 3000

# Copy over the user
COPY --from=builder /etc/passwd /etc/passwd

# Copy the thttpd static binary
COPY --from=builder /thttpd/thttpd /

# Use our non-root user
USER static
WORKDIR /home/static

# Copy the static website
# Use the .dockerignore file to control what ends up inside the image!
COPY . .

# Run thttpd
CMD ["/thttpd", "-D", "-h", "0.0.0.0", "-p", "3000", "-d", "/home/static", "-u", "static", "-l", "-", "-M", "60"]

Jetons un autre coup d’œil à ces chiffres :

> docker images | grep static
static              latest              ae708220dc8c        About a minute ago   187kB

Les 187Ko qu’il nous reste correspondent à la taille du binaire statique thttpd et des fichiers statiques qui ont été copiés, qui dans mon cas était juste un fichier contenant le texte hello world. Notez que l’étape alpine de la construction en plusieurs étapes est en fait assez grande en taille (~130Mo), mais elle peut être réutilisée à travers les constructions et n’est pas poussée vers le registre.

À ce stade, vous pouvez convertir l’image que nous avons construite jusqu’à présent en une image de base pour tous vos sites Web statiques et la pousser vers un registre, de sorte que vous pouvez sauter l’étape alpine entièrement. Ou vous pouvez simplement utiliser via mon Docker Hub :

FROM alfreddagenais/small-docker-static-website:latest

COPY . .

Cela produit une image mono-couche de 186KB + la taille de votre site web statique et rien d’autre. Si vous avez besoin de configurer thttpd d’une manière différente, vous pouvez simplement remplacer la ligne CMD :

FROM alfreddagenais/small-docker-static-website:latest

COPY . .

CMD ["/thttpd", "-D", "-h", "0.0.0.0", "-p", "3000", "-d", "/home/static", "-u", "static", "-l", "-", "-M", "60"]

En conclusion

Docker peut être utilisé efficacement pour emballer et servir des sites web statiques.

Le code est disponible à l’adresse https://github.com/alfreddagenais/kilukru-dev-small-docker-static-website.

Alfredhttps://www.alfreddagenais.com
Je suis un développeur Web Full Stack sénior. Chaque jour est pour moi une journée de plus pour découvrir de nouvelles idées. Le développement web et l'informatique sont omniprésents dans mon quotidien. Pour que la créativité soit à son maximum, il ne faut pas avoir peur d’expérimenter et nous avons tous que le Web est infiniment grand pour expérimenter nos idées.

Buy me a coffee Paypal Patreon Ko-Fi

Share this article

Recent posts

Popular categories

LAISSER UN COMMENTAIRE

S'il vous plaît entrez votre commentaire!
S'il vous plaît entrez votre nom ici

Recent comments