Rocky Linux Production¶

Rocky Linux 기반 운영 서버 구축과 운영을 위한 runbook 모음.

로컬 실행¶

최초 클론 후 Python 패키지 설치와 shared assets 심링크 연결은 프로젝트 루트 README.md를 따른다.

mkdocs.yml은 docs 폴더를 기준으로 동작한다.

python -m mkdocs build --strict -f mkdocs.yml
python -m mkdocs serve -f mkdocs.yml -a 127.0.0.1:8000

두 문서 사이트 모두 위 예시는 127.0.0.1:8000을 사용하므로 동시에 실행하지 않는다. 동시에 확인해야 하면 한쪽 포트를 8001 등으로 변경한다.

브라우저에서 접속.

http://127.0.0.1:8000/

상세 절차는 MkDocs Material 개발 환경 Runbook과 프로젝트 루트 README.md를 참고.

운영 서버를 처음 구성할 때는 아래 순서로 확인.

반복 작업이나 사고 가능성이 높은 작업은 runbook을 우선 기준.

OS 문서는 운영 서버의 접근 제어, 보안 기준, 기본 네트워크 정책을 정의.

Database와 Nginx는 애플리케이션보다 먼저 안정화해야 하는 공통 인프라 계층.

런타임별 운영 기준은 설치, 실행, 자동 기동, 로그, 보안, 연동 구조를 분리해서 관리.

GitLab 문서는 설치, 접근 제어, 프로젝트 정책, Runner, CI/CD, Ops 서버 배포 흐름을 포함.

문서 사이트 자체의 로컬 실행과 검증은 별도 runbook을 따름.

운영 서버 배포나 변경 작업 전후에 확인한다.