Consul 에이전트 구성 파일: 노드 매개변수

Consul 에이전트 구성 파일: 노드 매개변수

이 페이지는 Consul 에이전트 구성 파일에서 노드 관련 매개변수에 대한 참조 정보를 제공해요. 노드 ID, 노드 이름, 노드 메타데이터, 호스트 기반 노드 ID 비활성화 설정을 설명한답니다.

출처: 문서

본문

이 페이지는 Consul 에이전트 구성 파일에서 노드 매개변수에 대한 참조 정보를 제공합니다.

노드 매개변수 (Node Parameters)

  • node_id - 노드 또는 주소의 이름이 변경되더라도 모든 시간에 걸쳐 이 노드에 대한 고유 식별자를 지정합니다. 이는 adf4238a-882b-9ddc-4a9d-5b6758e4159e처럼 36자 길이의 hex 문자열 형태여야 합니다. 이 값이 제공되지 않으면(가장 일반적인 경우) 에이전트가 시작 시 식별자를 생성하고 데이터 디렉터리에 저장하여 에이전트를 다시 시작해도 동일하게 유지되도록 합니다. disable-host-node-id가 true로 설정되지 않은 한, 가능하면 호스트의 정보를 사용해 결정적(deterministic) 노드 ID를 생성합니다.
  • node_name - 클러스터에서 이 노드의 이름입니다. 이 이름은 클러스터 내에서 고유해야 합니다. 기본적으로 머신의 호스트 이름을 사용합니다. 노드 이름에는 공백이나 따옴표가 포함될 수 없습니다. DNS에서 노드를 쿼리하려면 이름이 영숫자 문자와 하이픈(-)만 포함해야 합니다. -node 명령줄 플래그와 동일합니다.
  • node_meta - 이 객체는 로컬 노드에 임의의 메타데이터 키/값 쌍을 연결할 수 있게 해주며, 이는 특정 카탈로그 엔드포인트에서 결과를 필터링하는 데 사용할 수 있습니다. 자세한 내용은 -node-meta 명령줄 플래그를 참조하세요.
  • disable_host_node_id - Consul이 호스트의 정보를 사용해 결정적 노드 ID를 생성하지 못하게 하려면 이 매개변수를 true로 설정합니다. 대신 Consul은 데이터 디렉터리에 저장하는 임의의 노드 ID를 생성합니다. 이 매개변수는 테스트를 위해 같은 호스트에서 여러 Consul 에이전트를 실행할 때 유용합니다. 기본값은 false이므로 호스트 기반 ID를 옵트인해야 합니다. 호스트 기반 ID는 HashiCorp Nomad와 공유되는 gopsutil로 생성되므로, 호스트 기반 ID를 옵트인하면 Consul과 Nomad가 호스트의 정보를 사용해 두 시스템 모두에 동일한 ID를 자동으로 할당합니다. -disable-host-node-id 명령줄 플래그와 동일합니다.

예시 (Examples)

Node meta

이 예시는 node_meta 구성을 보여줍니다.

node_meta {
  instance_type = "t2.medium"
}

더 알아보기 (Learn more)