docker『Invalid Reference Format』の原因と対処法
- 2025.11.19
docker run / pull / build / compose などで指定したイメージ名やタグの書き方がDockerのルールに合っていないときに出るエラー。スペースやコロンの位置、レジストリ名・リポジトリ名・タグの混同、シェル変数の書き方ミス、docker-compose.yml の記述揺れ […]
docker run / pull / build / compose などで指定したイメージ名やタグの書き方がDockerのルールに合っていないときに出るエラー。スペースやコロンの位置、レジストリ名・リポジトリ名・タグの混同、シェル変数の書き方ミス、docker-compose.yml の記述揺れ […]
「Connection refused」は、TCPレベルで「そのアドレス・ポートに対応するプロセスが現在いない」ことを意味する。Dockerでは、コンテナ内アプリが指定ポートで待ち受けていない、ホスト側ポートのマッピングミス、コンテナ間ネットワークの設定違い、ファイアウォールやプロキシの干渉、起動順 […]
指定したコンテナイメージが見つからず、pull/run/build/compose 時に失敗する状態。典型原因は「リポジトリ名/タグの誤り」「レジストリの可視性・認可不足」「デフォルトレジストリの誤解(docker.io/library)」「マニフェスト未公開(タグは表示されても実体が無い)」「ネッ […]
「実行形式が不正」の意味で、カーネルがそのファイルを実行可能バイナリ/スクリプトとして解釈できないときに発生。多くは“アーキテクチャ不一致(arm64上でamd64バイナリなど)”“Windows行末/UTF-8 BOM付きのエントリポイント”“シェル/インタプリタ不在”“実行ビット欠如・誤ったEN […]
Docker/Composeでサービスが起動できず停止・再試行を繰り返す状態。典型原因は「コンテナの実行失敗(ENTRYPOINT/CMD/権限)」「ポート競合」「ボリューム/バインドマウントの不整合」「依存サービス未起動」「リソース不足(メモリ/ディスク/ulimit)」「設定値の不正(環境変数・ […]
コンテナが即終了・異常終了・シグナルによる終了を示すステータス。まず「終了コード」「直前ログ」「エントリーポイント」「リソース制限」「シグナル(SIGKILL/SIGTERM)」を突き合わせ、原因を特定してから再実行条件や設定を修正する。 終了コードの読み方(代表パターン早見) まず行う最短切り分け […]
ホストのパスをコンテナへバインドマウントする際に失敗する問題。源流は「ソースパスの不存在」「権限/SELinux/AppArmor」「Docker Desktopのファイル共有未許可」「WSL2/Windowsパスの扱い」「rootless/userns制約」「相対パス・作業ディレクトリの誤認」「フ […]
ディスクの空き容量(バイト)またはiノード数が枯渇すると、イメージpull/ビルド/コンテナ起動/ログ書込みが失敗する。まず「どのパーティション・どのリソース(容量 or iノード or Docker専用領域)」が詰まっているかを特定し、不要アーティファクト削除・ログ圧縮・ビルドキャッシュの破棄・デ […]
「権限がない」系エラーは大きく2種類に分かれる。①クライアントがDockerデーモンへ接続できない(/var/run/docker.sock など)②コンテナ内/ボリューム/ホストファイルのアクセスが拒否される。まず「どの層で拒否されたか(デーモン接続・ホストFS・コンテナFS・セキュリティ機構)」 […]
Google Apps ScriptからDrive(DriveAppまたは高度なDrive API)を操作した際に、サーバ側で処理できず失敗したときに出る汎用エラー。権限・共有ドライブのロール不備、ID/URLの取り違え、ゴミ箱・削除、MIME不一致、サイズ超過、レート/同時実行超過、一時障害などが […]