프로덕션 체크리스트

프로덕션 환경에 애플리케이션을 배포하기 전 검사 목록입니다.

보안 개념

보안 아키텍처와 핵심 기능은 보안 개요를 참조하세요.

배포 전 검사

파일 보안

[ ] .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 ==="

프로덕션 체크리스트 ​

배포 전 검사 ​

파일 보안 ​

구성 검증 ​

보안 구성 검사 ​

감사 로그 ​

민감 데이터 처리 ​

접근 제어 ​

배포 시 검사 ​

배포 후 검사 ​

빠른 검사 스크립트 ​

관련 문서 ​

프로덕션 체크리스트

배포 전 검사

파일 보안

구성 검증

보안 구성 검사

감사 로그

민감 데이터 처리

접근 제어

배포 시 검사

배포 후 검사

빠른 검사 스크립트

관련 문서