MicronautのConfig設定ベストプラクティス！安全で管理しやすい構成を紹介

1. 基本のConfig設定：Micronautの土台を作ろう

1. 基本のConfig設定：Micronautの土台を作ろう

Micronautでは、アプリの動作を決める「設定値」を主にapplication.yml（またはapplication.properties）というファイルに記述します。これは、家電の「初期設定」や、料理の「レシピ」のようなもので、プログラムを書き換えずに動作を調整できる非常に重要な仕組みです。

例えば、アプリの名前、待ち受けポート番号（住所のようなもの）、データベースの接続情報を以下のように階層構造で定義します。プログラミング未経験の方でも、この「項目名： 値」という形式（YAML形式）なら直感的に理解しやすいはずです。

micronaut:
  application:
    name: demo-app # アプリケーションの識別名
server:
  port: 8080      # アプリが通信を受け付けるポート番号
datasource:
  url: jdbc:h2:mem:devDb # 接続先のデータベースの場所
  username: sa           # ログインユーザー名
  password: ""           # パスワード

Micronautの大きな特徴は、アプリ起動時にこれらの設定を「自動的にスキャンして読み込んでくれる」点にあります。開発者は難しい読み込みロジックを書く必要はなく、ファイルに値を書き込むだけで準備が完了します。まずはこの基本ファイルをマスターすることが、保守性の高いマイクロサービス開発への第一歩となります。

2. 環境ごとのプロファイル管理：開発と本番を賢く切り替える方法

2. 環境ごとのプロファイル管理：開発と本番を賢く切り替える方法

プログラミングの世界では、自分のPCでテストする「開発環境」と、実際にユーザーが使う「本番環境」で設定を分けるのが一般的です。例えば、テスト用のデータと本番用の大切なデータが混ざらないようにするためです。

Micronautでは、「プロファイル」という仕組みを使って、これらを簡単に切り替えられます。具体的には、ファイル名の末尾に-dev（開発用）や-prod（本番用）と付けて、別々の設定ファイルを用意します。

開発環境用の設定 (application-dev.yml)

開発中は、PCの中で手軽に動く「H2データベース」などを使う設定にします。ポート番号も、他のソフトとぶつからないように8081などに変更しておくと便利です。

# application-dev.yml（開発用：自分のPCで動かす設定）
server:
  port: 8081 # 開発時は8081番ポートでアクセス
datasource:
  url: jdbc:h2:mem:devDb # PC内のメモリ上に一時的なDBを作成

本番環境用の設定 (application-prod.yml)

実際にWeb公開する際は、本物のデータベースサーバー（MySQLなど）に接続し、Webの標準的なポート番号である80を使用するように設定します。

# application-prod.yml（本番用：サーバーで公開する設定）
server:
  port: 80 # 本番公開用のポート
datasource:
  url: jdbc:mysql://prod-db-server:3306/real_database # 本物のDB接続先

切り替えは非常に簡単です。実行時に環境変数 MICRONAUT_ENVIRONMENTS に dev または prod と入力するだけで、Micronautが自動的に適切なファイルを読み込んでくれます。これにより、コードを書き換えることなく、安全かつミスなく環境を移行できるようになります。

3. 安全な機密情報の管理

3. 安全な機密情報の管理

パスワードやAPIキーなどの機密情報は、設定ファイルに直接書くのではなく、環境変数や外部シークレット管理を利用します。Micronautは${ENV_VAR}形式で環境変数を参照できます。

datasource:
  username: ${DB_USER}
  password: ${DB_PASSWORD}

この方法でコードに機密情報を残さず、環境に応じて安全に設定できます。

4. @ConfigurationPropertiesを使った設定管理

4. @ConfigurationPropertiesを使った設定管理

Micronautでは@ConfigurationPropertiesを使って型安全に設定値を読み込むこともできます。これにより設定ミスをコンパイル時に検知可能です。

import io.micronaut.context.annotation.ConfigurationProperties;

@ConfigurationProperties("datasource")
public class DataSourceConfig {
    private String url;
    private String username;
    private String password;

    public String getUrl() { return url; }
    public void setUrl(String url) { this.url = url; }

    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }

    public String getPassword() { return password; }
    public void setPassword(String password) { this.password = password; }
}

こうすることで、アプリ内でDataSourceConfigを注入して設定値を安全に利用できます。

5. 設定のベストプラクティスまとめ

5. 設定のベストプラクティスまとめ

Micronautで安全で管理しやすい設定を行うには、以下のポイントを押さえましょう。

• 環境ごとにプロファイルを分ける
• 機密情報は環境変数やVaultなど外部管理を使用
• @ConfigurationPropertiesで型安全に設定を読み込む
• 設定ファイルはコミットしても安全な値だけにする
• GradleやMicronautのバージョン互換性に注意

これらを守ることで、Micronautアプリの設定を効率的かつ安全に管理でき、開発・運用がスムーズになります。