環境変数
ご自身で設定する変数とRivervoが自動で設定する変数、本番環境とプレビューの違い、自動値の上書き、変更が反映されるタイミングについて説明します。
アプリのキー、パスワード、設定は変数タブで管理します。値は暗号化して保存され、通常の環境変数としてアプリに渡されます。
変数を追加する
変数 → 変数を追加で名前と値を入力し、保存します。
- 名前に使えるのは半角英字、数字、
_で、数字から始めることはできません。名前はすべて一意である必要があります。 - ヒント:
.envファイルの内容を名前の欄に貼り付けると、すべての行がまとめて追加されます。
変数はアプリの実行時に渡され、ビルド時には渡されません。変更は次回のデプロイでアプリに反映されます。保存後にパネルに表示される今すぐデプロイを使うと、新しいビルドを行わずに、実行中のバージョンを新しい変数で再デプロイできます。
本番環境とプレビュー
各変数には環境があります。
| 環境 | 適用先 |
|---|---|
| 本番環境とプレビュー | 公開中のアプリとすべてのブランチプレビュー(初期設定) |
| 本番環境のみ | 公開中のアプリのみ(例:本番用の決済キー) |
| プレビューのみ | ブランチプレビューのみ(例:テスト用の決済キー) |
プレビューには、プレビュー向けに設定された変数だけが渡されます。プレビューにも専用の変数タブがあり、アプリから受け取る変数を確認できます。同じ名前で独自の値を設定すると、そのプレビューに限りその値が優先されます。
自動で設定される変数
自動設定の一覧には、Rivervoがアプリのために用意し、常に最新に保つ変数が表示されます。ご自身で追加する必要はありません。
| 変数 | 条件 |
|---|---|
PORT | 常に設定。アプリが待ち受けるポート |
DATABASE_URL、DB_CONNECTION、DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD | プロジェクトにPostgreSQLまたはMySQLのデータベースがある場合 |
PGHOST、PGPORT、PGDATABASE、PGUSER、PGPASSWORD | データベースがPostgreSQLの場合 |
REDIS_URL、REDIS_HOST、REDIS_PORT、REDIS_PASSWORD、REDIS_CLIENT | プロジェクトにValkeyがある場合 |
RIVERVO_<NAME>_URL | プロジェクトの各データベース、Valkey、リードレプリカごとに、サービス名で設定 |
RIVERVO_<NAME>_URL | アプリのほかの各Webサービスの内部アドレス。例:RIVERVO_API_URL=http://api:8080(サービス間の通信を参照) |
S3_ENDPOINT、S3_REGION、S3_BUCKET、S3_KEY、S3_SECRET | プロジェクトにオブジェクトストレージがある場合 |
APP_KEY、APP_ENV、APP_DEBUG、APP_URL、LOG_CHANNEL、SESSION_DRIVER、CACHE_STORE | Laravelアプリの場合(Laravelを参照) |
プロジェクトの最初のデータベースには通常の名前(DATABASE_URL、DB_*)が付きます。2つ目以降は専用のRIVERVO_<NAME>_URLが追加されるだけなので、接続先が勝手に切り替わることはありません。詳しくはデータベースをご覧ください。
自動値を上書きする
同じ名前で独自の変数を設定すると、自動の値に代わって使われます。パネルには独自の値を使用中と表示されます。たとえばDATABASE_URLをプロジェクト内の別のデータベースに向けるなど、アプリの接続先を変えたいときに使います。
PORTだけは例外で、常にRivervoが管理します。
プロジェクトのサービス
プロジェクトのすべてのサービス(ワーカー、スケジュールジョブ、ほかのWebサービス)には、データベースを含むプロジェクトの変数が渡されます。サービスごとに独自の変数を設定することもでき、プロジェクトの変数より優先されます。Webサービスには常に専用のAPP_URLが設定されます。コードを実行する各サービスには、ほかの各Webサービスの内部アドレスもRIVERVO_<NAME>_URLとして渡されます。Webサービスを追加したり名前を変更したりした後は、ほかのサービスを再デプロイして反映させてください。詳しくはプロジェクトのサービスをご覧ください。
値を閲覧できる人
値を閲覧できるのは、アカウントのオーナーと、アプリで開発者または管理者のロールを持つ人です。閲覧者ロールには表示されません。詳しくはアプリへのアクセスをご覧ください。