2026年6月16日
2026年6月16日
VPSでdotenvを使ってアプリの環境変数を管理する方法
はじめに
この記事では、VPS上でdotenvを使用してアプリケーションの環境変数を安全かつ効率的に管理する方法について解説します。dotenvは、.envファイルを通じて環境依存パラメータを管理しやすくするためのツールで、開発からデプロイまでの一貫した管理が可能です。
症状・背景
このテーマが必要になる主な場面:
- 多くのアプリケーションはさまざまな環境(開発、テスト、本番)で異なる設定を必要とします。
- セキュリティ上の理由から、直接コード内で環境変数を使用するのではなく、.envファイルに保管することが推奨されます。
- VPS上で複数のプロジェクトを管理している場合、各アプリケーション固有の設定を明確かつ一貫して管理することが重要です。
手順・設定方法
ステップ1: dotenvをインストール
# Ruby gemを使用してdotenvをインストールします。
$ sudo apt-get update
$ sudo apt-get install ruby-full -y
$ gem install dotenv
ステップ2: .envファイルの作成と設定
# .envファイルを作成し、必要とする環境変数を追加します。
$ echo "API_KEY=your_api_key_here" > .env
$ echo "DATABASE_URL=postgres://user:password@localhost/dbname" >> .env
ステップ3: dotenvを使用して環境変数をロード
# 应用程序启动前,确保加载.env文件中的环境变量。
$ dotenv rails s -p 3000
ステップ4: 実践/トラブルシュート/監視
# .envファイルの内容は.vcs_ignoreに追加します。.gitignoreや其它版本控制系统忽略文件中加入.env。
$ echo ".env" >> .vcs_ignore
注意事項
- セキュリティ上の注意: .envファイルを安全な場所(例:Version Control Systemの外)に保管すること。
- パフォーマンス/運用上の注意: 大規模プロジェクトでは、dotenvが全ての環境変数をロードするための少量のオーバーヘッドがあることに注意しましょう。
まとめ
1. インストール: Ruby gemを使用してdotenvをインストールします。
2. ファイル作成: .envファイルを作成し、必要とする環境変数を設定します。
3. ロード処理: dotenvを使用してアプリケーション起動前に環境変数をロードします。
4. 管理: .envファイルの内容は.VCS_ignoreに追加して適切な管理を行います。
関連記事: