llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

チュートリアル: Dev Containers 入門。?

このチュートリアルでは、ローカルプロジェクト用の Dev Container 構成を作成し、コンテナーをビルドして、その中でプロジェクトを開きます。 最後に、実行中のコンテナーと、それに接続された IDE ウィンドウが用意されます。

始める前に

  • Docker がマシンにインストールされ、Docker デーモンが実行されています。 CLion は Docker を通じてコンテナーをビルドするため、デーモンが停止しているとビルドは失敗します。

  • Docker プラグイン がインストールされ、有効になっています。

  • CLion でローカルプロジェクトを開いています。

リモート Dev Containers を含む要件の完全なリストについては、 前提条件 を参照してください。

ステップ 1。 プロジェクトを準備する

devcontainer.json は Dev Containers をビルドするために必要な構成ファイルであるため、プロジェクト内に存在している必要があります。 このファイルはプロジェクトルートの .devcontainer フォルダーに配置されます。 .devcontainer/.../.../devcontainer.json のように、その間に別のフォルダーがある場合もあります。

Dev Containers の作成をすばやく開始するには、2 つのオプションがあります: シンプルなファイルを作成するか、IDE 内の機能を使用してテンプレートから構成ファイルを作成します。

Dev Container の最小要件は、ビルド元となるイメージです。

  1. プロジェクトビューでプロジェクト名を右クリックし、 新規 | ファイル を選択します。

  2. .devcontainer/devcontainer.json を入力して、プロジェクトルート下の .devcontainer ディレクトリに構成を作成します。

  3. エディターでファイルを開き、次のコードを追加します:

    { image: "ubuntu:latest" }
  1. プロジェクトビューでプロジェクト名を右クリックし、 新規 | Dev Container 構成 を選択します。

  2. 開いたダイアログで、CLion はデフォルトのコンテナー構成を表示します。 デフォルトのテンプレートで Dev Container を作成するには十分ですが、必要に応じて Dev Container テンプレート ドロップダウンから他の言語固有のテンプレートを選択できます。

    OK をクリックして、比較的シンプルな (ただしコメントが多い) devcontainer.json を作成します:

    // Default Ubuntu-based DevContainer Template. // For more customization options, see https://containers.dev/implementors/json_reference { name: "Default", image: "ubuntu:latest", customizations : { // Configure JetBrains IDE-specific properties jetbrains : { backend : "IntelliJ", settings : { // IDE settings can be added via “Show context actions”|“Add currently modified settings from IDE”. // A complete list of supported settings is also available through auto-completion }, plugins: [ // A set of plugin IDs. // Plugin ID can be found on the corresponding plugin’s page at https://plugins.jetbrains.com. ] } }, features: { "ghcr.io/devcontainers/features/git" : {}, // Add additional features to your project using auto-completion. }, // Comment out to connect as the root user. remoteUser: "ubuntu" }

ステップ 1. ビルドプロセスを準備する

Dev Container をビルドする前に、使用する Dev Container 実装を検討してください:

  • Remote Development の旧実装では、 Dev Container プロジェクトをネイティブに開く オプションが 設定 | 詳細設定 で無効になっていることを確認してください。

  • ネイティブモード実装を使用する場合は、 Dev Container プロジェクトをネイティブに開く オプションを 設定 | 詳細設定 で有効化します。

さらに、Remote Development 実装を使用する場合は、拡張されたバックエンドの選択肢を提供するように IDE を設定することをおすすめします。

Dev Containers の特定の IDE バックエンドバージョンを選択する

  1. Ctrl+Alt+S を押して設定を開き、 詳細設定 を選択します。

  2. 右側のオプションの Dev Container セクションで、 バックエンドのバージョンを自動的に選択する を無効化し、 OK をクリックして変更を保存します。

  3. このオプションを無効化すると、Dev Container のビルド後に複数のバックエンドバージョンが使用可能になります。

カスタムリモート開発バックエンドを使用するには (たとえば、未公開の IDE ビルドの問題を確認する場合)、次の手順を実行します:

IDE バックエンドを手動でダウンロードする

  1. ダウンロード ページを開きます。

  2. Dev Containers では現在 Linux ベースのイメージのみがサポートされているため、 Linux をオペレーティングシステムとして選択します。

  3. Docker エンジンが実行されているホストに対応するアーキテクチャのアーカイブをダウンロードします。

  4. メインメニューで 移動 | どこでも検索 に移動するか、 Shift を2回押して検索ウィンドウを開きます。

  5. registry と入力し、 レジストリ… オプションを選択します。

  6. 開いたウィンドウで devcontainers.use.separate.project.panel キーを検索し、有効化します。 閉じる をクリックします。

  7. IDE を再起動します。

  8. レジストリキーが有効化された後、Dev Container のビルドを開始します。

  9. IDE とプロジェクトを選択 ウィンドウが開いたら、 インストールオプション リンクをクリックし、 インストーラファイルのアップロード アクションを選択します。

  10. IDE バージョン フィールドが アーカイブを選択 ファイルに変わります。

  11. ダウンロードした IDE バックエンドアーカイブへのパスを指定します。

  12. Dev Container のビルドプロセスを続行します。

ステップ 2. Dev Container のビルドを開始する

  1. .devcontainer/devcontainer.json を開きます。 ガターの Dev Containers アイコンをクリックし、 Dev Container を作成し、ソースをマウント… を選択します。 バックエンド IDE の選択を求められた場合は、CLion を選択します。

  2. ビルドが開始されると、ビルドプロセスを表示するために Services ビューが自動的に開きます:

  3. 選択した実装 (Remote Development とネイティブモード) に応じて、以降のフローが少し異なります。

    リストからバックエンドバージョンを選択し、それと Client がダウンロードされるまで待ちます:

    場合によっては、Dev Container のビルドとバックエンドデプロイプロセスに 10 秒を超える時間がかかると、Client は開かれず、代わりに IDE に 接続 ボタン付きの通知が表示されます。 ボタンを押します。

    次のウィンドウで プロジェクトを信頼 ボタンを押し、Client が開くまで待ちます:

    すでに Dev Container 内で開かれたプロジェクトであるかどうかを確認するにはどうすればよいですか? 左上の バックエンドのステータス詳細 ウィジェットで確認できます。

    バックエンドデプロイ手順がないため、Dev Container プロジェクトは IDE ですぐに開かれます。 プロジェクトを開く先 オプション (設定 | 外観 & 振る舞い | システム設定 内) が 依頼します に設定されている場合、確認後にプロジェクトが開かれます。

    プロジェクトがネイティブモードを使用する Dev Container 内で開かれているかどうかを確認するには、通常とは異なるプロジェクトルートパスと、エディターの左上に Dev Container 情報を表示するウィジェットを確認してください。

    Dev Container ウィジェット
2026 年 11 月 6 日