IntelliJ IDEA 2024.1 ヘルプ

ターゲットの実行

IntelliJ IDEA から直接、クラウドや Docker コンテナーなどの別の環境でコードを実行できます。

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

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

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

アプリの実行に使用される環境は、ターゲットと呼ばれます。IntelliJ IDEA がターゲット上でコードを実行するには、ターゲットは言語ランタイムを定義する必要があります。これは、コードを実行するための実行 / デバッグ構成で使用できるターゲット上の何かを表します。例: アプリケーションおよび Maven の実行 / デバッグ構成には、それぞれ JDK および Maven が必要です。

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

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

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

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

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

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

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

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

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

実行

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

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

    Selecting run configuration from the list
  2. The Run button をクリックするか、Shift+F10 を押します。

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

カバレッジのデバッグ、プロファイル、分析

ローカルで実行する場合とまったく同じ方法で、ターゲットで実行される Java アプリケーションのデバッグプロファイリング、およびカバレッジの測定を行うことができます。

ターゲットタイプ

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

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

SSH

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

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

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

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

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

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

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

      次へをクリックします。

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

    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 デーモンがその内容にアクセスして、後でイメージファイルシステムで使用するフォルダー。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Docker Compose

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

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

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

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

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

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

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

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

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

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

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

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

関連ページ:

実行 / デバッグ構成

IntelliJ IDEA は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — 永続的な構成を持たないクラスを実行するたびに作成されます。これは、メソッドを持つクラスの実行を可能にする最低限のものを提供します。永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成...

Docker

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

実行 / デバッグ構成: アプリケーション

この実行 / デバッグ構成は、Java の最も一般的なテンプレートであり、プログラムをでコンパイルしてからで実行することに対応しています。実行構成を開くメインメニューで、に移動します。実行 / デバッグ構成ダイアログで: 新しい構成を作成するには、ツールバーのをクリックするか、を押してアプリケーションを選択します。または、左側のリストで既存のアプリケーション構成をクリックします。右側に、構成オプションが表示されます。名前実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できる...

IntelliJ IDEA を使用してアプリケーションをコンパイルおよびビルドする

IntelliJ IDEA のコンパイルおよびビルドプロセスは、ソースファイルをコンパイルし、外部ライブラリ、プロパティファイル、構成をまとめて、生きたアプリケーションを生成します。IntelliJ IDEA は、Java 仕様に従って動作するコンパイラーを使用します。単一のファイルをコンパイルし、モジュールまたはプロジェクトの増分ビルドを使用して、プロジェクトを最初から再ビルドできます。純粋な Java または Kotlin プロジェクトがある場合、IntelliJ IDEA はビルドプロセス...

JUnit 5

このチュートリアルでは、プロジェクト用に JUnit をセットアップし、テストを作成し、実行して、コードが正しく動作しているかどうかを確認する方法を学習します。それは始めるための基本的なステップだけを含んでいます。JUnit について詳しく知りたい場合は、公式ドキュメントを参照してください。IntelliJ IDEA のテスト機能の詳細については、このセクションの他のトピックを参照してください。Maven、Gradle、IntelliJ ビルダーのいずれかを使用してチュートリアルに従うことを選択...

Maven

IntelliJ IDEA は Maven との完全な機能統合をサポートしており、構築プロセスの自動化に役立ちます。新しい Maven プロジェクトを簡単に作成したり、既存のプロジェクトを開いて同期したり、既存の IntelliJ IDEA プロジェクトに Maven サポートを追加したり、マルチモジュールプロジェクトを構成および管理したりできます。Maven プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを...