안전한 SafeLine WAF 업그레이드 가이드

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

• 시스템 엔지니어, DevOps 개발자
• 난이도: 중급 (Docker 및 환경 변수 조작 기초 지식 필요)

핵심 요약

• 업그레이드 전 반드시 백업 수행 (docker compose down 후 복사)
• 버전 8.1 이상은 롤백 불가능 (데이터 손상 위험)
• .env 파일의 필수 필드 검증 (SAFELINE_DIR, IMAGE_TAG, POSTGRES_PASSWORD 등)

섹션별 세부 요약

1. 업그레이드 전 주의사항

• 서비스 재시작으로 짧은 트래픽 중단 발생
• 데이터 마이그레이션 수행 시 복구 불가능
• 8.1 이상 버전 사용 시 롤백 금지 (데이터 손상 위험)

2. 백업 절차

• cd 로 디렉터리 이동
• docker compose down 명령으로 서비스 중지
• cp -r 로 백업 생성

3. 업그레이드 명령어

• bash -c "$(curl -fsSLk -- --en" 사용 (8.0 LTS 버전 업그레이드 시 --lts 옵션 추가)
• docker compose pull로 최신 이미지 다운로드
• docker compose down --remove-orphans && docker compose up -d로 서비스 재시작

4. `.env` 파일 설정 확인

• 필수 필드:
• SAFELINE_DIR
• IMAGE_TAG
• POSTGRES_PASSWORD
• SUBNET_PREFIX
• ARCH_SUFFIX
• 누락 시 데이터 손상 발생 가능성 (Discord 개발자 연락 권장)

5. 업그레이드 완료 검증

• SafeLine Web Admin Console에서 새 버전 확인
• 명령어 실행 결과 에러 없이 완료 시 성공

결론

• 업그레이드 전 반드시 백업 수행 및 .env 필수 필드 검증
• 버전 8.1 이상 사용 시 롤백 금지
• 업그레이드 후 Web Admin Console에서 상태 확인 필수

> "업그레이드 과정에서 데이터 손상 방지를 위해 백업과 환경 변수 검증을 철저히 수행하세요."