Ir al contenido

DOC-05: 운영 및 유지보수 (Day 2 Operations)

정기적 유지보수 매뉴얼, 자동화된 백업 및 인증 정보 노출 없이 수행하는 백업 및 Redmine 인프라용 재해 복구 계획

0조회

기업 환경의 회복력은 재해 대비 능력에 완전히 의존합니다. 견고한 백업 전략을 보장하기 위해 데이터 분리 원칙과 시스템 터미널에서 명확한 텍스트로 노출된 비밀번호를 제거합니다.

[!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 클라이언트용 옵션 파일을 호스트의 보호된 서버 구성 디렉토리에 생성하세요:

Ventana de terminal
mkdir -p ~/redmine/config/secrets
nano ~/redmine/config/secrets/mysql_backup.cnf

데이터베이스 관리 자격 증명을 체계적으로 추가하세요:

[client]
user=redmine
password=contrasena_secreta_portelcore
host=redmine_db

단계 2: 파일 시스템에 제한적인 권한을 적용하세요

Sección titulada «Paso 2: Aplicar permisos restrictivos en el sistema de archivos»

이 파일을 읽을 수 있는 것은 인프라 자동화 서비스 계정 (portel_user)과 Docker 디몬만 있어야 합니다:

Ventana de terminal
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 스크립트에서 데이터베이스 덤프를 실행하세요:

Ventana de terminal
# Ejecución segura mediante el uso del archivo de configuración interno
docker exec -i redmine_db mysqldump --defaults-extra-file=/etc/mysql/conf.d/mysql_backup.cnf redmine > ~/redmine/backups/redmine_backup_$(date +%F).sql

Redmine은 포털 첨부파일, 고급 시각 테마 및 통합 플러그인을 호스트 디렉토리에 저장합니다. 백업을 위해 고성능 압축 파일을 생성합니다:

Ventana de terminal
# Compresión recursiva preservando metadatos y permisos originales de Linux
tar -czpf ~/redmine/backups/redmine_assets_$(date +%F).tar.gz -C ~/redmine files themes plugins config

전체 데이터 손실 또는 물리적 호스트 손상 시, 새 노드에서 운영을 복원하기 위해 이 단계별 절차를 따르세요:

  1. 프로비저닝: DOC-01, DOC-02 및 DOC-03 가이드에 따라 운영 체제를 설치하고 빈 인프라를 구동하세요.
  2. 일시 중지: 데이터를 복원하는 동안 쓰기 불일치를 방지하기 위해 애플리케이션 컨테이너를 중지하세요:
    Ventana de terminal
    cd ~/redmine
    docker compose stop redmine
  3. 데이터베이스 복원: 이미 구성된 보안 연결을 사용하여 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
  4. 파일 복원: 파일과 플러그인을 호스트의 해당 위치에 압축 해제하고, 지속성 디렉터리의 빈 디렉터리를 덮어쓰도록 하세요:
    Ventana de terminal
    tar -xzpf ~/redmine/backups/redmine_assets_2026-05-22.tar.gz -C ~/redmine
  5. 권한 재구성: 파일 시스템에 프로덕션 격리 사용자(999)의 소유권을 다시 적용하세요:
    Ventana de terminal
    sudo chown -R 999:999 ~/redmine/files ~/redmine/themes ~/redmine/plugins ~/redmine/config
  6. 전체 시작: 애플리케이션을 다시 초기화하세요:
    Ventana de terminal
    docker compose start redmine

Ruby on Rails 프레임워크의 취약점으로부터 인스턴스를 보호하고 최신 성능 향상 기능을 활용하기 위해:

  1. 백업: 데이터베이스 및 첨부파일의 수동 백업을 수행하세요 (섹션 1).
  2. 레지스트리 이미지 업데이트: 공식 안정 버전의 최신 태그를 다운로드하세요:
    Ventana de terminal
    docker compose pull redmine
  3. 중지 및 재생성: 백그라운드에서 스택을 중지하고 다시 시작하세요. Docker는 새 기본 이미지에서 컨테이너를 불변 형태로 다시 생성할 것입니다:
    Ventana de terminal
    docker compose down
    Ventana de terminal
    docker compose up -d
  4. 데이터베이스 및 플러그인 마이그레이션: 버전 업그레이드로 인해 데이터베이스 관계 스키마나 Redmine 플러그인에 변경 사항이 있는 경우, Rake 컴파일 작업을 직접 호출하세요:
    Ventana de terminal
    docker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production

시스템이 건강하게 유지되고 유지보수 정책이 엄격하게 준수되도록 매주 이 체크리스트를 구현하세요:

  • ✓ 백업 상태: ~/redmine/backups/에서 일일 SQL 덤프가 올바르게 생성되었는지 확인하고 크기가 0이 되지 않았는지 확인하세요.
  • ✓ 소유자 확인 (UID 999): 사용자가 첨부 파일 포털을 통해 업로드한 파일이 로컬 서버의 권한 계층을 손상시키지 않았는지 확인하세요.
  • ✓ 디스크 공간 정리: Proxmox 하이퍼바이저의 가상 디스크에서 디스크 공간 부족을 방지하기 위해 Docker 엔진의 떠돌이 이미지 및 볼륨을 정리하세요.
  • ✓ 실험실 DNS 일관성: *.portelcore.com 확장 하에 내부 도메인 해석이 올바르게 수행되는지 확인하세요.