DOC-03: 배포, 보안 및 시작
로컬 권한 할당, 변경 불가능한 시크릿 생성 및 Redmine 스택의 제어된 시작을 위한 전략적 절차 및 보안 좋은 실무
1. 권한 관리 (Linux에서의 핵심 단계)
Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»테스트 환경의 다른 파일 시스템과 달리, 기업용 Linux 환경에서 컨테이너 내에 마운트된 볼륨은 보안을 보장하기 위해 소유권과 권한의 엄격한 할당을 요구합니다. Redmine의 내부 엔진은 식별자 (UID/GID) 999를 가진 시스템 고립 사용자 하에 스레드를 실행합니다.
Ubuntu 호스트에서 소유자 변경을 생략하면 애플리케이션이 시작되지만, 첨부 파일 작성, 사용자 정의 스타일 시트 컴파일 또는 로그 추적 덤프 시 즉시 실패하여 데이터베이스에서 침묵 예외를 유발할 수 있습니다.
인프라를 초기화하기 전에, 호스트 터미널의 작업 디렉토리에서 권한 정화 명령을 실행하세요:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo chown -R 999:999 files themes plugins mysql_data config[!WARNING] 액세스 보안: 기업 환경의 이러한 폴더에
chmod -R 777와 같은 과도한 권한을 절대 부여하지 마십시오. Redmine 플러그인에서 보안 취약점이 발생할 경우, 이는 원격 파일 주입(remote file injection)을 위한 심각한 취약점 벡터가 될 수 있습니다.
2. 변경 불가능한 시크릿 생성 (Rails 세션)
Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»SECRET_KEY_BASE라는 선언적 키를 사용하여 Redmine은 클라이언트 쿠키에 암호화된 세션 토큰을 저장합니다. 세션 강탈이나 브라우저에서의 악의적인 인터셉트를 방지하기 위해 이 키는 높은 엔트로피를 가져야 하며 완전히 변경 불가능하고 비밀로 유지되어야 합니다.
향후 보안 감사로 인해 암호를 재생성해야 하는 경우, 암호화된 난수 생성 명령을 실행하십시오:
openssl rand -hex 64결과적으로 생성된 알파벳 숫자 블록을 복사하고, 스택 재시작 전에 파일 docker-compose.yml의 변수 SECRET_KEY_BASE을 즉시 업데이트하십시오.
격리된 네트워크 의존성과 백그라운드(디몬 모드)에서 실행되는 지속성 컨테이너를 컴파일, 구조화하고 시작하려면:
cd ~/redminedocker compose up -dDocker Compose는 가상 네트워크를 자동으로 생성하고, 구성된 볼륨을 마운트하며, MySQL 데이터베이스 엔진이 Redmine의 SQL 구조를 초기화할 준비가 될 때까지 기다립니다.
4. 상태 진단 및 로그 추적
Sección titulada «4. Diagnóstico de Estado y Trazas de Logs»서비스가 올바르게 시작되었는지 확인하려면 전술적인 디버깅 명령을 사용하십시오:
4.1. 활성 컨테이너 검증
Sección titulada «4.1. Verificación de Contenedores Activos»docker compose ps성공 기준: 두 개의 컨테이너(redmine 및 redmine_db)가 Up 또는 healthy 상태를 표시해야 합니다.
Rails가 실행하는 데이터베이스 초기화 및 내부 테이블 마이그레이션 프로세스를 분석적으로 모니터링하려면:
docker compose logs -f redmine예상 출력: 흐름의 마지막 부분에서 활성 소켓 로그를 찾으십시오:
Listening on 0.0.0.0:3000 (이는 외부적으로 기업 보안 포트 5588에 매핑됩니다).
5. 일반적인 충돌 해결 (Troubleshooting)
Sección titulada «5. Resolución de Conflictos Comunes (Troubleshooting)»5.1. 컨테이너가 재시작 루프에 들어갑니다
Sección titulada «5.1. El Contenedor Entra en un Loop de Reinicios»- 일반적인 원인:
- 호스트의 공유 디렉토리에서 소유자 권한이 부족합니다 (명령어
chown누락). docker-compose.yml의 YAML 파일에서 구문 들여쓰기 오류가 발생했습니다.
- 호스트의 공유 디렉토리에서 소유자 권한이 부족합니다 (명령어
- 해결책: 엔진을 중지하십시오 (
docker compose down),docker compose logs를 통해 소켓의 세부 오류 로그를 확인하고,chown -R 999:999를 사용하여 다시 권한 수정을 실행하십시오.
5.2. 데이터베이스 연결 오류
Sección titulada «5.2. Error en la Conexión de la Base de Datos»- 일반적인 원인:
- 변수
REDMINE_DB_MYSQL에 할당된 이름이 Compose 파일의 서비스 이름 선언과 정확히 일치하지 않습니다.
- 변수
- 해결책: 오케스트레이션 파일을 열고 두 블록이 공유된 DNS 식별자:
redmine_db를 공유하는지 확인하십시오.
- ✓ 올바른 파일 소유자: UID/GID
999로 설정된 모든 마운트 디렉토리가 쓰기 예외를 방지합니다. - ✓ 강력한 세션 시크릿: OpenSSL로 생성된 변수
SECRET_KEY_BASE가 공개 환경에서 격리되어 있습니다. - ✓ 활성 네트워크 소켓:
5588포트에서 안전한 매핑이 이루어지며, Rails 로그 리디렉션에 정상적으로 응답합니다. - ✓ 연동된 오케스트레이션: MySQL의 성공적인 초기화 전까지 메인 애플리케이션 서비스가 시작되지 않도록 지침
depends_on으로 차단되었습니다.

