gamma-multi-env-setup（伽马多环境设置）

Gamma Multi-Environment Setup

Contents

• Overview
• Prerequisites
• Instructions
• Output
• Error Handling
• Examples
• Resources

Overview

Configure Gamma across development, staging, and production environments with proper isolation, secrets management, and environment guards.

Prerequisites

• Separate Gamma API keys per environment
• Secret management solution (Vault, AWS Secrets Manager, etc.)
• CI/CD pipeline with environment variables
• Environment detection in application

Instructions

Step 1: Create Environment Configuration

Define per-environment settings (timeout, retries, debug mode) in a typed configuration object. Use NODE_ENV to select the active config.

Step 2: Configure Per-Environment API Keys

Store separate API keys in .env.development, .env.staging, and .env.production files. Never commit keys to version control.

Step 3: Integrate Secret Management

For production, use AWS Secrets Manager or Vault to fetch keys at runtime with caching (5-minute TTL recommended).

Step 4: Build a Client Factory

Create a singleton factory that returns environment-aware Gamma clients. Production clients should fetch keys from secret manager; dev/staging can use env vars.

Step 5: Add Environment Guards

Implement requireProduction() and blockProduction() guards to prevent destructive operations in the wrong environment.

Step 6: Configure CI/CD

Set up GitHub Actions (or equivalent) with separate deployment jobs per environment, each using environment-specific secrets.

See detailed implementation for advanced patterns.

Output

• Environment-specific configuration files
• Secret management integration
• Client factory with environment detection
• CI/CD pipeline with environment isolation

Error Handling

Examples

Environment Checklist

Resources

• Gamma Environments Guide
• 12-Factor App Config