Einführung
In diesem Lab lernen Sie, wie Sie den Befehl docker buildx inspect verwenden, um Details über Ihre Docker-Builder-Instanzen anzuzeigen. Sie beginnen mit der Überprüfung der aktuellen Builder-Instanz und erfahren dann, wie Sie einen Builder anhand seines Namens angeben können.
Außerdem werden Sie untersuchen, wie Sie sicherstellen können, dass ein Builder vor der Überprüfung mit dem Flag --bootstrap läuft, und wie Sie mit dem Flag --debug detailliertere Informationen erhalten. Dadurch erhalten Sie ein umfassendes Verständnis der Konfiguration und des Status Ihres Builders.
Aktuelle Builder-Instanz inspizieren
In diesem Schritt lernen Sie, wie Sie die aktuelle Docker-Builder-Instanz überprüfen können. Der Docker-Builder ist für das Erstellen von Docker-Images verantwortlich. Durch die Überprüfung des Builders erhalten Sie Informationen über dessen Konfiguration und Status.
Zuerst verwenden wir den Befehl docker buildx inspect ohne Angabe eines Builder-Namens. Dadurch wird die aktuelle Builder-Instanz überprüft.
docker buildx inspect
Sie sollten eine ähnliche Ausgabe wie diese sehen, die Details über die Standard-Builder-Instanz anzeigt:
Name: default
Driver: docker
Nodes:
default:
Status: running
Buildkitd:
Version: v0.10.5
Platforms:
- linux/amd64
- linux/arm64
- linux/riscv64
- linux/ppc64le
- linux/s390x
- linux/386
- linux/arm/v7
- linux/arm/v6
Die Ausgabe liefert Informationen wie den Namen des Builders, den verwendeten Treiber (in diesem Fall docker) sowie Details über die Build-Knoten, einschließlich deren Status, BuildKitd-Version und unterstützten Plattformen.
Bestimmte Builder-Instanz nach Namen inspizieren
Im vorherigen Schritt haben Sie die aktuelle Builder-Instanz überprüft. In diesem Schritt lernen Sie, wie Sie eine bestimmte Builder-Instanz anhand ihres Namens untersuchen können. Auch wenn Sie zunächst möglicherweise nur den Standard-Builder haben, ist es nützlich zu wissen, wie man einen Namen angibt, wenn mehrere Builder konfiguriert sind.
Um eine bestimmte Builder-Instanz zu überprüfen, verwenden Sie den Befehl docker buildx inspect gefolgt vom Namen des Builders. Der Standard-Builder heißt typischerweise default.
Lassen Sie uns den default-Builder explizit anhand seines Namens überprüfen:
docker buildx inspect default
Sie sollten dieselbe Ausgabe wie im vorherigen Schritt sehen, was bestätigt, dass Sie die default-Builder-Instanz überprüfen.
Name: default
Driver: docker
Nodes:
default:
Status: running
Buildkitd:
Version: v0.10.5
Platforms:
- linux/amd64
- linux/arm64
- linux/riscv64
- linux/ppc64le
- linux/s390x
- linux/386
- linux/arm/v7
- linux/arm/v6
Dies zeigt, wie Sie eine bestimmte Builder-Instanz gezielt anhand ihres Namens überprüfen können.
Builder vor Inspektion mit --bootstrap sicherstellen
In diesem Schritt lernen Sie, wie Sie das Flag --bootstrap mit docker buildx inspect verwenden. Das --bootstrap-Flag stellt sicher, dass die Builder-Instanz läuft, bevor versucht wird, sie zu inspizieren. Falls der Builder nicht läuft, wird er durch dieses Flag gestartet.
Obwohl der Standard-Builder normalerweise läuft, ist es eine gute Praxis, --bootstrap zu verwenden, wenn Sie sicherstellen möchten, dass der Builder vor der Inspektion oder anderen Build-Operationen aktiv ist.
Lassen Sie uns den Standard-Builder erneut inspizieren, diesmal mit dem --bootstrap-Flag:
docker buildx inspect --bootstrap default
Sie sollten dieselbe Inspektionsausgabe wie zuvor sehen. Das --bootstrap-Flag stellt sicher, dass der Builder sich im laufenden Zustand befindet, bevor die Inspektion durchgeführt wird. Falls der Builder gestoppt war, hätte dieser Befehl ihn zuerst gestartet.
Name: default
Driver: docker
Nodes:
default:
Status: running
Buildkitd:
Version: v0.10.5
Platforms:
- linux/amd64
- linux/arm64
- linux/riscv64
- linux/ppc64le
- linux/s390x
- linux/386
- linux/arm/v7
- linux/arm/v6
Die Verwendung von --bootstrap ist besonders nützlich in Skripten oder automatisierten Workflows, bei denen Sie sicherstellen müssen, dass der Builder bereit ist, bevor Sie mit einem Build fortfahren.
Detaillierte Informationen mit --debug anzeigen
In diesem letzten Schritt lernen Sie, wie Sie mit dem --debug-Flag bei docker buildx inspect detailliertere Informationen über eine Builder-Instanz erhalten. Das --debug-Flag liefert zusätzliche Ausgaben, die bei der Fehlerbehebung oder für ein tieferes Verständnis der Builder-Konfiguration hilfreich sein können.
Lassen Sie uns den Standard-Builder erneut inspizieren, diesmal mit dem --debug-Flag:
docker buildx inspect --debug default
Sie werden die standardmäßige Inspektionsausgabe sehen, der jedoch Debug-Logs vorangestellt sind. Diese Logs geben Einblicke in die internen Abläufe des buildx inspect-Befehls und die Kommunikation mit dem BuildKit-Daemon.
Die Debug-Ausgabe enthält Zeilen, die mit DEBU[... beginnen, gefolgt von detaillierten Informationen über den Prozess. Dies kann beispielsweise API-Aufrufe, das Laden von Konfigurationen und andere interne Vorgänge umfassen.
DEBU[0000] loading config file /home/labex/.docker/config.json
DEBU[0000] Looking for builder "default"
DEBU[0000] found builder "default"
DEBU[0000] loading builder "default"
DEBU[0000] found 1 node(s) for builder "default"
DEBU[0000] loading node "default"
DEBU[0000] connecting to docker
DEBU[0000] running buildkitd container "buildx_buildkit_default"
DEBU[0000] buildkitd container "buildx_buildkit_default" is running
DEBU[0000] connecting to buildkitd
DEBU[0000] buildkitd connection successful
Name: default
Driver: docker
Nodes:
default:
Status: running
Buildkitd:
Version: v0.10.5
Platforms:
- linux/amd64
- linux/arm64
- linux/riscv64
- linux/ppc64le
- linux/s390x
- linux/386
- linux/arm/v7
- linux/arm/v6
Das --debug-Flag ist ein leistungsfähiges Werkzeug zur Diagnose von Problemen oder zum besseren Verständnis der Interaktion zwischen docker buildx und dem zugrundeliegenden BuildKit-Dienst.
Zusammenfassung
In diesem Lab haben Sie gelernt, wie Sie den Befehl docker buildx inspect verwenden, um Details über Docker-Builder-Instanzen anzuzeigen. Sie begannen mit der Inspektion der aktuellen Builder-Instanz ohne Namensangabe, was typischerweise Informationen über den Standard-Builder anzeigt. Anschließend lernten Sie, wie Sie explizit eine bestimmte Builder-Instanz durch Angabe ihres Namens inspizieren, wobei sich bestätigte, dass dies dieselben Details für den Standard-Builder liefert.
Diese Schritte demonstrierten die grundlegende Verwendung von docker buildx inspect, um Einblicke in Ihre Docker-Build-Umgebung zu erhalten, einschließlich des Builder-Namens, des Treibers, des Knotenstatus, der BuildKitd-Version und der unterstützten Plattformen.
