環境変数の設定

ここまでで、GitHubリポジトリからAmplifyへの自動デプロイができるようになりました。しかし、実際のアプリケーション開発では、APIのエンドポイントURLやアプリケーションの動作モードなど、コードには直接書かずに環境ごとに切り替えたい設定値があります。Amplifyでは、こうした設定値を環境変数としてコンソールから管理できます。

今回のアプリケーションはバックエンドAPIを使用しない構成のため、環境変数を使ってアプリケーションのタイトルを変更することで、環境変数の仕組みを体験します。

1. アプリケーションの環境変数対応

まず、サンプルアプリケーションがどのように環境変数を参照しているかを確認しておきましょう。NEXT_PUBLIC_APP_TITLE という環境変数でページタイトルを変更できるようになっています。

以下のコードで環境変数を参照しています。

const APP_TITLE = process.env.NEXT_PUBLIC_APP_TITLE || "タスク管理アプリケーション";

環境変数が設定されていない場合は「タスク管理アプリケーション」がデフォルト値として使われ、環境変数を設定するとその値がタイトルとして表示されます。

📝 NEXT_PUBLIC_ プレフィックスとは
Next.jsでは、クライアントサイド(ブラウザ)で環境変数を参照するには、変数名の先頭に NEXT_PUBLIC_ を付ける必要があります。このプレフィックスがない環境変数は、サーバサイドでのみ参照でき、ブラウザには公開されません。APIキーなどの機密情報はプレフィックスなしで設定することで、クライアントに漏洩するのを防ぐことができます。

2. Amplifyコンソールでの環境変数の追加

アプリケーション側の準備は整っているので、Amplify側で環境変数を設定します。Amplifyコンソールから環境変数を追加すると、ビルド時にアプリケーションに値が渡されます。

Amplifyコンソールで、対象のアプリケーションを選択し、サイドメニューの「ホスティング」から「環境変数」を開きます。「変数の管理」をクリックし、以下のように環境変数を追加します。

設定項目 値 設定の基準
キー NEXT_PUBLIC_APP_TITLE Next.jsでクライアントサイドから参照する変数には NEXT_PUBLIC_ プレフィックスが必要
値 タスク管理アプリケーション(環境変数で指定) デフォルト値との違いが分かる値を設定

設定を保存したら、環境変数を反映するために再デプロイが必要です。

3. 再デプロイと確認

環境変数はビルド時にアプリケーションに埋め込まれるため、コンソールで値を追加・変更しただけではアプリケーションに反映されません。反映するには再デプロイが必要です。

Amplifyコンソールからデプロイを再実行します。サイドメニューから概要をクリックし、対象のブランチを選択します。

その後、「このバージョンを再デプロイ」をクリックします。

デプロイが完了したら、アプリケーションのURLにアクセスし、ページタイトルが「タスク管理アプリケーション(環境変数で指定)」に変更されていることを確認します。

タイトルが変更されていれば、環境変数の設定は完了です。

💡 ポイント
環境変数を追加・変更した場合は、再デプロイが必要です。Amplifyコンソールから手動でデプロイを再実行するか、リポジトリにコードをプッシュすることで再ビルドが走り、新しい環境変数が反映されます。