CLion 2024.1 ヘルプ

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

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

この機能を使用すると、アプリが対象としている実際の環境に対して変更を即座にテストできます。これにより、本番環境に移行するときに非互換性が発生しなくなります。これは、環境に大きく依存するコードで作業する場合に特に重要です。

このような環境でアプリを直接実行すると、何かが変更されるたびにアプリをデプロイして実行するために通常必要な余分なアクションも不要になります。

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

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

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

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

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

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

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

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

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

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

実行

リモートターゲットでアプリを実行する手順は、ローカルで実行する場合と同じです。

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

  2. The Run button をクリックするか、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 がある場合、ソースとライブラリがコンテナーにコピーされ、そこでビルドおよび実行されます。

関連ページ:

実行 / デバッグ構成

CLion は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — テスト、テストスイート、フィクスチャ、エントリを実行 / デバッグするたびに作成され、ガターアイコン / を使用します。永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。永続的な構成は、削除...

Docker プラグインの統合

Docker は、分離された再現可能な環境で実行可能ファイルをデプロイおよび実行するためのツールです。これは、たとえば、本番環境と同じ環境でコードをテストする場合に役立ちます。CLion は Docker 機能を統合し、Docker イメージの作成、Docker コンテナーの実行、Docker Compose アプリケーションの管理、パブリックおよびプライベート Docker レジストリの使用など、IDE から直接実行するための支援を提供します。Docker プラグインを有効にするこの機能は、デフ...

Gradle

Gradle は、C/C++ ライブラリとアプリケーションをビルドするためのプラグインを提供するビルド自動化システムです。CLion では、cpp-application および cpp-library プラグインに基づく Gradle プロジェクトで作業できます(C/C++ Gradle プラグインの詳細については、このブログ投稿を参照してください)。新しい C++ プラグインの紹介).CLion での完全に機能する Gradle サポートは開発中です。フィードバックを共有し、このチケットの更新をフォ...

Rust

Rust プラグインは CLion に本格的な Rust サポートを装備する: このガイドでは、始めるための基本的な手順を説明する: サポートされている機能の詳細については、RustRover ドキュメントを参照してください。Rust プラグインをインストールする:Rust プラグインを購入していることを確認してください。CLion を起動します。ウェルカム画面で、プラグインをクリックします。すでにプロジェクトを開いている場合は、設定 () | プラグインに進みます。マーケットプレースタブを選択...

デバッグ

デバッグセッション中、デバッガーはプログラムの実行を妨害し、内部で何が起こっているかに関する情報を提供します。CLion でのデバッグの基礎については、このビデオを参照してください。一般的なデバッグ手順デバッガー設定を構成します。CMake プロジェクトの場合、目的の CMake プロファイルを選択します。必要に応じて、既存の実行 / デバッグ構成を作成または変更します。コードにブレークポイントを配置します。デバッグ <構成名> ボタンをクリックするか、他のオプションを使用してデバッグセ...

WSL2

WSL(WSL 2) – Windows Subsystem for Linux – は、Windows 10 以降で Linux バイナリ実行ファイルをネイティブに実行するための互換性レイヤーです。現在、Ubuntu、OpenSUSE、SLES など、いくつかの Linux ディストリビューションをサポートしています。プロジェクトに WSL ツールチェーンを設定すると、Windows マシンで実行されている CLion を移動せずに、Linux のツールチェーンを使用してビルドし、WSL で実行...