Replit マルチ環境セットアップ

概要

開発環境、ステージング環境、本番環境にわたって Replit を設定します。

前提条件

• 環境ごとに別の Replit アカウントまたは API キー
• シークレット管理ソリューション(Vault、AWS Secrets Manager など)
• 環境変数を含む CI/CD パイプライン
• アプリケーション内の環境検出機能

環境戦略

環境	目的	API キー	データ
開発	ローカル開発	テストキー	サンドボックス
ステージング	本番前検証	ステージングキー	テストデータ
本番	ライブトラフィック	本番キー	実データ

設定構造

config/
├── replit/
│   ├── base.json           # 共有設定
│   ├── development.json    # 開発環境オーバーライド
│   ├── staging.json        # ステージング環境オーバーライド
│   └── production.json     # 本番環境オーバーライド

base.json

{
  "timeout": 30000,
  "retries": 3,
  "cache": {
    "enabled": true,
    "ttlSeconds": 60
  }
}

development.json

{
  "apiKey": "${REPLIT_API_KEY}",
  "baseUrl": "https://api-sandbox.replit.com",
  "debug": true,
  "cache": {
    "enabled": false
  }
}

staging.json

{
  "apiKey": "${REPLIT_API_KEY_STAGING}",
  "baseUrl": "https://api-staging.replit.com",
  "debug": false
}

production.json

{
  "apiKey": "${REPLIT_API_KEY_PROD}",
  "baseUrl": "https://api.replit.com",
  "debug": false,
  "retries": 5
}

環境検出

// src/replit/config.ts
import baseConfig from '../../config/replit/base.json';

type Environment = 'development' | 'staging' | 'production';

function detectEnvironment(): Environment {
  const env = process.env.NODE_ENV || 'development';
  const validEnvs: Environment[] = ['development', 'staging', 'production'];
  return validEnvs.includes(env as Environment)
    ? (env as Environment)
    : 'development';
}

export function getReplitConfig() {
  const env = detectEnvironment();
  const envConfig = require(`../../config/replit/${env}.json`);

  return {
    ...baseConfig,
    ...envConfig,
    environment: env,
  };
}

環境ごとのシークレット管理

ローカル開発

# .env.local (git-ignored)
REPLIT_API_KEY=sk_test_dev_***

CI/CD (GitHub Actions)

env:
  REPLIT_API_KEY: ${{ secrets.REPLIT_API_KEY_${{ matrix.environment }} }}

本番環境 (Vault/Secrets Manager)

# AWS Secrets Manager
aws secretsmanager get-secret-value --secret-id replit/production/api-key

# GCP Secret Manager
gcloud secrets versions access latest --secret=replit-api-key

# HashiCorp Vault
vault kv get -field=api_key secret/replit/production

環境の分離

// 本番環境以外での本番環境操作を防止
function guardProductionOperation(operation: string): void {
  const config = getReplitConfig();

  if (config.environment !== 'production') {
    console.warn(`[replit] ${operation} blocked in ${config.environment}`);
    throw new Error(`${operation} only allowed in production`);
  }
}

// 使用例
async function deleteAllData() {
  guardProductionOperation('deleteAllData');
  // 危険な操作がここに入ります
}

環境ごとの機能フラグ

const featureFlags: Record<Environment, Record<string, boolean>> = {
  development: {
    newFeature: true,
    betaApi: true,
  },
  staging: {
    newFeature: true,
    betaApi: false,
  },
  production: {
    newFeature: false,
    betaApi: false,
  },
};

手順

ステップ 1: 設定構造を作成

ベースおよび環境ごとの設定ファイルをセットアップします。

ステップ 2: 環境検出を実装

環境固有の設定を検出して読み込むロジックを追加します。

ステップ 3: シークレットを設定

シークレット管理ソリューションを使用して API キーを安全に保存します。

ステップ 4: 環境ガードを追加

本番環境のみの操作に対するセーフガードを実装します。

出力

• マルチ環境設定構造
• 環境検出ロジック
• セキュアなシークレット管理
• 本番環境のセーフガード有効化

エラーハンドリング

問題	原因	解決策
不正な環境	NODE_ENV が未設定	環境変数を設定する
シークレットが見つからない	シークレットパスが誤っている	シークレットマネージャーの設定を確認する
設定のマージが失敗	JSON が無効	設定ファイルを検証する
本番環境ガードがトリガー	環境が誤っている	NODE_ENV 値を確認する

例

クイック環境チェック

const env = getReplitConfig();
console.log(`Running in ${env.environment} with ${env.baseUrl}`);

リソース

• Replit Environments Guide
• 12-Factor App Config

次のステップ

オブザーバビリティセットアップについては、replit-observability を参照してください。