CLion 2026.2 Help

ターゲットをリモートで実行(Gradle、Rust)

特定の 実行 / デバッグ構成では、クラウドや Dockerコンテナーなどの別の環境でコードをCLionから直接実行できます。

この機能を使えば、アプリが想定されている本番環境で変更を即座にテストできます。 これにより、本番環境に移行する際の非互換性がなくなり、特に環境に依存するコード作成時に重要です。 この機能によって、アプリの変更ごとに通常必要なデプロイや実行の追加アクションも不要になります。

前提条件

アプリの実行に使用する環境は ターゲットと呼ばれます。 CLionでターゲット上でコードを実行するには、ターゲットに 言語ランタイムを定義する必要があります。これは、実行 / デバッグ構成でコードを実行する際にターゲットで利用できるものを示します。

ターゲット上でコードを実行するには、通常ローカル実行に使用する 実行 / デバッグ構成でターゲット実行環境を定義するだけです。 それを行った後、ターゲットでアプリを起動することは、ローカルで起動することと同じです。

サポートされている実行 / デバッグ構成タイプ

次の 実行/デバッグ構成は、リモートターゲットで実行できます:

実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集​ に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ構成ダイアログで、ツールバーの 追加 ボタン 追加ボタン をクリックするか、 Alt+Insert を押します。 リストには、実行 / デバッグ構成 テンプレートが表示されます。

  3. サポートされている実行 / デバッグ構成タイプの 1 つを選択します。

  4. すでにターゲットを定義している場合は、 実行 メニューからターゲットを選択します。 それ以外の場合は、 ターゲットの管理… をクリックして新しいターゲットを追加します。 特定のターゲットタイプの構成の詳細については、次の手順を参照してください。

実行 / デバッグ構成テンプレートで実行ターゲットを構成することもできるため、次にその型の新しい構成を作成するときに、そのパラメーターにはすでに目的の値があります。 詳細については、 テンプレートのデフォルト値を構成する を参照してください。

実行

リモートターゲットでアプリを実行するプロシージャは、ローカルで実行する場合と同じです:

  1. メインツールバーで実行 / デバッグ構成を選択します。

  2. 実行ボタン をクリックするか、 Shift+F10 を押します。

CLionはアーティファクトをビルドし、その後ターゲットにコピーします。 その後、指定されたランタイムを使用してターゲット上でアプリを実行します。

ターゲットタイプ

ターゲットは、アプリケーションが実行される環境の構成を記述します。

リモートターゲットを作成すると、CLionはリモート環境で使用可能なランタイムを自動的に検出します。 必要に応じて、追加のランタイムを手動で構成できます。

SSH

  1. 既存の SSH 構成を使用するか、新しい構成を作成するかを選択します。

    SSH リストから既存のSSH 構成を選択し、 次へ をクリックします。 SSH の構成の詳細については、 SSH 構成の作成を参照してください。

    1. SSH サーバーの IP、SSH 接続がリッスンしているポート、アプリケーションを実行するサーバーマシン上のユーザー名を入力します。 次へ をクリックします。

    2. 接続が確立されるのを待ちます。 資格情報を持つエージェントが存在する場合、追加の構成は必要ありません。 それ以外の場合は、認証方法を選択し、必要な値を入力します。

      • パスワード: パスワードを入力します。

      • キーペア (OpenSSH または PuTTY): この認証方法を適用するには、クライアントマシンに秘密鍵があり、リモートサーバーに公開鍵が必要です。 CLionは OpenSSHユーティリティで生成する秘密鍵をサポートします。

        秘密鍵が保存されているファイルへのパスを指定し、パスフレーズ (存在する場合) を対応するフィールドに入力します。 CLion にパスフレーズを記憶させるには、 パスフレーズを保存 チェックボックスを選択します。

      次へ をクリックします。

  2. SSH サーバーのイントロスペクションが完了するのを待ちます。 このステップの間、CLionは環境で使用可能な言語ランタイムを識別しようとします。 次へ をクリックします。

    run-targets-ssh-introspection.png
  3. 次のプロパティを構成します:

    • rsync を使用する: ファイル転送に rsync(英語) を使用するには、このオプションを切り替えます。 通常、ファイルのコピーが高速化されるため、これをお勧めします。

    • ターゲット上のプロジェクトパス: プロジェクトファイルの保存に使用されるサーバー上のパス。

  4. 言語ランタイムを追加します。 ランタイムごとに、サーバー上のバージョンとパスを指定します。 この環境をターゲットとして選択すると、構成された設定が実行 / デバッグ構成の ビルドと実行 セクションに表示されます。

    次のランタイムを使用できます:

    • Java: アプリケーションの実行に適したサーバー上の JDK。 このランタイムタイプを選択すると、アプリケーションはローカルでビルドされ、宛先にコピーされます

    • Maven(メイヴン): サーバーに Maven がインストールされています。 このランタイムタイプを選択すると、ソースとライブラリがサーバーにコピーされ、そこでビルドされて実行されます。

    run-targets-ssh-runtime.png

Docker

  1. Docker サポートを有効にする説明に従って、 Docker サーバー を選択または構成します。

  2. Windows および macOS の場合 – Docker がワークフローで使用されるすべてのフォルダー (プロジェクトフォルダー、 .maven など) にアクセスできることを確認してください。 詳細については、 公式の Docker ドキュメント(英語)を参照してください。

  3. イメージをローカルでビルドするか、Docker レジストリからプルするかを選択します。

    • Dockerfile: イメージの構築に使用される Dockerfile。

    • コンテキストフォルダー: ビルド中に Docker デーモンがその内容にアクセスして、後でイメージファイルシステムで使用するフォルダー。

    • コードを実行する前に毎回自動的にイメージを再ビルドする: このオプションを設定すると、コードが実行されるたびにイメージが再構築されます。 それ以外の場合、CLionは既存のイメージ(存在する場合)を使用します。

    さらに、以下を指定できます:

    • イメージタグ: ビルドされたイメージの名前とタグを指定します。 docker build-t オプションを使用するのと同様です。

    • ビルドオプション: docker build コマンドに任意のオプションを指定します。

    • ビルド引数: デフォルトのビルド時変数をオーバーライドします(英語)docker build--build-arg オプションを使用するのと同じです。

    • 実行オプション: docker run コマンドに任意のオプションを指定します。

    • イメージタグ: レジストリから取得するイメージの完全な座標を指定します。 リポジトリのみが指定されている場合は、デフォルトの :latest タグが使用されます。

    • 実行オプション: docker run コマンドに任意のオプションを指定します。

  4. コンテナーのイントロスペクションが完了するのを待ちます。 このステップの間、CLionは環境で使用可能な言語ランタイムを識別しようとします。 次へ をクリックします。

  5. 必要に応じて、言語ランタイムを構成します。 次の場合に必要になることがあります。

    • 複雑なイメージがある場合 (たとえば、複数の JDK を使用する場合)。 プライマリランタイムは自動的に識別されます。 ただし、追加のランタイムは手動で構成する必要があります。

    • イントロスペクションは失敗します。 ほとんどの場合、CLionは手順 1 のコンテキストに基づいてプライマリランタイムを正しく識別します。 これが発生しない場合は、プライマリランタイムを手動で変更します。

    ランタイムごとに、コンテナーでそのバージョンとパスを指定します。 この環境をターゲットとして選択すると、構成されたランタイムが実行 / デバッグ構成の ビルドと実行 セクションに表示されます。

    次のランタイムを使用できます:

    • Java: アプリケーションの実行に適した JDK。 このランタイムタイプを選択すると、アプリケーションはローカルでビルドされ、宛先にコピーされます

    • Maven(メイヴン): コンテナー内の Maven。 このランタイムタイプを選択すると、ソースとライブラリがコンテナーにコピーされ、そこでビルドされて実行されます。

Docker Compose

単一のDocker Compose サービスを実行ターゲットとして使用できます。

  1. Docker サポートを有効にする説明に従って、 Docker サーバー を選択または構成します。

  2. Windows および macOS の場合 – Docker がワークフローで使用されるすべてのフォルダー (プロジェクトフォルダー、 .maven など) にアクセスできることを確認してください。 詳細については、 公式の Docker ドキュメント(英語)を参照してください。

  3. Docker Compose 構成ファイルを指定し、必要なサービスを選択し、追加の環境変数を指定します。 次へ をクリックします。

  4. Docker Compose サービスのイントロスペクションが完了するのを待ちます。 このステップの間、CLionは環境で使用可能な言語ランタイムを識別しようとします。 次へ をクリックします。

  5. 必要に応じて、言語ランタイムを構成します。 これは、次の場合に必要になることがあります。

    • 複数のランタイムを持つ複雑なサービスがある場合、CLionはプライマリサービスを自動的に識別します。 ただし、追加のランタイムは手動で構成する必要があります。

    • イントロスペクションが失敗した場合は、プライマリランタイムを手動で変更します。

    ランタイムごとに、コンテナーでそのバージョンとパスを指定します。 この環境をターゲットとして選択すると、構成されたランタイムが実行 / デバッグ構成の ビルドと実行 セクションに表示されます。

    次のランタイムを使用できます:

    • Java: コンテナーで使用可能な Java ランタイムがある場合、アプリケーションはローカルでビルドされてから、ターゲットにコピーされます。

    • Maven(メイヴン) および Gradle: コンテナーに Maven または Gradle がある場合、ソースとライブラリがコンテナーにコピーされ、そこでビルドおよび実行されます。

2026 年 7 月 15 日