이 워크북의 도달점
섹션 제목: “이 워크북의 도달점”kubectl출력에서 다음 조사 명령과 복구 행동을 선택합니다.- Pod와 node scaling, application과 managed NKS의 책임 경계를 구분합니다.
- 배포 실패,
Pending,CrashLoopBackOff, image pull과 OOM 증상을 재현하고 복구합니다. - AI가 제안한 manifest와 운영 변경을 그대로 적용하지 않고 근거를 확인합니다.
예시 3서비스 시스템의 NKS 이전 맥락을 따라가되, 워크북 실습에서는 실제 endpoint·registry·Secret 대신 재현 가능한 로컬 fixture를 사용합니다.
모듈 지도
토대부터 NKS 적용까지 의존 순서대로 진행합니다.
토대와 도구
K8s 밖의 기반을 채우고 로컬 관찰 환경을 만듭니다.
워크로드와 연결
서비스를 배치하고 설정과 트래픽 경로를 연결합니다.
배치와 운영
리소스, 배포, 확장과 저장소를 운영 관점에서 다룹니다.
복구와 NKS 적용
실패 신호를 조사하고 3서비스 토폴로지에 적용합니다.
샘플 모듈 구조
섹션 제목: “샘플 모듈 구조”각 모듈은 설명을 읽고 끝내지 않고 같은 실행 리듬을 반복합니다. 아래 표는 실제 모듈의 정보 구조를 미리 보여주는 표본입니다. 각 모듈의 명령과 예상 출력은 독립 실행으로 확인했습니다.
| 단계 | 학습자가 하는 일 | 화면에서 확인할 것 |
|---|---|---|
| 1. Guard | 고정 버전·context·namespace를 확인합니다. | 운영 context 오적용 방지 여부 |
| 2. Execute | lab-id가 붙은 명령 묶음을 순서대로 실행합니다. | exit code와 실측 출력 |
| 3. Observe | 리소스 상태나 프로세스 변화를 전후 비교합니다. | 예상한 상태 변화와 변동 필드 |
| 4. Decide | 실패 신호에 맞는 조사·복구·cleanup을 선택합니다. | 적용형 셀프체크와 남은 리소스 0개 |
긴 command와 표는 본문 폭 안에서 가로 스크롤되며, 키보드로도 모든 내용을 확인할 수 있어야 합니다. 이 표본은 실제 모듈을 대신하지 않으며 각 모듈 페이지에서 같은 방식으로 확인할 수 있습니다.
시작 전 확인
섹션 제목: “시작 전 확인”| 항목 | 기준 |
|---|---|
| 기준일 | 2026-07-15 |
| 로컬 환경 | macOS arm64/x64, Docker 27 이상 |
| k3d / K3s | k3d 5.9.0 / K3s 1.36.2+k3s1 |
| kubectl | 1.36.2 권장, server 기준 ±1 minor |
| Helm | 4.2.3 |
| 검증 환경 | k3d-cs-study-workbook context, 모듈별 고유 namespace |
각 모듈은 setup과 cleanup을 포함합니다. 명령을 실행하기 전에는 현재 context를 확인하고, 완료 후에는 워크북이 만든 리소스만 제거합니다. Linux 명령 의미는 고정 container에서 보조 검증하며, local cluster와 전체 replay의 기준 OS는 macOS입니다.
검증을 읽는 법
섹션 제목: “검증을 읽는 법”| 표시 | 의미 |
|---|---|
| 로컬 실측 | 명령과 예상 출력을 k3d 또는 고정 Linux container에서 확인했습니다. |
| 정적 검증 | manifest 구조와 command 구문을 도구로 검사했습니다. |
| Provider 경계 | NKS에서 확인할 절차이며 k3d 결과를 NKS 실측으로 표현하지 않습니다. |
각 모듈의 명령과 예상 출력은 독립 실행과 검토를 거쳤습니다. 초안과 실행 증거에는 실제 credential, endpoint와 운영 수치를 기록하지 않습니다.
이 워크북은 관리형 NKS 사용자가 이해·결정·리뷰·운영하는 데 필요한 범위를 다룹니다. control plane 내부 구현, CNI 저수준 구현과 Terraform 작성은 심화 또는 제외 범위로만 표시합니다.