DOC-05: 운영 및 유지보수 (Day 2 Operations)
정기적 유지보수 매뉴얼, 자동화된 백업 및 인증 정보 노출 없이 수행하는 백업 및 Redmine 인프라용 재해 복구 계획
1. 백업 전략 (Backups)
Sección titulada «1. Estrategia de Copias de Seguridad (Backups)»기업 환경의 회복력은 재해 대비 능력에 완전히 의존합니다. 견고한 백업 전략을 보장하기 위해 데이터 분리 원칙과 시스템 터미널에서 명확한 텍스트로 노출된 비밀번호를 제거합니다.
1.1. MySQL 안전 백업 (MySQL Dump)
Sección titulada «1.1. Copia de Seguridad de Base de Datos (MySQL Dump Seguro)»[!CAUTION] 자격 증명 노출 위험: 터미널에서 대화식으로 MySQL 비밀번호를 전달하지 마십시오(예:
-p"mi_contraseña"). 그렇게 하면 비밀번호가 bash 명령 히스토리(~/.bash_history)와ps aux를 통해 모든 로컬 사용자가 볼 수 있는 시스템 프로세스 테이블에 평문으로 기록됩니다.
이 보안 취약점을 해결하기 위해 컨테이너 내에 안전한 MySQL 클라이언트 구성 파일 (.my.cnf)을 설정하거나 볼륨으로 마운트합니다.
단계 1: 호스트에서 안전한 자격 증명 파일 설정
Sección titulada «Paso 1: Configurar el archivo de credenciales seguro en el host»MySQL 클라이언트용 옵션 파일을 호스트의 보호된 서버 구성 디렉토리에 생성하세요:
mkdir -p ~/redmine/config/secretsnano ~/redmine/config/secrets/mysql_backup.cnf데이터베이스 관리 자격 증명을 체계적으로 추가하세요:
[client]user=redminepassword=contrasena_secreta_portelcorehost=redmine_db단계 2: 파일 시스템에 제한적인 권한을 적용하세요
Sección titulada «Paso 2: Aplicar permisos restrictivos en el sistema de archivos»이 파일을 읽을 수 있는 것은 인프라 자동화 서비스 계정 (portel_user)과 Docker 디몬만 있어야 합니다:
chmod 600 ~/redmine/config/secrets/mysql_backup.cnf단계 3: Compose 파일에서 매핑 및 실행
Sección titulada «Paso 3: Mapeo y Ejecución en el archivo Compose»파일 mysql_backup.cnf이 파일 docker-compose.yml의 서비스 redmine_db에 읽기 전용 모드로 매핑되었는지 확인하세요 (:ro):
services: redmine_db: # ... otras configuraciones volumes: - ./config/secrets/mysql_backup.cnf:/etc/mysql/conf.d/mysql_backup.cnf:ro매핑된 후, 로그나 시스템 이력에 암호를 노출하지 않고 CRON 스크립트에서 데이터베이스 덤프를 실행하세요:
# Ejecución segura mediante el uso del archivo de configuración internodocker exec -i redmine_db mysqldump --defaults-extra-file=/etc/mysql/conf.d/mysql_backup.cnf redmine > ~/redmine/backups/redmine_backup_$(date +%F).sql1.2. 파일 백업 (첨부파일 및 설정)
Sección titulada «1.2. Copia de Seguridad de Archivos (Adjuntos y Configuraciones)»Redmine은 포털 첨부파일, 고급 시각 테마 및 통합 플러그인을 호스트 디렉토리에 저장합니다. 백업을 위해 고성능 압축 파일을 생성합니다:
# Compresión recursiva preservando metadatos y permisos originales de Linuxtar -czpf ~/redmine/backups/redmine_assets_$(date +%F).tar.gz -C ~/redmine files themes plugins config2. 재해 복구 계획 (Disaster Recovery)
Sección titulada «2. Plan de Recuperación ante Desastres (Disaster Recovery)»전체 데이터 손실 또는 물리적 호스트 손상 시, 새 노드에서 운영을 복원하기 위해 이 단계별 절차를 따르세요:
- 프로비저닝: DOC-01, DOC-02 및 DOC-03 가이드에 따라 운영 체제를 설치하고 빈 인프라를 구동하세요.
- 일시 중지: 데이터를 복원하는 동안 쓰기 불일치를 방지하기 위해 애플리케이션 컨테이너를 중지하세요:
Ventana de terminal cd ~/redminedocker compose stop redmine - 데이터베이스 복원: 이미 구성된 보안 연결을 사용하여 SQL 덤프를 가져오세요:
Ventana de terminal docker exec -i redmine_db mysql --defaults-extra-file=/etc/mysql/conf.d/mysql_backup.cnf redmine < ~/redmine/backups/redmine_backup_2026-05-22.sql - 파일 복원: 파일과 플러그인을 호스트의 해당 위치에 압축 해제하고, 지속성 디렉터리의 빈 디렉터리를 덮어쓰도록 하세요:
Ventana de terminal tar -xzpf ~/redmine/backups/redmine_assets_2026-05-22.tar.gz -C ~/redmine - 권한 재구성: 파일 시스템에 프로덕션 격리 사용자(
999)의 소유권을 다시 적용하세요:Ventana de terminal sudo chown -R 999:999 ~/redmine/files ~/redmine/themes ~/redmine/plugins ~/redmine/config - 전체 시작: 애플리케이션을 다시 초기화하세요:
Ventana de terminal docker compose start redmine
3. 버전 업데이트 절차(Updates)
Sección titulada «3. Procedimiento de Actualización de Versiones (Updates)»Ruby on Rails 프레임워크의 취약점으로부터 인스턴스를 보호하고 최신 성능 향상 기능을 활용하기 위해:
- 백업: 데이터베이스 및 첨부파일의 수동 백업을 수행하세요 (섹션 1).
- 레지스트리 이미지 업데이트: 공식 안정 버전의 최신 태그를 다운로드하세요:
Ventana de terminal docker compose pull redmine - 중지 및 재생성: 백그라운드에서 스택을 중지하고 다시 시작하세요. Docker는 새 기본 이미지에서 컨테이너를 불변 형태로 다시 생성할 것입니다:
Ventana de terminal docker compose downVentana de terminal docker compose up -d - 데이터베이스 및 플러그인 마이그레이션: 버전 업그레이드로 인해 데이터베이스 관계 스키마나 Redmine 플러그인에 변경 사항이 있는 경우, Rake 컴파일 작업을 직접 호출하세요:
Ventana de terminal docker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production
4. 운영 검증 체크리스트 (유지보수)
Sección titulada «4. Checklist de Validación Operacional (Mantenimiento)»시스템이 건강하게 유지되고 유지보수 정책이 엄격하게 준수되도록 매주 이 체크리스트를 구현하세요:
- ✓ 백업 상태:
~/redmine/backups/에서 일일 SQL 덤프가 올바르게 생성되었는지 확인하고 크기가 0이 되지 않았는지 확인하세요. - ✓ 소유자 확인 (
UID 999): 사용자가 첨부 파일 포털을 통해 업로드한 파일이 로컬 서버의 권한 계층을 손상시키지 않았는지 확인하세요. - ✓ 디스크 공간 정리: Proxmox 하이퍼바이저의 가상 디스크에서 디스크 공간 부족을 방지하기 위해 Docker 엔진의 떠돌이 이미지 및 볼륨을 정리하세요.
- ✓ 실험실 DNS 일관성:
*.portelcore.com확장 하에 내부 도메인 해석이 올바르게 수행되는지 확인하세요.

