docker buildx inspect コマンドでビルダー詳細を確認する方法 | Docker ガイド

はじめに

この実験では、Docker ビルダーインスタンスの詳細を確認するためにdocker buildx inspectコマンドを使用する方法を学びます。まず現在のビルダーインスタンスを検査し、次に名前を指定してビルダーを選択する方法を学習します。

また、--bootstrapフラグを使用して検査前にビルダーが実行されていることを確認する方法や、--debugフラグでより詳細な情報を取得する方法についても探求します。これにより、ビルダーの設定と状態について包括的な理解を得ることができます。

Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL docker(("Docker")) -.-> docker/ContainerOperationsGroup(["Container Operations"]) docker(("Docker")) -.-> docker/DockerfileGroup(["Dockerfile"]) docker/ContainerOperationsGroup -.-> docker/inspect("Inspect Container") docker/DockerfileGroup -.-> docker/build("Build Image from Dockerfile") subgraph Lab Skills docker/inspect -.-> lab-555059{{"docker buildx inspect コマンドでビルダーの詳細を確認する方法"}} docker/build -.-> lab-555059{{"docker buildx inspect コマンドでビルダーの詳細を確認する方法"}} end

現在のビルダーインスタンスを検査する

このステップでは、現在の Docker ビルダーインスタンスを検査する方法を学びます。Docker ビルダーは Docker イメージのビルドを担当しています。ビルダーを検査することで、その設定と状態に関する情報を取得できます。

まず、ビルダー名を指定せずにdocker buildx inspectコマンドを使用します。これにより現在のビルダーインスタンスが検査されます。

docker buildx inspect

デフォルトのビルダーインスタンスに関する詳細が表示され、以下のような出力が得られるはずです：

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

この出力には、ビルダー名、使用しているドライバー（この場合はdocker）、ビルドノードの詳細（ステータス、BuildKitd バージョン、サポートされているプラットフォームなど）が含まれています。

名前を指定して特定のビルダーインスタンスを検査する

前のステップでは、現在のビルダーインスタンスを検査しました。このステップでは、名前を指定して特定のビルダーインスタンスを検査する方法を学びます。最初はデフォルトのビルダーしかないかもしれませんが、複数のビルダーが設定されている場合に名前を指定する方法を知っておくと便利です。

特定のビルダーインスタンスを検査するには、docker buildx inspectコマンドの後にビルダー名を指定します。デフォルトのビルダーは通常defaultという名前です。

明示的にdefaultビルダーを名前で検査してみましょう：

docker buildx inspect default

前のステップと同じ出力が表示され、defaultビルダーインスタンスを検査していることが確認できます。

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

このように、名前を使用して特定のビルダーインスタンスをターゲットにして検査する方法を示しました。

検査前にビルダーが実行されていることを確認する (--bootstrap オプション使用)

このステップでは、docker buildx inspect コマンドで --bootstrap フラグを使用する方法を学びます。このフラグは、ビルダーインスタンスの検査を試みる前に、ビルダーが実行されていることを保証します。ビルダーが停止している場合、このフラグによって起動されます。

デフォルトのビルダーは通常実行されていますが、検査やその他のビルド操作の前にビルダーが確実に動作していることを保証したい場合に --bootstrap を使用するのが良い習慣です。

--bootstrap フラグを使用して、再度デフォルトビルダーを検査してみましょう：

docker buildx inspect --bootstrap default

以前と同じ検査結果が表示されるはずです。--bootstrap フラグは、検査が行われる前にビルダーが実行状態にあることを保証します。もしビルダーが停止していた場合、このコマンドはまずビルダーを起動します。

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

--bootstrap の使用は、ビルドを進める前にビルダーが準備できていることを確認する必要があるスクリプトや自動化ワークフローで特に有用です。

詳細情報を表示する (--debug オプション使用)

この最終ステップでは、docker buildx inspect コマンドで --debug フラグを使用して、ビルダーインスタンスに関するより詳細な情報を取得する方法を学びます。--debug フラグは、トラブルシューティングやビルダーの設定をより深く理解するのに役立つ追加の出力を提供します。

--debug フラグを含めて、再度デフォルトビルダーを検査してみましょう：

docker buildx inspect --debug default

標準的な検査結果に加えて、デバッグログが先頭に表示されます。これらのログは、buildx inspect コマンドの内部動作や BuildKit デーモンとの通信に関する洞察を提供します。

デバッグ出力には DEBU[... で始まる行が含まれ、プロセスに関する詳細情報が表示されます。これには、行われた API 呼び出し、設定の読み込み、その他の内部動作などが含まれる場合があります。

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

--debug フラグは、問題の診断や docker buildx が基盤となる BuildKit サービスとどのように連携するかを深く理解するための強力なツールです。

まとめ

この実験では、docker buildx inspect コマンドを使用して Docker ビルダーインスタンスの詳細を確認する方法を学びました。最初に名前を指定せずに現在のビルダーインスタンスを検査し、通常はデフォルトビルダーに関する情報が表示されることを確認しました。次に、ビルダー名を明示的に指定して特定のビルダーインスタンスを検査する方法を学び、デフォルトビルダーに対して同じ詳細情報が得られることを確認しました。

これらの手順を通じて、docker buildx inspect の基本的な使用方法を理解し、ビルダー名、ドライバー、ノードの状態、BuildKitd バージョン、サポートされているプラットフォームなど、Docker ビルド環境に関する情報を取得する方法を学びました。