Docker/Image/best-practice: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
 
(25 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
# [[Docker/Image/best-practice/mehrstufige Builds]]
<noinclude>
# [[Docker/Image/best-practice/Basisimage]]
<!--
----
{{Navigation|<zurück>|<nachste>}}
{{Navigation|BSI/200-3|BSI/200-3/Einleitung/Beispiele}}
----
-->
'''{{BASEPAGENAME}}'''
</noinclude>


# [[Docker/Image/best-practice/Dateien ausschließen]]
== Beschreibung ==
{| class="table table-striped table-hover col1bold col2bold col1nowrap"
|-
| 01 || [[Docker/Image/best-practice/mehrstufige Builds|Mehrstufige Builds]] || Verwenden Sie mehrstufige Builds
|-
| 02 || [[Docker/Image/best-practice/Basisimage|Basis-Images]] ||
|-
| 03 || [[Docker/Image/best-practice/Dateien ausschließen|Dateien ausschließen]] ||
|-
| 04 || [[Docker/Image/best-practice/Temporäre Container|Temporäre Container]] ||
|-
| 05 || [[Docker/Image/best-practice/Pakete|Pakete]] ||
|-
| 06 || [[Docker/Image/best-practice/Anwendungen entkoppeln|Anwendungen entkoppeln]] ||
|-
| 07 || [[Docker/Image/best-practice/Mehrzeilige Argumente|Mehrzeilige Argumente]] ||
|-
| 08 || [[Docker/Image/best-practice/Cache|Cache]] ||
|-
| 09 || [[Docker/Image/best-practice/Basisbildes pinnen|Basisbildes pinnen]] ||
|-
| 10 || [[Docker/Image/best-practice/Images testen|Images testen]] ||
|-
| 11 || [[Docker/Image/best-practice/Dockerfile|Dockerfile]] ||
|-
| 12 || [[Docker/Image/best-practice/Maintenance|Maintenance]] ||
|}


# [[Docker/Image/best-practice/Temporäre Container]]
<noinclude>
<!--
----
{{Navigation|<zurück>|<nachste>}}
----
-->


# [[Docker/Image/best-practice/Pakete]]
== Anhang ==
=== Siehe auch ===
<div style="column-count:2">
<categorytree hideroot=on mode="pages">{{BASEPAGENAME}}</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}


# [[Docker/Image/best-practice/Anwendungen entkoppeln]]
=== Dokumentation ===
<!--
; Man-Page
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]


== [https://docs.docker.com/build/building/best-practices/#sort-multi-line-arguments Mehrzeilige Argumente sortieren] ==
; Info-Pages


Sortieren Sie mehrzeilige Argumente nach Möglichkeit alphanumerisch, um die Pflege zu vereinfachen. Dadurch lassen sich Doppelungen bei den Paketen vermeiden und die Liste lässt sich viel einfacher aktualisieren. Außerdem werden PRs dadurch wesentlich lesbarer und leichter zu prüfen. Es ist ebenfalls hilfreich, vor einem Backslash ein Leerzeichen einzufügen (<tt>\</tt>).
; Hinweise
<div class="card h-100 bg-warning">
<div class="card-header">'''<big>Header</big>'''</div>
<div class="card-body bg-white">
Hier steht der Kartentext
</div>
</div>
-->


Hier ist ein Beispiel aus dem [https://github.com/docker-library/buildpack-deps buildpack-deps-Image]:
=== Links ===
==== Projekt ====
# https://docs.docker.com/build/building/best-practices/


[https://docs.docker.com/reference/dockerfile/#run RUN] apt-get update && apt-get install -y --no-install-recommends \
==== Weblinks ====
  bzr \
  cvs \
  git \
  mercurial \
  subversion \
  && rm -rf /var/lib/apt/lists/*


== [https://docs.docker.com/build/building/best-practices/#leverage-build-cache Cache nutzen] ==
<!--
{{DEFAULTSORT:new}}
{{DISPLAYTITLE:new}}
-->


Beim Erstellen eines Images arbeitet Docker die Anweisungen in Ihrer Dockerfile der Reihe nach ab und führt sie in der angegebenen Reihenfolge aus. Bei jeder Anweisung prüft Docker, ob er die Anweisung aus dem Build-Cache wiederverwenden kann.
[[Kategorie:Docker/Image/best-practice]]


Um schnellere Builds zu gewährleisten, ist es entscheidend, die Funktionsweise des Build-Caches und den Ablauf der Cache-Invalidierung zu verstehen. Weitere Informationen zum Docker-Build-Cache und zur Optimierung Ihrer Builds finden Sie unter [https://docs.docker.com/build/cache/ Docker-Build-Cache].
</noinclude>
 
== [https://docs.docker.com/build/building/best-practices/#pin-base-image-versions Versionen des Basisbildes pinnen] ==
 
Bild-Tags sind veränderbar, das heißt, ein Herausgeber kann ein Tag aktualisieren, sodass es auf ein neues Bild verweist. Dies ist nützlich, da Herausgeber dadurch Tags so anpassen können, dass sie auf neuere Versionen eines Bildes verweisen. Für Sie als Nutzer des Bildes bedeutet dies, dass Sie automatisch die neue Version erhalten, wenn Sie Ihr Bild neu erstellen.
 
Wenn Sie beispielsweise in Ihrer Dockerfile-Datei <tt>FROM alpine:3.21</tt> angeben, wird <tt>3.21</tt> als die aktuellste Patch-Version für <tt>3.21</tt> interpretiert.
 
<nowiki># syntax=docker/dockerfile:1</nowiki>
[https://docs.docker.com/reference/dockerfile/#from FROM] alpine:3.21
 
Zu einem bestimmten Zeitpunkt könnte das Tag <tt>3.21</tt> auf die Version 3.21.1 des Images verweisen. Wenn Sie das Image drei Monate später neu erstellen, könnte dasselbe Tag auf eine andere Version verweisen, beispielsweise 3.21.4. Dieser Veröffentlichungsworkflow entspricht den Best Practices, und die meisten Herausgeber wenden diese Tagging-Strategie an, sie ist jedoch nicht zwingend vorgeschrieben.
 
Der Nachteil dabei ist, dass nicht garantiert ist, dass Sie bei jedem Build dasselbe erhalten. Dies könnte zu kompatibilitätsbrechenden Änderungen führen, und es bedeutet außerdem, dass Sie keinen Nachweis über die genauen Image-Versionen haben, die Sie verwenden.
 
Um die Integrität Ihrer Lieferkette vollständig zu gewährleisten, können Sie die Image-Version an einen bestimmten Digest binden. Indem Sie Ihre Images an einen Digest binden, stellen Sie sicher, dass immer dieselbe Image-Version verwendet wird, selbst wenn ein Herausgeber das Tag durch ein neues Image ersetzt. Das folgende Dockerfile bindet beispielsweise das Alpine-Image an dasselbe Tag wie zuvor, <tt>3.21</tt>, diesmal jedoch zusätzlich mit einem Digest-Verweis.
 
<nowiki># syntax=docker/dockerfile:1</nowiki>
[https://docs.docker.com/reference/dockerfile/#from FROM] alpine:3.21@sha256:a8560b36e8b8210634f77d9f7f9efd7ffa463e380b75e2e74aff4511df3ef88c
 
Mit diesem Dockerfile würden Ihre Builds auch dann, wenn der Herausgeber das Tag <tt>3.21</tt> aktualisiert, weiterhin die festgelegte Image-Version verwenden: <tt>a8560b36e8b8210634f77d9f7f9efd7ffa463e380b75e2e74aff4511df3ef88c</tt>.
 
Das hilft Ihnen zwar, unerwartete Änderungen zu vermeiden, ist aber auch mühsamer, da Sie jedes Mal, wenn Sie das Basis-Image aktualisieren möchten, den Image-Digest für die jeweiligen Versionen manuell nachschlagen und einfügen müssen. Außerdem verzichten Sie damit auf automatische Sicherheitsupdates, die Sie wahrscheinlich gerne erhalten möchten.
 
Die Standardrichtlinie [https://docs.docker.com/scout/policy/#no-outdated-base-images Keine veralteten Basis-Images von Docker Scout] prüft, ob die von Ihnen verwendete Basis-Image-Version tatsächlich die aktuellste ist. Diese Richtlinie prüft außerdem, ob die in Ihrem Dockerfile festgelegten Digests der richtigen Version entsprechen. Wenn ein Herausgeber ein Image aktualisiert, das Sie fixiert haben, gibt die Richtlinienauswertung den Status „nicht konform“ zurück, was darauf hinweist, dass Sie Ihr Image aktualisieren sollten.
 
Um Ihre Basis-Images automatisch auf dem neuesten Stand zu halten, verwenden Sie [https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates GitHub Dependabot] mit <tt>package-ecosystem: „docker“</tt>. Dependabot erstellt Pull-Anfragen, um die Tags und Digests Ihrer Basis-Images nach einem festgelegten Zeitplan zu aktualisieren. Dies ist besser als die Verwendung eines Tags, das die Version automatisch ändert, da Sie die Kontrolle behalten und über einen Prüfpfad verfügen, aus dem hervorgeht, wann und wie die Änderung erfolgte.
 
Sie können die verfügbaren Updates für Basis-Images auch über die Befehlszeile mit [https://docs.docker.com/reference/cli/docker/scout/recommendations/ docker scout recommendations] einsehen.
 
== [https://docs.docker.com/build/building/best-practices/#build-and-test-your-images-in-ci Erstellen und testen Sie Ihre Images in CI] ==
 
Wenn Sie eine Änderung in die Versionsverwaltung einchecken oder einen Pull-Request erstellen, verwenden Sie [https://docs.docker.com/build/ci/github-actions/ GitHub Actions] oder eine andere CI/CD-Pipeline, um ein Docker-Image automatisch zu erstellen, mit einem Tag zu versehen und zu testen.
 
# [[Docker/Image/best-practice/Dockerfile]]

Aktuelle Version vom 20. November 2026, 10:59 Uhr