server

Linux 서버의 '구축 → 동작 확인 → 이상 조사 → 복구' 과정을 전반적으로 배우기 위한 개인 학습 랩입니다. 업무상의 운용 실적을 나타내는 것이 아니라, 본인이 실행한 범위와 미실시 범위를 나누어 기록하는 것을 방침으로 하고 있습니다. 라이선스는 MIT, 작성자는 시마다 노리유키(Noriyuki Shimada)입니다. 핵심 구성은 인증 기능이 포함된 Flask 앱(컨테이너 내에서 psutil을 사용하여 상태를 반환)과 그 입구가 되는 nginx를 Docker Compose로 기동하는 것입니다. 브라우저에서는 127.0.0.1:8080을 통해 접속하여 health 응답과 Basic 인증 유무에 따른 200 / 401의 차이를 확인할 수 있습니다. 모니터링 체계는 Prometheus가 앱과 node-exporter를 정기적으로 수집하고, Grafana가 시각화하며, 로그 집약(Alloy / Loki)과 Alertmanager를 통한 알림까지 포함하는 상세 구성도를 마련하고 있습니다. 호스트 전체의 수치는 node-exporter 측에서 확인해야 한다는 점도 명시되어 있습니다. 구축 자동화에는 Ansible을 사용하며, common / docker 등의 롤을 포함하는 foundation.yml(기반 구축)과 모니터링까지 포함하는 site.yml(풀스택)로 나누어 관리합니다. 멱등성 확인 및 Ubuntu와 AlmaLinux 각각에 대한 기반 적용 기록이 남아 있습니다. 또한 복구 절차와 변경 관리, SLO·에러 버짓과 같은 운용 측면의 토픽도 다룹니다. 검증은 GitHub Actions의 python-check와 full-stack-e2e 워크플로우로 자동화되었으며, pytest는 167건의 기록이 있습니다. 증적 대장(docs/evidence)에서는 실행 일시, 환경, 대상 commit, 결과, 미실시 범위를 관리하며, 2026-08-22 풀스택 E2E에서는 일괄 구축·멱등성·복구·복원 등 23개 ID가 PASS, 2026-09-04에는 Ubuntu와 AlmaLinux의 기반 구축 실측, 2026-09-07~08에는 Hyper-V 상의 Ubuntu에 대한 수동 구축(고정 IP, SSH 키 인증, sudo, UFW, 시간 동기화, 자동 업데이트)과 Docker 최소 구성 기동이 기록되어 있습니다. 판정은 PASS 14 / PASS-ADAPTED 4 / PARTIAL 2 / NOT RUN 1과 같은 내역까지 공개되어 있습니다. 반면, AWS 실적용 및 삭제, Slack 실전송, 모니터링 랩의 장기 가동, 호스트 장애로부터의 복원(D-2)은 NOT RUN으로 명시되어 있으며, 실측 계획이 별도로 마련되어 있습니다. 수동 기록에 대해서도 Ansible이나 본 리포지토리의 코드를 사용하지 않는 OS 단독 연습이며 특정 안건의 수주가 아니라는 점, AI가 절차 안내 및 이미지 판독·기록 편집을 지원했다는 점, 독자적인 재현이나 장기 가동은 대상 외라는 점이 주석으로 달려 있습니다. 문서군은 학습자를 위해 상세히 구성되어 있으며, 처음에 확인하는 초보자용 학습 가이드(최소 2개 서비스부터 시작하는 5단계), Level 0~5의 일직선 러닝 패스, 408단어의 서버 기초 용어집, 서버 구축 키워드집, 초보자 실습 기록 템플릿, 안건 팩(요건→설계치→구축→시험→증적→운용→변경), 설계 판단, 실패 사례, 스스로 진행하는 운용 키트 등을 포함합니다. AI 이용 범위도 공개하고 있으며, 학습 기록에는 직접 실행 및 설명할 수 있는 범위와 AI 지원 범위, 미확인 범위를 남기는 방침이 설명되어 있습니다.