Skuber Agent Patch 가이드

개요

Agent Patch는 운영 중인 클러스터의 Skuber Agent를 최신 버전으로 업데이트합니다.
기존 클러스터 설정과 AWS 리소스는 자동으로 보존되며, 별도의 입력 없이 자동으로 완료됩니다.

패치 중 Agent의 모니터링 및 최적화 기능이 일시적으로 중단되며, 완료 후 자동 복구됩니다.
고객의 워크로드에는 영향이 없습니다.

사전 요구사항

Skuber Agent가 정상 운영 중인 클러스터
kubectl 접근 권한 (cluster-admin)
패치 대상 릴리즈 버전 (Skuber 담당자 확인)

실행 방법

1. 매니페스트 수령

Skuber 담당자에게 Patcher 매니페스트 파일(skuber-patcher-job.yaml)과 릴리즈 버전을 전달받습니다.

2. 실행

kubectl apply -f skuber-patcher-job.yaml

3. 진행 상황 확인

kubectl logs -f job/skuber-patcher -n kube-system

4. 완료 확인

kubectl get job skuber-patcher -n kube-system
kubectl get pods -n skuber-system

Job 상태가 Succeeded이면 패치 완료
Agent, Agent-Controller Pod가 Running이면 정상 동작

예상 소요 시간은 약 5~10분입니다.

정상 실행 시 아래와 같은 로그가 출력됩니다.

========================================
  Skuber Agent Patcher
========================================
[1/4] 기존 설정 백업 중...
[1/4] 백업 완료
[2/4] 이전 버전 정리 중...
[2/4] 정리 완료
[3/4] 새 버전 설치 중...
[3/4] 설치 완료
[4/4] Agent 기동 확인 중...
[4/4] Agent 정상 기동 확인
========================================
  패치 완료
========================================

상세 로그가 필요한 경우 YAML의 LOG_LEVEL을 debug로 변경하세요.

동작 과정

단계	내용
1. 백업	기존 클러스터 설정 정보를 자동 추출
2. 정리	이전 버전 Agent 구성 요소 제거 (AWS 리소스 및 권한은 보존)
3. 재설치	새 버전 Agent 구성 요소 설치
4. 검증	Agent 정상 기동 확인 후 임시 데이터 정리

재실행

패치를 재실행하려면 기존 Job을 삭제 후 다시 apply합니다.

kubectl delete job skuber-patcher -n kube-system
kubectl delete -f skuber-patcher-job.yaml
kubectl apply -f skuber-patcher-job.yaml

문제 해결

Job이 Failed인 경우

# 로그 확인
kubectl logs job/skuber-patcher -n kube-system

# 재실행
kubectl delete -f skuber-patcher-job.yaml
kubectl apply -f skuber-patcher-job.yaml

재실행해도 동일한 오류가 발생하면 로그를 Skuber 담당자에게 전달해 주세요.

Agent Pod가 기동되지 않는 경우

패치 완료 직후 Pod가 준비되기까지 1~2분이 소요될 수 있습니다.

kubectl get pods -n skuber-system -w

5분 이상 Running 상태가 되지 않으면 Skuber 담당자에게 문의해 주세요.