Elasticsearch rolling upgrade (8.x minor 또는 8.19 → 9.x)

설치 가이드가 아닙니다. 실행 중인 Elasticsearch cluster의 node를 하나씩 업그레이드하여 중단 없이 새 버전으로 옮깁니다(8.x 내 minor 업그레이드 또는 8.19 → 9.x 메이저 업그레이드). 사전 점검(버전, 상태, deprecation API, system feature migration), 업그레이드 전 snapshot, shard allocation을 primaries로 제한하고 flush, node별 버전 업그레이드와 플러그인, allocation 재활성화와 상태 대기, Kibana 업그레이드, 필요 시 snapshot을 이용한 롤백을 단계별로 수행합니다. 완료되면 모든 node와 Kibana가 대상 버전이 되고 cluster는 green이 됩니다. 8.19보다 오래된 8.x에서 9.x로 가려면 먼저 이 가이드를 '같은 메이저 버전 내' 옵션으로 적용해 8.19로 올리십시오. snapshot repository가 없으면 snapshot 가이드를 먼저 여십시오.

구성: node 3개 이상인 기존 cluster (+ Kibana)

시나리오

• 같은 메이저 버전 내 (예: 8.18 → 8.19, 9.1 → 9.2) — 같은 메이저 버전 내 (8.18 → 8.19, 9.1 → 9.2): repository는 바뀌지 않으며 deprecation 점검은 그대로 수행합니다. 중간 minor 버전을 건너뛰는 것은 지원됩니다.
• 메이저 버전: 8.19.x → 9.x — 소스 cluster는 먼저 8.19.x(최신 patch)로 업그레이드되어 있어야 합니다. 사전 점검에는 Upgrade Assistant / deprecation API와 system feature migration 단계가 포함됩니다.

시작하기 전에

• 모든 node가 같은 버전입니다: …. …9.x로 가려면 소스 버전이 8.19.x여야 합니다(8.18 → 9.0 제외). 그렇지 않으면 먼저 이 가이드를 "같은 메이저 버전 내" 옵션으로 적용해 8.19로 올리십시오.…대상 버전 …은 현재 버전보다 새로워야 합니다. 중간 minor 버전을 건너뛰는 것(8.17 → 8.19)은 지원됩니다.…
• Cluster가 green이고 relocating/initializing shard가 없으며 모든 node의 디스크 사용률이 75% 미만입니다(업그레이드 중 shard가 다시 구성됩니다).
• 애플리케이션 클라이언트, Logstash, Beats/Elastic Agent, APM이 대상 버전과 호환됩니다. …9.x에는 9.x 클라이언트 라이브러리(또는 호환성 헤더를 사용하는 8.x)가 필요합니다. 릴리스 노트의 breaking change를 읽으십시오.…
• Snapshot repository …이 등록 및 검증되어 있고 snapshot에 필요한 여유 공간이 있습니다. 업그레이드된 node는 이전 버전으로 되돌릴 수 없으며, 되돌아가는 유일한 방법은 이 snapshot입니다.
• 서버가 artifacts.elastic.co(또는 내부 mirror)에 접근할 수 있고 …이 repository에 있습니다.
• 유지보수 시간대가 승인되었고, 가능하면 업그레이드 동안 쓰기 부하를 줄였습니다(필수 아님). …Kibana의 Stack Management → Upgrade Assistant 화면에 있는 모든 critical 경고를 해결했습니다.…

가이드 단계

• 사전 준비 — API 접근용 임시 자격 증명 파일 생성 · 구성 백업 · 설치된 플러그인 목록 확인
• 사전 점검 — 버전 및 역할 확인 · Cluster 상태 확인 · deprecation 점검 실행 (Upgrade Assistant API) · System feature migration 실행 · 설치 가능한 대상 버전 나열
• repository를 9.x로 전환 — Elastic 9.x repository 정의 · Elastic 9.x repository 정의 · 대상 버전 확인
• 롤백 지점: snapshot — 업그레이드 전 snapshot 생성 · ML upgrade mode 활성화
• 검증 — 모든 node가 대상 버전인지 확인 · allocation 설정이 영구적으로 해제되었는지 확인 · ML upgrade mode 비활성화 · 로그에서 오류 확인
• Kibana 업그레이드 — Kibana 중지 · Kibana를 …로 업그레이드 · Kibana 시작 및 상태 확인
• 설치 후 작업 — 업그레이드 후 snapshot 생성 · 임시 자격 증명 파일 삭제
• 롤백 (업그레이드가 실패한 경우에만) — 모든 node에서 서비스 중지 · 이전 버전 설치 · 데이터 디렉터리를 옮겨 두고 빈 디렉터리 생성 · 새 cluster용 initial_master_nodes 설정 작성 · 서비스 시작 · 임시 elastic 비밀번호 설정 …