Docker-Befehl „build“

Docker-Befehlsreferenz


docker buildDer Befehl wird verwendet, um ein Docker-Image aus einem Dockerfile zu erstellen.

docker buildDer Befehl liest die im Dockerfile definierten Anweisungen, erstellt das Image Schritt für Schritt und speichert das Endergebnis im lokalen Image-Repository.

Syntax

docker build [OPTIONS] PATH | URL | -
  • PATH: der Verzeichnispfad, der das Dockerfile enthält, oder.(Aktuelles Verzeichnis).
  • URL: Verweist auf die Adresse des Remote-Repositorys (z. B. ein Git-Repository), das das Dockerfile enthält.
  • -: Liest das Dockerfile aus der Standardeingabe.

Gängige Optionen:

  • -t, --tag: Name und Tag für das erstellte Image angeben.
  • -f, --file: Pfad zum Dockerfile angeben (Standard istPATHunterDockerfile)。
  • --build-arg: Build-Argumente festlegen.
  • --no-cache: Das Image ohne Verwendung der Cache-Ebene erstellen.
  • --rm: Zwischencontainer nach einem erfolgreichen Build entfernen (standardmäßig aktiviert).
  • --force-rm: Zwischencontainer immer entfernen, unabhängig davon, ob der Build erfolgreich ist oder fehlschlägt.
  • --pull: Immer versuchen, das neueste Basis-Image aus der Registry zu pullen.

Erklärung weiterer Optionen:

  • --build-arg=[]: Variablen beim Erstellen des Images festlegen.
  • --cpu-shares: CPU-Nutzungsgewichtung festlegen.
  • --cpu-period: Die CPU-CFS-Periode begrenzen.
  • --cpu-quota: Das CPU-CFS-Kontingent begrenzen.
  • --cpuset-cpus: Die verfügbaren CPU-IDs angeben.
  • --cpuset-mems: Geben Sie die verfügbaren Speicherknoten-IDs an.
  • --disable-content-trust: Ignorieren Sie die Überprüfung des Content Trust (standardmäßig aktiviert).
  • -f: Geben Sie den Pfad zum Dockerfile an.
  • --force-rm: Erzwingen Sie das Entfernen von Zwischencontainern während des Build-Prozesses.
  • --isolation: Verwenden Sie die angegebene Container-Isolierungstechnologie.
  • --label=[]: Legen Sie Metadaten für das Image fest.
  • -m: Legen Sie den maximalen Speicherwert fest.
  • --memory-swap: Legen Sie den maximalen Wert des Swap-Speichers (Speicher + Swap-Speicher) fest,-1bedeutet keine Begrenzung des Swap-Speichers.
  • --no-cache: Verwenden Sie beim Erstellen des Images keinen Cache.
  • --pull: Versuchen Sie, die neueste Version des Basis-Images abzurufen.
  • --quiet, -q: Quiet-Modus; nur die Image-ID nach einem erfolgreichen Build ausgeben.
  • --rm: Zwischencontainer nach einem erfolgreichen Build entfernen (standardmäßig aktiviert).
  • --shm-size: Festlegen/dev/shmsize, mit einem Standardwert von 64M.
  • --ulimit: Die Ulimit-Konfiguration festlegen.
  • --squash: Alle Schritte in der Dockerfile zu einer einzigen Ebene komprimieren.
  • --tag, -t: Einen Namen und einen Tag für das Image im Format angebenname:tagodername; mehrere Tags können für ein Image in einem einzigen Build festgelegt werden.
  • --network: Beim Build festlegenRUNden Netzwerkmodus der Anweisung, wobei der Standardwertdefault。

1. Image erstellen

docker build -t myimage:latest .

Dies liest die Dockerfile aus dem aktuellen Verzeichnis und erstellt ein Image namens myimage:latest.

2. Dockerfile-Pfad angeben

docker build -f /path/to/Dockerfile -t myimage:latest .

Dies liest die Dockerfile aus dem Verzeichnis /path/to/ und erstellt ein Image namens myimage:latest.

3. Build-Argumente festlegen

docker build --build-arg HTTP_PROXY=http://proxy.example.com -t myimage:latest .

Dadurch wird die Umgebungsvariable HTTP_PROXY während des Build-Prozesses verwendet.

4. Das Image ohne Verwendung der Cache-Ebene erstellen

docker build --no-cache -t myimage:latest .

Dadurch werden beim Erstellen des Images alle zwischengespeicherten Ebenen ignoriert, sodass jeder Schritt erneut ausgeführt wird.

Beispiel – Erstellen eines Images mithilfe eines Dockerfile

1. Erstellen Sie eine Dockerfile mit folgendem Inhalt:

# 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. Image erstellen

docker build -t mynginx:latest .

Beispielausgabe:

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. Image überprüfen

docker images

Beispielausgabe:

Hinweise

REPOSITORY   TAG       IMAGE ID       CREATED          SIZE
mynginx      latest    123456789abc   10 minutes ago   200MB
  • Stellen Sie sicher, dass die Dockerfile-Syntax korrekt ist, und führen Sie jeden Schritt der Reihe nach aus.
  • Nutzung.dockerignoreDie Datei schließt unnötige Dateien und Verzeichnisse aus, um die Größe des Build-Kontexts zu reduzieren.
  • Versuchen Sie in Produktionsumgebungen, minimale Basis-Images zu verwenden, um die Image-Größe zu reduzieren und die Sicherheit zu verbessern.
  • Vermeiden Sie es, sensible Informationen (wie Passwörter, Schlüssel) im Dockerfile offenzulegen.

docker buildDer Befehl ist das zentrale Werkzeug zum Erstellen von Docker-Images. Durch die Definition eines klaren Dockerfiles können Sie die Laufzeitumgebung und Abhängigkeiten der Anwendung automatisch erstellen. Achten Sie bei der Verwendung darauf, die Optionen entsprechend festzulegen und das Dockerfile zu optimieren, um die Build-Effizienz und die Image-Qualität zu verbessern.


Docker-Befehlsreferenz

Weitere Erweiterungen