igergov.com
← Artikel
DevOpsDockerSicherheit · 3 Min. · BG EN ES DE

Docker Build-Secrets und Cache: Warum bleibt der Schritt CACHED?

Warum ein Secret-Wechsel keinen neuen Build-Schritt anfordert. Docker Build-Secrets und Cache, CACHEBUST, --no-cache-filter und Grenzen der Prüfung.

Angenommen, ein Docker-Build-Schritt lädt Abhängigkeiten aus einer privaten Paketregistrierung. Das als Build-Secret übergebene Token wird ausgetauscht. Beim nächsten Build zeigt derselbe Schritt CACHED an. Alle anderen für den Cache relevanten Eingaben sind unverändert. Wurde das neue Token überhaupt verwendet?

Das ist ein hypothetischer Fall, kein nachgestellter Versuch. Die Erklärung folgt der Docker-Dokumentation für Builds mit BuildKit, nicht dem Verhalten sämtlicher Werkzeuge zum Erstellen von Container-Images. (docs.docker.com)

Der Wert ist nicht die Kennung

Docker stellt ausdrücklich klar: Ein geänderter Wert eines Build-Secrets macht den Cache nicht ungültig. Die Kennung und der Einhängepfad fließen dagegen in die Cache-Prüfsumme ein. Änderungen anderer Eingaben können ebenfalls eine erneute Ausführung auslösen. (docs.docker.com)

Die technische Schlussfolgerung ist begrenzt: CACHED belegt nicht, dass das neue Token verwendet wurde. Ein wiederverwendetes Ergebnis prüft keine aktuellen Zugriffsrechte. Das folgt daraus, dass der geheime Wert nicht in die Prüfsumme eingeht. (docs.docker.com)

Ein Secret bereitzustellen fordert keine Wiederholung an

Bei einem Secret-Mount stellt der Client das Secret über –secret bereit. Die betreffende RUN-Anweisung nutzt es über den Mount. Das Secret ist während der Ausführung vorübergehend verfügbar. Das beschreibt die Bereitstellung, nicht die Anforderung einer erneuten Ausführung. (docs.docker.com)

Das Token darf nicht zur Cache-Änderung in ein Build-Argument oder eine ENV-Anweisung im Dockerfile verschoben werden. Docker warnt davor, diese Mechanismen für Secrets zu verwenden. Argumentwerte können in Image-Metadaten oder im Image-Verlauf verbleiben. (docs.docker.com)

Zwei Wege zur erneuten Ausführung

Eine Möglichkeit ist ein separates, nicht vertrauliches Build-Argument, etwa CACHEBUST. Es wird in der betreffenden Stufe vor der entsprechenden RUN-Anweisung als ARG deklariert. Beim Tokenwechsel wird auch die über –build-arg übergebene Revision geändert. Ein geänderter Argumentwert führt bei der ersten Verwendung zu einem Cache-Miss, einschließlich der impliziten Verwendung durch eine nachfolgende RUN-Anweisung, nicht bei der ARG-Deklaration selbst. (docs.docker.com)

Die andere Möglichkeit ist –no-cache-filter. Damit werden benannte Stufen angegeben, deren Build-Cache ignoriert werden soll. Liegt der Download der Abhängigkeiten in einer Stufe namens install, wird diese ausgewählt. Der Filter erwartet Stufennamen, keine Secret-Kennungen. Das legt den Umfang der erneuten Ausführung fest; es ist kein Authentifizierungstest. (docs.docker.com)

Ein Mount verhindert nicht jede Offenlegung

Der BuildKit-Leitfaden erkennt ausdrücklich an, dass ein laufender Build ein eingebundenes Secret lesen kann. Der Mount schützt daher nicht vor einem Befehl, der das Token ausgibt oder kopiert. Das verlinkte Dokument liegt auf master: ein fortgeschriebener Leitfaden, keine Spezifikation für eine festgelegte Version. (github.com)

Was als Nächstes zu prüfen ist

Zuerst ist das Prüfziel zu klären. Muss lediglich der Schritt für die Abhängigkeiten erneut laufen, oder soll festgestellt werden, dass die Registrierung die neuen Zugangsdaten akzeptiert? Für Letzteres sind Belege für eine tatsächliche authentifizierte Anfrage nötig, ohne das Secret offenzulegen. Der allgemeine Build-Status darf dieses Kriterium nicht ersetzen.

Den breiteren Zusammenhang von Docker und CI erklärt Eine App, zehn Probleme. Hier ist der nächste Diagnoseschritt enger gefasst. (igergov.com)

Welche konkrete Build-Stufe muss tatsächlich erneut ausgeführt werden?

Quellen