Docker のトラブルシューティング

JetBrains は、 Docker プラグインの修正と改善に常に取り組んでいます。既知の Docker の問題と機能リクエストのリスト(英語)をバグ追跡システムで見つけて、最も影響を受けるものに投票できます。独自のバグや機能リクエストを提出することもできます。

次の問題のいずれかが発生した場合は、対応する推奨される解決策を試してください：

RubyMine から Docker デーモンに接続できません

以下を確認してください：

詳細については、 Docker 接続設定を参照してください。

ローカルマシンに Docker CLI がインストールされていません

イメージをビルドするか Docker Compose を実行すると、次のエラーメッセージが表示されます:

                Docker CLI must be installed on the local machine, even when the Docker Engine is accessed over SSH.
            
   

RubyMine は、Docker エンジンがリモートサーバー上にある場合でも、マシン上で Docker CLI を実行します。 Docker Desktop をインストールするか、Docker CLI を別途インストールするか、 RubyMine から Docker CLI をダウンロードしてください。

Docker Compose でマルチコンテナアプリケーションを実行できません

設定ダイアログの Ctrl+Alt+S で Docker Compose 実行可能ファイルが正しく指定されていることを確認してください（ビルド、実行、デプロイ | Docker | ツールの下）詳細については、 Docker 接続設定を参照してください。

Ubuntu で Unix ソケット設定経由の Docker Compose が動作しません

Ubuntu で Docker Compose を実行すると、次のエラーメッセージが表示されます：

                docker.errors.TLSParameterError: Path to a certificate and key files must be provided through the client_config param.
                TLS configurations should map the Docker CLI client configurations.

この場合、エンジン API URL フィールドで unix:///var/run/docker.sock を指定した TCP ソケット接続を使用します。詳細については、 TCP ソケットを参照してください。

ポートバインディングを使用できません

該当するコンテナポートが Exposed されていることを確認してください。 EXPOSE コマンドを Dockerfile に記述してください。

レジストリからイメージをプルできません

レジストリから Docker イメージを取得しようとすると、次のメッセージが表示されます：

                Failed to parse dockerCfgFile: <your_home_dir>/.docker/config.json, caused by: ...
                {"credsStore":"wincred"}

この場合、 <your_home_dir>/.docker ディレクトリに移動し、 config.json ファイルを削除します。

Dockerfile および Docker Compose ファイルを正しいタイプに関連付けできません

デフォルトでは、RubyMine は命名や内容によって Dockerfile および Docker Compose ファイルを識別できるはずです。これにより、補完候補、インスペクション、ガターアイコンなど、これらのファイルのさまざまなコーディング支援機能が有効になります。 RubyMine がファイルを認識しない場合は、ファイルの種類を手動で指定するよう求められます。既存のファイルを正しいタイプに関連付けるには、プロジェクトツールウィンドウでそのファイルを右クリックし、コンテキストメニューからファイルタイプと関連付け… を選択します。

ファイルタイプと関連付け… アクションが無効になっている場合は、ファイル名が他のファイルタイプのパターンとして登録されている可能性があります。例: テキストファイルとして認識されるカスタム名を持つ Dockerfile がある場合、それを Dockerfile タイプに関連付けることはできません。ファイルタイプパターンを削除するには、次の手順を実行します。

Ctrl+Alt+S を押して設定を開き、エディター | ファイルタイプを選択します。
該当するファイルタイプ（この場合はテキスト）を選択し、ファイル名でパターンを削除します。
変更を適用するには、 OK をクリックします。

コンテキストメニューでファイルタイプと関連付け… を使用して正しいファイルタイプを設定できるようになりました。

サービス経由で Docker に接続すると CPU 使用率が高くなります

Windows で Docker サービスのバックエンドとして Hyper-V を使用している場合、ウイルス対策ソフトウェアが Hyper-V の仮想ディスクファイル ( .vhdx ) を継続的にスキャンします。これにより、コンテナが実行されていなくても、CPU リソースが過剰に消費される原因となります。

この場合、Hyper-V 仮想ディスクファイルをウイルス対策スキャンから除外します。

2026 年 11 月 9 日