부트스트랩 구성 매개변수

부트스트랩 구성 매개변수 (Bootstrap Configuration Parameters)

이 문서는 Consul 에이전트 구성 파일의 부트스트래핑(bootstrapping) 매개변수에 대한 참조 정보를 제공해요. Autopilot, bootstrap, bootstrap_expect 등의 설정이 부트스트랩 시 어떻게 적용되는지 설명할게요.

출처: 문서

본문

이 페이지는 Consul 에이전트 구성 파일의 부트스트래핑 매개변수에 대한 참조 정보를 제공합니다.

부트스트랩 매개변수 (Bootstrap parameters)

  • autopilot - 이 객체는 Consul 서버에 대한 운영자 친화적인 설정을 구성할 수 있는 여러 하위 키를 설정할 수 있게 합니다. 이러한 키가 구성으로 제공되면 부트스트래핑 시에만 적용됩니다. 제공되지 않으면 기본값이 사용됩니다. 부트스트래핑 후 이러한 옵션의 값을 변경하려면 Consul Operator Autopilot 명령을 사용해야 합니다. Autopilot에 대한 자세한 내용은 Autopilot 튜토리얼을 검토하세요. 다음 하위 키를 사용할 수 있습니다:
    • cleanup_dead_servers - 죽은 서버 노드를 주기적으로 그리고 새 서버가 클러스터에 추가될 때마다 자동으로 제거하는 것을 제어합니다. 기본값은 true입니다.
    • last_contact_threshold - 서버가 비정상으로 간주되기 전에 리더로부터 연락이 없을 수 있는 최대 시간을 제어합니다. 10s 같은 기간 값이어야 합니다. 기본값은 200ms입니다.
    • max_trailing_logs - 서버가 비정상으로 간주되기 전에 리더를 따라잡지 못할 수 있는 최대 로그 항목 수를 제어합니다. 기본값은 250입니다.
    • min_quorum - 클러스터에 필요한 최소 서버 수를 설정합니다. Autopilot은 이 최소치에 도달하면 죽은 서버 정리를 중지합니다. 기본값은 없습니다.
    • server_stabilization_time - 서버가 클러스터에 추가되기 전에 'healthy' 상태로 안정적이어야 하는 최소 시간을 제어합니다. 모든 서버가 Raft 프로토콜 버전 3 이상을 실행 중일 때만 적용됩니다. 30s 같은 기간 값이어야 합니다. 기본값은 10s입니다.
    • redundancy_zone_tag Enterprise - Autopilot이 서버를 리던던시 영역으로 분리할 때 사용할 node_meta 키를 제어합니다. 각 영역에서 한 번에 하나의 서버만 투표 멤버가 될 수 있습니다. 비어 있으면(기본값) 이 기능이 비활성화됩니다.
    • disable_upgrade_migration Enterprise - true로 설정하면 Consul Enterprise에서 Autopilot의 업그레이드 마이그레이션 전략(충분히 많은 새 버전 서버가 클러스터에 추가될 때까지 그 중 하나를 투표자로 승격하지 않고 기다리는 것)을 비활성화합니다. 기본값은 false입니다.
    • upgrade_version_tag Enterprise - 업그레이드 마이그레이션을 수행할 때 버전 정보에 사용할 node_meta 태그입니다. 설정하지 않으면 Consul 버전이 사용됩니다.
  • bootstrap - 이 매개변수는 서버가 "bootstrap" 모드인지 제어합니다. 데이터센터 마다 이 모드로 실행되는 서버는 하나를 넘지 않는 것이 중요합니다. 기술적으로 bootstrap 모드의 서버는 스스로 Raft 리더로 선출될 수 있습니다. 단일 노드만 이 모드에 있어야 합니다. 그렇지 않으면 여러 노드가 스스로 선출할 수 있어 일관성을 보장할 수 없습니다. 클러스터가 부트스트랩된 후에는 이 플래그를 사용하지 않는 것이 권장됩니다.
  • bootstrap_expect - 이 매개변수는 데이터센터의 예상 서버 수를 제공합니다. 이 값은 제공하지 않거나 클러스터의 다른 서버와 일치해야 합니다. 제공하면 Consul은 지정된 수의 서버를 사용할 수 있을 때까지 기다린 후 클러스터를 부트스트랩합니다. 이렇게 하면 초기 리더가 자동으로 선출됩니다. 이 매개변수는 에이전트가 server 모드로 구성되어야 합니다.

더 알아보기 (Learn more)