今すぐ始める

環境変数

ご自身で設定する変数とRivervoが自動で設定する変数、本番環境とプレビューの違い、自動値の上書き、変更が反映されるタイミングについて説明します。

1 分で読めます

アプリのキー、パスワード、設定は変数タブで管理します。値は暗号化して保存され、通常の環境変数としてアプリに渡されます。

変数を追加する

変数 → 変数を追加で名前と値を入力し、保存します。

  • 名前に使えるのは半角英字、数字、_で、数字から始めることはできません。名前はすべて一意である必要があります。
  • ヒント:.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_STORELaravelアプリの場合(Laravelを参照)

プロジェクトの最初のデータベースには通常の名前(DATABASE_URL、DB_*)が付きます。2つ目以降は専用のRIVERVO_<NAME>_URLが追加されるだけなので、接続先が勝手に切り替わることはありません。詳しくはデータベースをご覧ください。

自動値を上書きする

同じ名前で独自の変数を設定すると、自動の値に代わって使われます。パネルには独自の値を使用中と表示されます。たとえばDATABASE_URLをプロジェクト内の別のデータベースに向けるなど、アプリの接続先を変えたいときに使います。

PORTだけは例外で、常にRivervoが管理します。

プロジェクトのサービス

プロジェクトのすべてのサービス(ワーカー、スケジュールジョブ、ほかのWebサービス)には、データベースを含むプロジェクトの変数が渡されます。サービスごとに独自の変数を設定することもでき、プロジェクトの変数より優先されます。Webサービスには常に専用のAPP_URLが設定されます。コードを実行する各サービスには、ほかの各Webサービスの内部アドレスもRIVERVO_<NAME>_URLとして渡されます。Webサービスを追加したり名前を変更したりした後は、ほかのサービスを再デプロイして反映させてください。詳しくはプロジェクトのサービスをご覧ください。

値を閲覧できる人

値を閲覧できるのは、アカウントのオーナーと、アプリで開発者または管理者のロールを持つ人です。閲覧者ロールには表示されません。詳しくはアプリへのアクセスをご覧ください。

解決しませんか?

チャットでご相談ください。AIがすぐに回答し、必要なときはエンジニアが加わります。時間帯は問いません。

サポートに問い合わせる