투표 구성 제외 API
투표 구성 제외 API (Voting Configuration Exclusions API)
cluster manager 후보 노드를 클러스터에서 안전하게 제거하거나 현재 cluster manager를 바꾸고 싶으시죠? _cluster/voting_config_exclusions API가 하나 이상의 노드를 투표 구성(voting configuration)에서 제외할 수 있게 해줘요.
출처: 문서
본문
1.0에서 도입
_cluster/voting_config_exclusions API는 하나 이상의 노드를 투표 구성에서 제외할 수 있게 해줘요. cluster manager 후보 노드를 클러스터에서 안전하게 제거하거나 현재 cluster manager를 바꾸려고 할 때 유용해요.
투표 구성 제외 추가하기 (Adding voting configuration exclusions)
투표 구성 제외를 추가하려면 POST 메서드를 사용해요.
엔드포인트
POST /_cluster/voting_config_exclusions
쿼리 파라미터
다음 표는 사용 가능한 쿼리 파라미터예요. 모든 쿼리 파라미터는 선택적이에요.
| Parameter | Data type | Description |
|---|---|---|
| node_ids | List or String | 투표 구성에서 제외할 노드 ID의 쉼표로 구분된 목록이에요. 이 설정을 사용할 때는 node_names를 동시에 지정할 수 없어요. 유효한 응답을 받으려면 node_ids 또는 node_names 중 하나가 필요해요. |
| node_names | List or String | 투표 구성에서 제외할 노드 이름의 쉼표로 구분된 목록이에요. 이 설정을 사용할 때는 node_ids를 동시에 지정할 수 없어요. 유효한 응답을 받으려면 node_ids 또는 node_names 중 하나가 필요해요. |
| timeout | String | 투표 구성 제외를 추가할 때 API는 지정된 노드가 투표 구성에서 제외될 때까지 기다린 후 응답을 반환해요. 타임아웃이 적절한 조건이 충족되기 전에 만료되면 요청은 실패하고 오류를 반환해요. |
예시
opensearch-node1이라는 노드를 투표 구성에서 제외해요.
POST /_cluster/voting_config_exclusions?node_names=opensearch-node1
또는 노드 ID를 쉼표로 구분된 목록으로 지정할 수 있어요.
POST /_cluster/voting_config_exclusions?node_ids=6ITS4DmNR7OJT1G5lyW8Lw,PEEW2S7-Su2XCA4zUE9_2Q
투표 구성 제외 제거하기 (Removing voting configuration exclusions)
DELETE 메서드를 사용해 이전에 투표 구성에서 제외됐던 노드 목록을 지워요. 이는 일반적으로 제외된 노드가 안전하게 제거되거나 교체된 후에 사용돼요. 선택적으로 제외를 지우기 전에 노드가 클러스터에서 제거될 때까지 기다릴 수 있어요.
엔드포인트
DELETE /_cluster/voting_config_exclusions
쿼리 파라미터
다음 표는 사용 가능한 쿼리 파라미터예요. 모든 쿼리 파라미터는 선택적이에요.
| Parameter | Data type | Description |
|---|---|---|
| wait_for_removal | Boolean | 이 API가 작업을 수행하기 전에 모든 제외된 노드가 클러스터에서 제거될 때까지 기다릴지 여부를 지정해요. true면 모든 제외된 노드가 클러스터에서 제거될 때까지 이 API는 아무 작업도 하지 않아요. false면 일부 제외된 노드가 여전히 클러스터에 있어도 투표 구성 제외 목록이 지워져요. (기본값: true) |
예시
다음 요청을 사용해 노드가 제거될 때까지 기다리지 않고 모든 투표 구성 제외를 제거해요.
DELETE /_cluster/voting_config_exclusions?wait_for_removal=false
더 알아보기 (Learn more)
- cluster manager 후보 노드 관리의 전반은 Cluster formation에서 다뤄요.
- 클러스터의 안정적인 재구성을 위해 제외 후에는 반드시 목록을 정리해줘야 해요.