Commande Docker build
Référence des commandes Docker
docker buildLa commande permet de construire une image Docker à partir d'un Dockerfile.
docker buildLa commande lit les instructions définies dans le Dockerfile, construit l'image étape par étape et enregistre le résultat final dans le dépôt d'images local.
Syntaxe
docker build [OPTIONS] PATH | URL | -
PATH: le chemin du répertoire contenant le Dockerfile, ou.(Répertoire courant).URL: Pointe vers l'adresse du dépôt distant (tel qu'un dépôt Git) contenant le Dockerfile.-: Lire le Dockerfile depuis l'entrée standard.
Options courantes :
-t, --tag: Spécifier un nom et un tag pour l'image construite.-f, --file: Spécifier le chemin du Dockerfile (la valeur par défaut estPATHsousDockerfile)。--build-arg: Définir les arguments de construction.--no-cache: Construire l'image sans utiliser la couche de cache.--rm: Supprimer les conteneurs intermédiaires après une construction réussie (activé par défaut).--force-rm: Toujours supprimer les conteneurs intermédiaires, que la construction réussisse ou échoue.--pull: Toujours essayer de récupérer la dernière image de base depuis le registre.
Plus d'options :
--build-arg=[]: Définir des variables lors de la construction de l'image.--cpu-shares: Définir le poids d'utilisation du CPU.--cpu-period: Limiter la période CFS du CPU.--cpu-quota: Limiter le quota CFS du CPU.--cpuset-cpus: Spécifier les ID CPU disponibles.--cpuset-mems: Spécifiez les ID des nœuds de mémoire disponibles.--disable-content-trust: Ignorez la vérification de la confiance du contenu (activée par défaut).-f: Spécifiez le chemin du Dockerfile.--force-rm: Forcez la suppression des conteneurs intermédiaires pendant le processus de construction.--isolation: Utilisez la technologie d'isolation de conteneurs spécifiée.--label=[]: Définissez les métadonnées de l'image.-m: Définissez la valeur maximale de mémoire.--memory-swap: Définissez la valeur maximale de l'espace d'échange (mémoire + espace d'échange),-1signifie qu'il n'y a aucune limite sur l'espace d'échange.--no-cache: N'utilisez pas le cache lors de la construction de l'image.--pull: Essayez de récupérer la dernière version de l'image de base.--quiet, -q: Mode silencieux ; n'affichez que l'ID de l'image après une construction réussie.--rm: Supprimer les conteneurs intermédiaires après une construction réussie (activé par défaut).--shm-size: Définir/dev/shmtaille, avec une valeur par défaut de 64M.--ulimit: Définir la configuration Ulimit.--squash: Compresser toutes les étapes du Dockerfile en une seule couche.--tag, -t: Spécifier un nom et un tag pour l'image au formatname:tagouname; plusieurs tags peuvent être définis pour une image en une seule construction.--network: Définir pendant la constructionRUNle mode réseau de l'instruction, la valeur par défaut étantdefault。
1. Construire l'image
docker build -t myimage:latest .
Ceci lit le Dockerfile depuis le répertoire courant et construit une image nommée myimage:latest.
2. Spécifier le chemin du Dockerfile
docker build -f /path/to/Dockerfile -t myimage:latest .
Ceci lit le Dockerfile depuis le répertoire /path/to/ et construit une image nommée myimage:latest.
3. Définir les arguments de build
docker build --build-arg HTTP_PROXY=http://proxy.example.com -t myimage:latest .
Cela utilisera la variable d'environnement HTTP_PROXY pendant le processus de construction.
4. Construire l'image sans utiliser la couche de cache
docker build --no-cache -t myimage:latest .
Cela ignorera toutes les couches mises en cache lors de la construction de l'image, en garantissant que chaque étape est réexécutée.
Exemple - Construire une image à l'aide d'un Dockerfile
1. Créer un Dockerfile avec le contenu suivant :
# Dockerfile 示例 FROM ubuntu:20.04 LABEL maintainer="yourname@example.com" RUN apt-get update && apt-get install -y nginx COPY index.html /var/www/html/index.html CMD ["nginx", "-g", "daemon off;"]
2. Construire l'image
docker build -t mynginx:latest .
Exemple de sortie :
Sending build context to Docker daemon 3.072kB Step 1/5 : FROM ubuntu:20.04 20.04: Pulling from library/ubuntu ... Step 2/5 : LABEL maintainer="yourname@example.com" ... Step 3/5 : RUN apt-get update && apt-get install -y nginx ... Step 4/5 : COPY index.html /var/www/html/index.html ... Step 5/5 : CMD ["nginx", "-g", "daemon off;"] ... Successfully built 123456789abc Successfully tagged mynginx:latest
3. Vérifier l'image
docker images
Exemple de sortie :
Notes
REPOSITORY TAG IMAGE ID CREATED SIZE mynginx latest 123456789abc 10 minutes ago 200MB
- Assurez-vous que la syntaxe du Dockerfile est correcte et exécutez chaque étape dans l'ordre.
- Utilisation
.dockerignoreLe fichier exclut les fichiers et répertoires inutiles afin de réduire la taille du contexte de build. - Dans les environnements de production, essayez d'utiliser des images de base minimales pour réduire la taille de l'image et améliorer la sécurité.
- Évitez d'exposer des informations sensibles (telles que des mots de passe, des clés) dans le Dockerfile.
docker buildLa commande est l'outil essentiel pour construire des images Docker. En définissant un Dockerfile clair, vous pouvez automatiquement construire l'environnement d'exécution et les dépendances de l'application. Lors de son utilisation, assurez-vous de définir correctement les options et d'optimiser le Dockerfile pour améliorer l'efficacité de construction et la qualité de l'image.
autres extensions