프로덕션 체크리스트

애플리케이션을 프로덕션 환경에 배포하기 전의 점검 체크리스트입니다.

보안 개념

보안 아키텍처와 핵심 기능에 대한 자세한 내용은 보안 개요를 참조하세요.

배포 전 점검

파일 보안

[ ] .env.production 파일이 존재함
[ ] 파일 권한이 600 또는 더 엄격함
[ ] 민감 파일이 .gitignore에 추가됨
[ ] 구성 파일에 자리표시자가 없음(예: change-me, xxx)

bash

# 권한 확인
ls -la .env.production
# 표시되어야 함: -rw------- (600)

# 권한 수정
chmod 600 .env.production

구성 검증

[ ] 모든 필수 키가 설정됨
[ ] 민감 값이 비어 있지 않음
[ ] 값 형식이 올바름(URL, 포트 등)
[ ] 하드코딩된 키가 없음

cfg := env.ProductionConfig()
cfg.RequiredKeys = []string{
    "DB_HOST", "DB_PORT", "DB_USER", "DB_PASSWORD",
    "API_KEY", "API_URL",
}
cfg.FailOnMissingFile = true

보안 구성 점검

감사 로그

[ ] 감사 로그가 활성화됨
[ ] 로그 디렉터리가 쓰기 가능함
[ ] 로그 파일 권한이 올바름

auditFile, _ := os.OpenFile("/var/log/app/audit.log",
    os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0600)
cfg.AuditEnabled = true
cfg.AuditHandler = env.NewJSONAuditHandler(auditFile)

민감 데이터 처리

[ ] 민감 값을 GetSecure로 가져옴
[ ] 적시에 Close()를 호출하여 리소스 해제
[ ] 로그에 원본 민감 값을 출력하지 않음

secret := loader.GetSecure("DB_PASSWORD")
defer secret.Close()
log.Printf("Password length: %d", secret.Length())

접근 제어

[ ] AllowedKeys 화이트리스트 설정(권장)
[ ] ValidateValues 활성화
[ ] 크기 제한을 합리적으로 설정

cfg.AllowedKeys = []string{"APP_NAME", "DB_HOST", "API_KEY"}
cfg.ValidateValues = true
cfg.MaxVariables = 100

배포 시 점검

[ ] 구성 파일을 안전한 위치에서 로드
[ ] 애플리케이션 시작 시 구성 검증
[ ] 구성 오류 시 애플리케이션이 시작 거부
[ ] 민감 정보가 로그에 출력되지 않음

배포 후 점검

[ ] 애플리케이션이 정상 실행됨
[ ] 감사 로그가 정상적으로 기록됨
[ ] 민감 정보 유출이 없음
[ ] 구성 관련 오류를 모니터링

빠른 점검 스크립트

bash

#!/bin/bash
# pre-deploy-check.sh

set -e

echo "=== Pre-deployment Config Check ==="

# 파일 존재 확인
[ -f ".env.production" ] || { echo "ERROR: .env.production not found"; exit 1; }

# 권한 확인
PERMS=$(stat -c %a .env.production 2>/dev/null || stat -f %Lp .env.production)
[ "$PERMS" = "600" ] || [ "$PERMS" = "400" ] || echo "WARNING: permissions are $PERMS"

# 자리표시자 확인
grep -qE "(change-?me|placeholder|xxx|YOUR_)" .env.production && \
    { echo "ERROR: Found placeholder values"; exit 1; }

# 필수 키 확인
for key in DB_HOST DB_PORT DB_USER DB_PASSWORD API_KEY; do
    grep -q "^$key=" .env.production || { echo "ERROR: Missing $key"; exit 1; }
done

echo "=== All checks passed ==="

프로덕션 체크리스트 ​

배포 전 점검 ​

파일 보안 ​

구성 검증 ​

보안 구성 점검 ​

감사 로그 ​

민감 데이터 처리 ​

접근 제어 ​

배포 시 점검 ​

배포 후 점검 ​

빠른 점검 스크립트 ​

관련 문서 ​

프로덕션 체크리스트

배포 전 점검

파일 보안

구성 검증

보안 구성 점검

감사 로그

민감 데이터 처리

접근 제어

배포 시 점검

배포 후 점검

빠른 점검 스크립트

관련 문서