Docker/Dockerfile

Ajouter des liens
Un livre de Wikilivres.
Gestion des conteneurs Gestion des conteneurs
Docker compose Docker compose
  1. Introduction
  2. Gestion des conteneurs
  3. Dockerfile
  4. Docker compose
  5. Kubernetes
  6. Problèmes connus

[ Modifier le sommaire ]

Gestion des conteneurs Gestion des conteneurs
Docker compose Docker compose

Une fois le processus Docker lancé, on peut commencer à lui demander de construire des conteneurs, de zéro ou à partir d'images d'un registre.

Rôle[modifier | modifier le wikicode]

Il existe deux sortes de conteneur :

  • Celui issu d'une image téléchargée et utilisée telle qu'elle.
  • Celui construit avec des instructions personnalisées.

Par convention, les instructions pour construire un conteneur sont écrites dans un fichier appelé "Dockerfile". Il est recommandé de les placer dans un dépôt Git pour les versionner.

Commandes Dockerfile[modifier | modifier le wikicode]

Les commentaires sont précédés du croisillon (#).

ADD[modifier | modifier le wikicode]

Permet de copier des fichiers ou dossiers de la machine hôte vers le conteneur[1].

Logo

Les Dockerfile n’ont jamais accès aux volumes de l'hôte, sauf dans l’ENTRYPOINT.

ARG[modifier | modifier le wikicode]

Crée une variable qui sera accessible dans la première image (FROM). Ex : 

ARG NODE_VERSION=10
...
RUN curl -sL https://deb.nodesource.com/setup_${NODE_VERSION}.x | bash

Logo

Éviter d'utiliser ce système pour bénéficier du build cache : ainsi Docker ne retéléchargera pas toutes les dépendances du Dockerfile lors du changement d'une variable située en début de Dockerfile, et n'affectant qu'une seule d'entre elles.

CMD[modifier | modifier le wikicode]

Commande à exécuter au lancement du conteneur.

COPY[modifier | modifier le wikicode]

Copie des fichiers ou dossiers de la machine hôte vers le conteneur[2]. Ainsi, l'image les embarquera (contrairement à s'ils étaient montés dans un volume).

Ex : 

COPY entrypoint.sh /usr/local/bin/entrypoint.sh

La différence avec ADD est qu'il ne prend pas en compte les décompression de .tar et les URLs distantes[3].

ENTRYPOINT[modifier | modifier le wikicode]

Nom d'un fichier exécutable (par exemple en shell) qui s'exécutera après chaque lancement du conteneur[4].

Ex : 

ENTRYPOINT /usr/local/bin/entrypoint.sh

Le fichier exécuté par l'entrypoint est le principal moyen d'accéder à la machine hôte, puisque le Dockerfile ne peut pas (en dehors de COPY qui peut la lire sans y écrire).

ENV[modifier | modifier le wikicode]

Crée une variable d'environnement accessible à toutes les images du Dockerfile[5].

EXPOSE[modifier | modifier le wikicode]

Ouvre le port logiciel mentionné du conteneur[6].

FROM[modifier | modifier le wikicode]

Part d'une image Docker pour en créer une autre qui la complète[7].

Cela permet par exemple le multistage build : se servir d'une première image comme builder volumineux (avec des sources, des dépendances nécessaires à des installations), duquel on copie seulement les fichiers à utiliser dans une autre image plus légère, qui sera montée en conteneur[8].

LABEL[modifier | modifier le wikicode]

Ajoute une description à une image[9].

RUN[modifier | modifier le wikicode]

Lance une commande. Ex : 

RUN ls

STOPSIGNAL[modifier | modifier le wikicode]

Signal d'arrêt à envoyer au conteneur, au format nombre ou nom. Par exemple SIGKILL pour le tuer.

USER[modifier | modifier le wikicode]

Se connecte à l'utilisateur et mot de passe en paramètre pour lancer les instructions RUN, CMD ou ENTRYPOINT[10].

Par ailleurs, pour que le conteneur possède les permissions de l'utilisateur courant[11] : 

docker --user $(id -u):$(id -g)

Utilisation dans Docker Compose[modifier | modifier le wikicode]

user: ${CURRENT_UID}

Puis au lancement : 

CURRENT_UID=$(id -u):$(id -g) docker compose up -d

La présence de l'opérateur ":" dans les accolades signifie que l'on bascule vers cet utilisateur si la variable est inconnue du .env. Par exemple pour utiliser l'UID 1000 si UID= n'est pas renseigné dans le .env : 

user: ${UID:-1000}:${GID:-1000}

VOLUME[modifier | modifier le wikicode]

Point de montage accessible par l'hôte et les autres conteneurs[12].

WORKDIR[modifier | modifier le wikicode]

Définit le répertoire de travail, c'est-à-dire celui à partir duquel les commandes partent (ex : pwd), y compris quand on se connecte au conteneur après son montage.

Équivalent à docker --workdir.

.dockerignore[modifier | modifier le wikicode]

Un fichier .dockerignore peut être placé dans un dépôt pour que son conteneur ignore le contenu qui y figure lors des commandes ADD et COPY. Exemple pour Symfony[13] : 

node_modules/*
var/*
vendor/*

Bonnes pratiques[modifier | modifier le wikicode]

Voir https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

Exemples[modifier | modifier le wikicode]

Apache avec PHP7.1[modifier | modifier le wikicode]

Voici un exemple de serveur Apache avec PHP7.1 pour MediaWiki[14] : 

FROM debian:sid

ENV TZ=Europs/Paris
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

ENV MEDIAWIKI_VERSION wmf/1.30.0-wmf.4

# XXX: Consider switching to nginx.
RUN set -eux; \
	apt-get update; \
	apt-get install -y --no-install-recommends \
		ca-certificates \
		apache2 \
		libapache2-mod-php7.1 \
		php7.1-mysql \
		php7.1-cli \
		php7.1-gd \
		php7.1-curl \
		php7.1-mbstring \
		php7.1-xml \
		imagemagick \
		netcat \
		git \
	; \
	rm -rf /var/lib/apt/lists/*; \
	rm -rf /var/cache/apt/archives/*; \
	a2enmod rewrite; \
	a2enmod proxy; \
	a2enmod proxy_http; \
	# Remove the default Debian index page.
	rm /var/www/html/index.html


# MediaWiki setup
RUN set -eux; \
	mkdir -p /usr/src; \
	git clone \
		--depth 1 \
		-b $MEDIAWIKI_VERSION \
		https://gerrit.wikimedia.org/r/p/mediawiki/core.git \
		/usr/src/mediawiki \
	; \
	cd /usr/src/mediawiki; \
	git submodule update --init skins; \
	git submodule update --init vendor; \
	cd extensions; \
	# Extensions
	# TODO: make submodules shallow clones?
	git submodule update --init --recursive VisualEditor; \
	git submodule update --init --recursive Math; \
	git submodule update --init --recursive EventBus; \
	git submodule update --init --recursive Scribunto; \
	git submodule update --init --recursive ParserFunctions; \
	git submodule update --init --recursive SyntaxHighlight_GeSHi; \
	git submodule update --init --recursive Cite; \
	git submodule update --init --recursive Echo; \
	git submodule update --init --recursive Flow; \
	git submodule update --init --recursive PageImages; \
	git submodule update --init --recursive TextExtracts; \
	git submodule update --init --recursive MobileFrontend; \
	git submodule update --init --recursive TemplateData; \
	git submodule update --init --recursive ParserFunctions; \
	git submodule update --init --recursive Citoid


COPY php.ini /usr/local/etc/php/conf.d/mediawiki.ini

COPY apache/mediawiki.conf /etc/apache2/
RUN echo "Include /etc/apache2/mediawiki.conf" >> /etc/apache2/apache2.conf

COPY docker-entrypoint.sh /entrypoint.sh

EXPOSE 80 443
ENTRYPOINT ["/entrypoint.sh"]
CMD ["apachectl", "-e", "info", "-D", "FOREGROUND"]

Nginx avec PHP-FPM 8.2[modifier | modifier le wikicode]

FROM php:8.2-fpm

ENV TZ=Europs/Paris
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

RUN apt-get update && apt-get install -y \
      libxml2-dev \
      libicu-dev \
      libcurl3-dev \
      libsqlite3-dev \
      libedit-dev \
      zlib1g-dev \
      libfreetype6-dev \
      libjpeg62-turbo-dev \
      libmemcached-dev \
      libzip-dev \
      libonig-dev \
      libpq-dev
RUN docker-php-ext-install \
        intl \
        pdo_mysql \
        pdo_pgsql \
        opcache \
        bcmath \
        soap \
        sockets \
        zip \
     && docker-php-ext-configure gd \
     && docker-php-ext-install -j$(nproc) gd

RUN pecl install -f xdebug \
    && export XDEBUG_PATH=`find / -name "xdebug.so"`

RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

WORKDIR /var/www/myApp

CMD ["php-fpm"]

Références[modifier | modifier le wikicode]

  1. ↑ https://docs.docker.com/engine/reference/builder/#add
  2. ↑ https://docs.docker.com/engine/reference/builder/#copy
  3. ↑ https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#add-or-copy
  4. ↑ https://docs.docker.com/engine/reference/builder/#entrypoint
  5. ↑ https://docs.docker.com/engine/reference/builder/#env
  6. ↑ https://docs.docker.com/engine/reference/builder/#expose
  7. ↑ https://docs.docker.com/engine/reference/builder/#from
  8. ↑ https://docs.docker.com/develop/develop-images/multistage-build/
  9. ↑ https://docs.docker.com/engine/reference/builder/#label
  10. ↑ https://docs.docker.com/engine/reference/builder/#user
  11. ↑ https://medium.com/redbubble/running-a-docker-container-as-a-non-root-user-7d2e00f8ee15
  12. ↑ https://docs.docker.com/engine/reference/builder/#volume
  13. ↑ https://snyk.io/blog/10-best-practices-to-containerize-nodejs-web-applications-with-docker/
  14. ↑ https://github.com/wikimedia/mediawiki-docker/blob/master/dev/Dockerfile
Récupérée de « https://fr.wikibooks.org/w/index.php?title=Docker/Dockerfile&oldid=701945 »