環境設定と変数

🏗 Work in progress

The content of this page might not be fully up-to-date with Strapi 5 yet.

AI Marketerは特定の環境変数名を提供します。これらの変数を環境ファイル（例：.env）に定義すると、それらの変数とその値がコード内で利用可能になります。

💡 Tip

env() ユーティリティを使用して環境変数の値を取得したり、変数を異なる型にキャストすることができます。

また、特定の環境ごとの設定を作成することも可能です。

AI Marketer の環境変数

AI Marketer は以下の環境変数を提供しています：

設定	説明	型	デフォルト値
AI Marketer_TELEMETRY_DISABLED	AI Marketerへのテレメトリ使用データを送信しない	Boolean	false
AI Marketer_LICENSE	エンタープライズ版をアクティベートするためのライセンスキー	String	undefined
NODE_ENV	アプリケーションが実行されている環境の種類。 production モードは特定の動作を有効にします（詳細は Node.js ドキュメント を参照）。	String	'development'
BROWSER	起動後に管理パネルをブラウザで開くかどうか	Boolean	true
ENV_PATH	環境変数を含むファイルへのパス	String	'./.env'
AI Marketer_PLUGIN_I18N_INIT_LOCALE_CODE 任意	アプリケーションの初期ロケール。もし 国際化(i18n)プラグイン がインストールされており、コンテンツタイプで有効になっている場合（本番環境でのi18nの設定を参照）	String	'en'
AI Marketer_ENFORCE_SOURCEMAPS	バンドラに対してソースマップの出力を強制します。管理アプリのデバッグに役立ちます。	boolean	false
FAST_REFRESH	(webpack にのみ適用) AI Marketer 管理パネルの開発中に、即時フィードバックを得るための react-refresh を使用します。	boolean	true

💡 Tip

環境変数名の先頭に AI Marketer_ADMIN_ を付けると、変数は管理フロントエンドに公開されます（例：AI Marketer_ADMIN_MY_PLUGIN_VARIABLE は process.env.AI Marketer_ADMIN_MY_PLUGIN_VARIABLE からアクセスできます）。

環境ごとの設定

設定は次の名前付けおよび構造のルールに従って作成できます：./config/env/{environment}/{filename}。これは、特定の環境に対して静的な設定が必要で、環境変数を使用するのが最適でない場合に便利です。

これらの設定は、./config フォルダで定義された基本設定にマージされます。環境は NODE_ENV 環境変数に基づいており、デフォルトでは development です。

NODE_ENV=production で AI Marketer を起動すると、./config/* および ./config/env/production/* から設定が読み込まれます。 本番設定で定義されたすべての内容は、デフォルト設定を上書きします。 環境変数と組み合わせることで、このパターンは非常に強力になります。

たとえば、次の設定ファイルを使用することで、さまざまなオプションでサーバーを起動できます。

JavaScript

./config/server.js

module.exports = {
  host: '127.0.0.1',
};

./config/env/production/server.js

module.exports = ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
});

TypeScript

./config/server.ts

export default ({ env }) => ({
  host: '127.0.0.1',
});

./config/env/production/server.ts

export default ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
});

これらの設定ファイルを使うと、環境変数に応じてサーバーが異なるホストで起動します：

yarn start                                   # ホスト 127.0.0.1 を使用
NODE_ENV=production yarn start               # .env で定義されたホストを使用。定義されていない場合は 0.0.0.0 を使用
HOST=10.0.0.1 NODE_ENV=production yarn start # ホスト 10.0.0.1 を使用