GraalVM Tools for Micronaut拡張機能

GraalVM Tools for Micronautは、Visual Studio Code (VS Code)のMicronautフレームワークでアプリケーションを開発するための完全なサポートを提供します。

この拡張機能は、GraalVM Tools for Java拡張機能と組み合せて、VS CodeのMicronautフレームワークのネイティブ・サポートを提供します。その結果、Micronautアプリケーションをネイティブ実行可能ファイルに変換したり、異なるデバッグ・プロトコルを使用したデバッグや多言語プログラミングなど、Java開発者にとって可能性が広がります。

Micronautおよび完全なJava開発サポート以外の主要な機能は次のとおりです:

拡張機能はテクノロジ・プレビューです。

拡張機能のインストール

GraalVM Tools for Java拡張機能をVS Codeにインストールするには、次の手順を実行します:

  1. 左側のアクティビティ・バーの「Extensions」に移動します。
  2. 検索フィールドで「Micronaut」を検索します。
  3. 見つかったら、「Install」をクリックして、VS Code MarketplaceからGraalVM Tools for Micronaut拡張機能をインストールします。
  4. 必要に応じてリロードします。

ノート: Micronaut拡張機能では、ネイティブ実行可能ファイルのビルドやポリグロット・プログラミングなど、より多くの機能をサポートするためにGraalVM Tools for Java拡張機能が必要です。バックグラウンドでインストールされます。

インストールされると、登録済のGraalVMインストールがあるかどうかがチェックされ、最終的に、それをダウンロードするか、ローカル・インストールを指すようにすることを要求されます(VS CodeでのGraalVMのインストールと設定を参照)。

Micronaut拡張機能のエントリポイントはMicronaut Toolsページです。このページは、拡張機能がインストールされるとすぐに開かれます。あるいは、コマンド・パレット・コマンド「Micronaut: Show Micronaut Tools Page」を使用して開きます。

「Micronaut Tools」ページ

拡張機能設定

GraalVM Tools for Micronaut拡張機能は、VS Codeでの次の設定に影響します:

Micronautコマンド

「View」→「Command Palette」(コマンド・パレットは、[F1]またはCtrl+Shift+Pホット・キーの組合せ(Linuxの場合)、Command+Shift+P(macOSの場合)を押して開くこともできます)で「Micronaut」を検索し、Micronautコマンドを呼び出します。Micronautプロジェクト開発には、次のコマンドを使用できます:

Micronautプロジェクトの作成

GraalVM Tools for Micronaut拡張機能により、VS CodeでMicronautプロジェクトを直接作成できるMicronaut Launchアプリケーションが有効になります。Micronautアプリケーション、CLIアプリケーションおよびその他のタイプのアプリケーションの生成がサポートされます。

新しいプロジェクトを作成するには、「View」、「Command Palette」の順に移動し、「micronaut」を検索して、「Micronaut: Create Micronaut Project」コマンドを起動します。ウィザードにより、次のことが求められます:

最後に、ローカル・ディスク上の宛先ディレクトリを選択するよう求められ、作成したプロジェクトを新しいウィンドウで開くか、現在のワークスペースに追加するかを尋ねられます。

Micronaut拡張機能のGUI部分により、エクスプローラ・アクティビティに新しいビューが追加され、現在のワークスペースにMicronautプロジェクトが表示されます。

プロジェクト作成ウィザードのほかに、コンソールCLIを使用できます。Micronaut CLIインストールへのパスを指定すると、mn実行可能ファイルを使用してプロジェクトを作成できます。

Micronautアプリケーションのパッケージ化と実行

GraalVM Tools for Micronaut拡張機能は、自動完了、コード・ナビゲーション、リファクタリングなどの通常の機能を含む、Micronaut開発者向けのVS Codeでのアプリケーション開発とデバッグの完全なサポートを提供します。

Micronautアプリケーションを様々な方法で実行可能JARにパッケージ化できます。ユーザーの利便性のために、クイック・コマンドを使用できます:

  1. 「View」、「Command Palette」の順に移動し、「Micronaut: Build...」クイック・アクションを呼び出します。

    Micronautビルド・コマンド

  2. 使用可能なビルド・ターゲットのリストから「compile」を選択して、アプリケーションのソース・コードをコンパイルします。

  3. コンパイルが完了したら、「Micronaut: Build...」クイック・アクションを再度呼び出して、「package」ターゲットを選択します。これにより、コンパイルされたコードが配布形式にパッケージ化されます。

または、Micronautアプリケーションのエントリ・ポイント・クラスを開き、そのmainメソッドを見つけて、上にある「Run Main」をクリックします:

mainメソッドの実行

最後に、コマンドラインからMavenまたはGradleジョブを明示的にコールすると同時に、アプリケーションをパッケージ化して実行できます。

Micronautアプリケーションのデバッグ

Micronautアプリケーションをデバッグするには、最初に起動構成を作成します:

  1. デバッグまたは実行するファイルを開きます。
  2. 左側のパネルのバグ・アイコンをクリックして、「Debug」ビューに切り替えます。新しく開いたウィンドウで、launch.jsonファイルを作成するように提案されます。
  3. Java 8+環境を選択します
  4. デバッグを開始します。F5を押すか、「Run」、「Start Debugging」の順に選択します。

Micronautアプリケーションをネイティブ実行可能ファイルに変換

VS CodeのMicronautサポートとGraalVM Tools for Java拡張機能の組合せは、Java開発者の可能性を広げます。GraalVMネイティブ・イメージとの緊密な統合により、Micronautアプリケーションを事前にコンパイルしてネイティブ実行可能ファイルにすることができます。

VSコードでネイティブ・イメージ・サポートとともにGraalVMをインストールしている場合(VS CodeでのGraalVMのインストールと設定を参照)、次のクイック・アクションが使用可能になります:

Micronautアプリケーションのネイティブ実行可能ファイルをビルドするには:

  1. GraalVMをインストールし、それをデフォルトのランタイムおよびデバッグ環境にします。

  2. ネイティブ・イメージ・コンポーネントをGraalVMに追加します。

  3. 「View」、「Command Palette」の順に移動し、「Micronaut: Build...」クイック・アクションを呼び出します。

    Micronautビルド・コマンド

  4. 使用可能なビルド・ターゲットのリストから「nativeImage」を選択します。

    • プロジェクトがMavenでビルドされている場合、mvnw package -Dpackaging=native-imageジョブが実行されます。ネイティブ実行可能ファイルが/target/native-image/ディレクトリに作成されます。

    • プロジェクトがGradleでビルドされている場合、gradlew nativeCompileジョブが実行されます。ネイティブ実行可能ファイルが/build/native/nativeCompile/ディレクトリに書き込まれます。

または、「Micronaut: Build Native Image」クイック・アクションを直接呼び出すこともできます。

GraalVMネイティブ・イメージは、すべてのアプリケーション・クラス、依存ライブラリ・クラス、依存JDKクラスおよびアプリケーション・ヒープのスナップショットを含む実行可能ファイルを作成します。ネイティブ実行可能ファイルのビルドには時間がかかることがありますが、起動時間が大幅に短縮され、全体的なメモリー消費が削減されるという利点があります。

ノート: 実行可能ファイルのビルドにかかる時間はアプリケーションのサイズと複雑さによって異なり、低電力マシンでは時間がかかる場合があります。

Micronautアプリケーションをネイティブ実行可能ファイルとして実行するには、「Terminal」、「New Teminal」の順に開き、次を実行します:

詳細は、Hello World Micronaut GraalVMアプリケーションの作成方法に関するMicronautのドキュメントを参照してください。

DockerイメージのビルドとDockerレジストリへのMicronautアプリケーションのデプロイ

GraalVM Tools for Micronaut拡張機能を使用すると、MicronautアプリケーションのDockerイメージをビルドしたり、GraalVMネイティブ・イメージによって生成された実行可能ファイルを含むDockerイメージを作成してコンテナにデプロイすることもできます。

VS CodeのMicronautサポートにより、DockerイメージをビルドしてDockerレジストリにデプロイすることができます。

Micronautデプロイ・コマンド

これ以外に、Docker化したMicronautアプリケーションを、またはネイティブ実行可能ファイルとしてVS Code端末ウィンドウからDockerレジストリにプッシュすることもできます。特定のDockerレジストリをビルドで構成できます。詳細は、Micronautのアプリケーションのデプロイに関するドキュメントを参照してください。

KubernetesクラスタでのMicronautアプリケーションのデプロイ、実行およびデバッグ

GraalVM Tools for Micronautは、コンテナの自動デプロイメント、スケーリングおよび管理のためのKubernetesサポートなど、VS Codeでの完全な開発者エクスペリエンスに必要なすべてのツールを提供します。コンテナ化されたMicronautアプリケーションをKubernetesクラスタのコンテナ・レジストリにデプロイして、VS Codeから直接、対話形式で実行およびデバッグできます。次のクイック・コマンドを使用できます:

Kubernetesデプロイメント用のクイック・コマンド

フィードバック

プライバシ・ポリシー

さらに学習するには、Oracleプライバシ・ポリシーを参照してください。

既知の問題

GraalVM Tools for Micronaut拡張機能はテクノロジ・プレビューです。つまり、機能が完全ではない可能性があります。