Proposal
Why¶
現在、Azureの環境固有パラメーター(サブスクリプションID、リソースグループ名、ストレージアカウント名など)は local.settings.json というJSON形式で管理されている。一方、フロントエンド用の環境変数は .env / .env.example で管理されている。環境情報の管理が2系統に分かれており、設定の見通しが悪い。.env ファイルに統合することで、環境設定を一元管理し、開発者体験を改善する。
What Changes¶
- BREAKING:
local.settings.jsonによる設定読み込み機構を廃止し、.envファイルからの読み込みに置き換える Load-LocalSettings.ps1(JSON読み込みヘルパー)を.env形式の読み込みヘルパーに書き換える- 全インフラスクリプト(
Deploy-Infrastructure.ps1、Deploy-StaticFiles.ps1、Clear-Data.ps1、New-SasToken.ps1、Show-Urls.ps1)の設定読み込み部分を.env対応に変更する .env.exampleに Azure 関連の環境変数を追加する.gitignoreからlocal.settings.jsonのエントリを削除する(.envはすでに対象)
Capabilities¶
New Capabilities¶
dotenv-config-loader:.envファイルからインフラスクリプト用の環境変数を読み込む共通ヘルパー機能
Modified Capabilities¶
(既存のspecsでこの変更に該当するものはなし)
Impact¶
- インフラスクリプト:
scripts/infra/配下の全5スクリプト+ヘルパー1ファイルが変更対象 - 設定ファイル:
.env.exampleへのAzure環境変数の追加、.gitignoreの更新 - 開発者ワークフロー:
local.settings.jsonを使用している開発者は.envファイルへの移行が必要(BREAKING) - フロントエンドコード: 変更なし(すでに
import.meta.env経由で.envを使用済み)