Skip to content

docs(aks): 배포 전략과 Pod rollout 제어 가이드 추가 - #72

Merged
hellices merged 1 commit into
mainfrom
docs/aks-deployment-strategies-rollout
Sep 21, 2026
Merged

hellices merged 1 commit into
mainfrom
docs/aks-deployment-strategies-rollout

Conversation

@hellices

Copy link
Copy Markdown
Owner

변경 내용

AKS에서 “Pod를 몇 개씩 배포할 것인가”를 배포 전략 전체의 관점으로 설명하는 운영 가이드를 추가합니다.

  • Recreate, RollingUpdate, Blue/Green, Canary의 선택 기준과 복구 방식을 비교합니다.
  • Pod 교체 예산, 신버전 replica 비율, 실제 트래픽 가중치, 승인·대기·분석 단계를 구분합니다.
  • Deployment patch/restart/status/undo, Blue/Green Service 전환, 선택 사항인 Argo Rollouts v1.10.0 설정·승격·중단 예시를 제공합니다.
  • PDB·HPA·AKS 노드풀 업그레이드와의 경계, StatefulSet·DaemonSet 차이, A/B·Shadow·기능 플래그를 정리합니다.

추가 문서는 docs/services/azure-kubernetes-service/deployment-strategies-rollout/index.md 한 개입니다. taxonomy, 메뉴, README, 자동 생성 결과는 변경하지 않습니다.

리뷰 포인트

  • maxSurge를 고정 배치 크기로 설명하지 않고, 종료 중인 Pod까지 포함한 전체 수량 상한과도 구분했습니다.
  • Blue/Green의 preview 수량과 승격 시 필요한 전체 수량, Basic Canary와 트래픽 라우팅 연동의 차이를 명시했습니다.
  • StatefulSet의 maxUnavailable은 upstream Kubernetes 1.35 Beta 기준과 AKS 지원 조건을 구분했습니다.
  • YAML은 기존 리소스의 수정 부분만 발췌한 것으로, 완성된 배포 매니페스트나 실행 실습이 아닙니다.
  • 공식 근거 검토일은 실제 UTC 날짜인 2026-09-21로 기록했습니다. 실제 AKS 클러스터 배포·부하·장애 복구는 실행하지 않았으며, 이 한계를 본문에도 명시했습니다.

공개 문서 체크리스트

  • 사례·가이드·실습·리서치 중 올바른 문서 유형과 폴더를 선택했습니다.
  • 필수 front matter와 docs-taxonomy.yml의 기존 분류 값을 사용했습니다.
  • Microsoft/Azure 기술 주장을 Microsoft Learn MCP와 verify-with-microsoft-learn skill로 원문까지 확인하고, Kubernetes·Argo Rollouts·Istio 공식 근거도 대조했습니다.
  • 실제 구독·테넌트 ID, 비밀, 내부 URL·IP·호스트명 등 공개 안전성 문제를 제거했습니다.
  • 필요한 경우 현재 가이드와 시점 고정 사례를 분리하고 서로 연결했습니다. 이 변경은 신규 가이드 단독이며 별도의 사건 기록은 없습니다.
  • 아래 로컬 검증을 통과했습니다.

검증 결과

저장소의 기존 Python 3.13.15 가상 환경에서 실행했습니다.

python -m pytest tests/docs -q                   # 1882 passed
python scripts/docs/validate_metadata.py        # 69 public documents
python scripts/docs/validate_sources.py         # 69 public documents
python scripts/docs/validate_links.py           # 69 public documents
python scripts/docs/validate_public_safety.py    # 379 public text files
mkdocs build --strict                           # passed
python scripts/docs/validate_search_index.py    # 69 documents, 13 tags
python scripts/docs/audit_pre_pages.py          # 62/62 baseline preserved; 69 current documents visible/searchable
git diff --cached --check                       # passed
  • 추가 확인: YAML 발췌 3개, shell block 13개, JSON patch 4개의 로컬 구문 검사 통과.
  • 공식 출처 URL 20개 접근 확인, 새 페이지의 렌더링된 제목과 검색 항목 확인.
  • 독립 기술 검토에서 조치가 필요한 실질적 오류·안전상 문제 없음.
  • 클러스터 연결·변경, 실서비스 트래픽 전환, Azure 리소스 생성은 수행하지 않았습니다.

Pod 교체 예산과 트래픽 전환을 구분하고 전략별 변경·검증·복구 절차를 설명합니다.

@my-reviewer-agent my-reviewer-agent Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

검토 범위에서 보고할 이슈가 없습니다.

@hellices
hellices merged commit 0036a2f into main Sep 21, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant