LinuxでMicronautをセットアップする方法！パッケージ管理とGradle連携

1. SDKMANを使ったJava環境の準備

1. SDKMANを使ったJava環境の準備

Linux環境でMicronaut（マイクロノート）の開発を始める際、最も重要かつ最初にぶつかる壁が「Javaのバージョン管理」です。MicronautはモダンなJavaフレームワークであるため、特定のJavaバージョンを要求することがよくあります。そこでおすすめなのが、複数のJavaや関連ツールを一括管理できるSDKMAN!（エスディーケーマン）の導入です。

まずは、ターミナルを開いて以下のコマンドを入力し、SDKMAN!をインストールしましょう。未経験の方でも、このコマンドをコピー＆ペーストして実行するだけで準備が完了します。

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

インストールが完了したら、Micronautで推奨されるJava 17をインストールします。以下のコマンドを実行することで、手動でファイルをダウンロード・解凍する手間なく、最適なJava環境が整います。

sdk install java 17.0.8-tem
sdk use java 17.0.8-tem

最後に、正しく設定されたかを確認するために、以下の「Javaのバージョンを確認するコード」を実行してみましょう。これは、現在自分のマシンでどのJavaが動いているかをチェックする基本的な操作です。

public class CheckJavaVersion {
    public static void main(String[] args) {
        // システムのJavaバージョンを取得して表示する簡単なプログラム
        String version = System.getProperty("java.version");
        System.out.println("現在使用中のJavaバージョンは: " + version);
    }
}

ターミナルで java -version と入力し、指定したバージョンが表示されれば成功です。これでMicronautを動かすための強固な土台が整いました。次は、開発効率を最大化するエディタ（IDE）の準備に進みましょう。

2. IntelliJ IDEAのインストールと設定

2. IntelliJ IDEAのインストールと設定

Java開発の強力な味方となる「IntelliJ IDEA」は、Linux環境でもスムーズに動作します。まずは公式サイトからお使いのディストリビューションに合ったパッケージをダウンロードしましょう。インストール後、Javaプログラムを実行するために不可欠な「JDK（Java Development Kit）」をプロジェクト構造から紐付けるだけで、開発準備は完了です。

特にMicronautフレームワークを利用する場合、標準搭載されているGradleプラグインを有効化しておくのがポイントです。これにより、面倒なライブラリ管理やプロジェクトのビルドが自動化され、初心者でもコマンド操作に頼らずボタン一つで開発を進められます。

public class HelloMicronaut {
    public static void main(String[] args) {
        // 画面にメッセージを表示する命令です
        String message = "IntelliJ IDEAへようこそ！";
        System.out.println(message);
        
        // 数値の計算も簡単に行えます
        int a = 10;
        int b = 20;
        System.out.println("10 + 20 の合計は: " + (a + b));
    }
}

このコードは、指定した文字を画面に表示し、簡単な足し算の結果を出力するものです。IntelliJ IDEAを使えば、こうしたコードの入力補完（次に打つべき文字の予測）が働くため、スペルミスを防ぎながら効率よく学習を進めることができます。

3. Micronaut CLIの導入

3. Micronaut CLIの導入

SDKMANを使うとMicronaut CLIも簡単に導入できます。以下のコマンドをターミナルで実行します。

sdk install micronaut
mn --version

CLIがインストールされると、プロジェクト作成やアプリケーションの実行が容易になります。

4. Micronautプロジェクトの作成とGradle連携

4. Micronautプロジェクトの作成とGradle連携

Micronaut CLIでJavaとGradleを使ったプロジェクトを作成します。ターミナルで以下のコマンドを実行します。

mn create-app example.micronaut.linux --build=gradle --lang=java

作成されたプロジェクトにはGradle設定ファイルが含まれており、依存管理やビルドがスムーズに行えます。

5. Gradleでのビルドと実行

5. Gradleでのビルドと実行

プロジェクトディレクトリに移動してGradleでビルドと実行を行います。

./gradlew build
./gradlew run

実行後、Micronautアプリケーションが起動し http://localhost:8080/ でアクセス可能です。

6. 開発環境構築のポイント

6. 開発環境構築のポイント

Linuxではパッケージ管理や権限設定に注意してください。SDKMANやGradleが正しく動作しない場合は権限やパス設定を確認しましょう。IntelliJとCLIで使用するJavaバージョンを統一すると開発が安定します。また、Gradleのラッパーを使うとプロジェクト固有のGradleバージョンを簡単に利用できます。

7. サンプルMicronautコントローラ

7. サンプルMicronautコントローラ

簡単なMicronautアプリのサンプルコードです。Helloコントローラを作成し、HTTPリクエストに応答します。

package example.micronaut.linux;

import io.micronaut.http.annotation.*;

@Controller("/hello")
public class HelloController {

    @Get("/")
    public String index() {
        return "Hello, Micronaut on Linux!";
    }
}

ブラウザで http://localhost:8080/hello にアクセスすると、"Hello, Micronaut on Linux!" が表示され、環境構築が正しくできていることを確認できます。

まとめ

まとめ

LinuxでのMicronaut開発環境構築の振り返り

ここまでの記事では、Linux環境においてMicronautを使ったJavaアプリケーション開発を始めるための一連の流れを詳しく解説してきました。Javaの実行環境を整えるところから始まり、SDKMANによるJavaバージョン管理、IntelliJ IDEAの導入、Micronaut CLIのインストール、そしてGradleと連携したプロジェクト作成まで、実際の開発現場を意識した構成となっています。

Linuxはサーバー用途だけでなく、開発用OSとしても非常に人気が高く、Micronautのような軽量で高速なフレームワークとの相性は抜群です。特にSDKMANを利用することで、JavaやMicronautのバージョン管理が容易になり、複数プロジェクトを扱う場合でも柔軟に対応できます。Gradleを使ったビルド構成も、依存関係の管理や実行タスクの統一に役立ち、Linux環境でも安定した開発体験を実現できます。

また、Micronautは起動速度が速く、メモリ使用量も少ないため、Linuxサーバー上でのマイクロサービス開発にも適しています。今回紹介した基本的なセットアップ手順を理解しておくことで、Web API開発やクラウド環境へのデプロイ、コンテナ運用など、次のステップにもスムーズに進めるようになります。

まとめ用サンプルプログラム

記事の理解を深めるため、ここでも簡単なMicronautコントローラのサンプルを振り返りとして掲載します。Linux上でGradleビルドを行い、正しく動作するかを確認することで、環境構築の完成度を再確認できます。

package example.micronaut.linux;

import io.micronaut.http.annotation.*;

@Controller("/summary")
public class SummaryController {

    @Get("/")
    public String summary() {
        return "MicronautとLinux環境構築の理解が深まりました";
    }
}

    

このようにシンプルなクラス構成でHTTPエンドポイントを作成できる点も、Micronautの大きな魅力です。Gradleによるビルドと実行を繰り返し行いながら、Linux環境での動作確認に慣れていきましょう。