Sameness Group 구성 항목 참조

Sameness Group 구성 항목 참조

이 페이지는 sameness group 구성 항목에 대한 참조 정보를 제공해요. Sameness group은 동일한 관리 파티션을 연결하여 동일한 서비스 간의 트래픽을 원활하게 해줘요.

출처: 문서

본문

이 페이지는 sameness group 구성 항목에 대한 참조 정보를 제공합니다. Sameness group은 동일한 관리 파티션을 연결하여 동일한 서비스 간의 트래픽을 원활하게 해줍니다. 파티션이 같은 Consul 데이터센터의 일부이면 Members[].Partition 필드에 나열하여 sameness group을 만들 수 있습니다. 파티션이 원격 클러스터에 있으면 원격 파티션을 Members[].Peer 필드의 sameness group에 추가하려면 원격 파티션 간에 클러스터 피어링 연결을 설정해야 합니다.

sameness group 생성에 대해 더 알아보려면 Create sameness groups 또는 Create sameness groups on Kubernetes을 참조하세요.

구성 모델 (Configuration model)

다음 목록은 sameness group 구성 항목의 필드 계층, 언어별 데이터 유형, 요구 사항을 간략히 설명합니다. 속성 이름을 클릭하면 기본값을 포함한 추가 세부 정보를 볼 수 있습니다.

전체 구성 (Complete configuration)

모든 필드가 정의되면 sameness group 구성 항목은 다음 형식을 갖습니다.

Kind               = "sameness-group"             # required
Name               = "<group-name>"               # required
Partition          = "<partition-configuration-applies-to>"
DefaultForFailover = false
IncludeLocal       = true
Members = [                                       # required
  { Partition = "<partition-with-services-in-group>" },
  { Peer = "<cluster-peer-with-services-in-group>" }
]

사양 (Specifications)

이 섹션은 sameness group 구성 항목에서 구성할 수 있는 필드에 대한 세부 정보를 제공합니다.

Kind

구현할 구성 항목의 유형을 지정합니다. sameness-group으로 설정해야 합니다.

값

  • 기본값: 없음
  • 이 필드는 필수입니다.
  • 데이터 유형: sameness-group으로 설정해야 하는 문자열 값.

Name

sameness group을 식별하는 데 사용되는 구성 항목의 이름을 지정합니다. 일관성을 위해 설명적인 이름을 사용하고 각 멤버를 sameness group에 추가하기 위한 구성 항목을 만들 때 같은 이름이 사용되는지 확인하세요.

값

  • 기본값: 없음
  • 이 필드는 필수입니다.
  • 데이터 유형: 문자열

Partition

sameness group이 적용되는 로컬 관리 파티션을 지정합니다. 자세한 내용은 admin partitions을 참조하세요.

값

  • 기본값: default
  • 데이터 유형: 문자열

DefaultForFailover

장애 조치 시나리오에서 같은 이름의 서비스와의 연결을 설정하는 데 sameness group을 사용해야 하는지 결정합니다.

이 필드가 true로 설정되면 업스트림 요청은 Members 목록의 멤버 순서에 따라 sameness group의 서비스로 자동으로 장애 조치됩니다. 이는 파티션의 모든 서비스에 영향을 줍니다.

이 필드가 false로 설정되면 service resolver 구성 항목의 Failover 블록을 구성해 장애 조치에 sameness group을 사용할 수 있습니다.

sameness group을 사용해 Consul DNS를 쿼리할 때는 DefaultForFailover를 true로 설정해야 합니다. 그렇지 않으면 Consul DNS가 오류를 반환합니다.

값

  • 기본값: false
  • 데이터 유형: 불리언

IncludeLocal

로컬 파티션이 sameness group의 첫 번째 멤버로 간주되어야 하는지 결정합니다. 이 필드가 true로 설정되면 DNS 쿼리, 업스트림 요청, 장애 조치 트래픽은 로컬 파티션에 존재하지 않는 한 로컬 파티션의 정상 인스턴스를 반환합니다.

이 매개변수를 활성화하면 로컬 파티션을 그룹의 첫 번째 멤버로 나열할 필요가 없습니다.

값

  • 기본값: false
  • 데이터 유형: 불리언

Members

로컬 파티션의 관점에서 sameness group의 멤버인 파티션과 클러스터 피어를 지정합니다.

IncludeLocal=true가 아니면 로컬 파티션이 첫 번째로 나열된 멤버여야 합니다. 멤버의 순서는 장애 조치 시나리오에서 우선순위를 결정합니다. 멤버가 나열되었지만 Consul이 연결할 수 없다면 장애 조치는 목록의 다음 정상 멤버로 진행됩니다. 이 매개변수 구성 방법을 보여주는 예시는 Failover between sameness groups을 참조하세요.

각 파티션은 단일 sameness group에만 속할 수 있습니다. 파티션이나 클러스터 피어를 여러 sameness group과 연결할 수 없습니다.

값

  • 기본값: 없음
  • 이 필드는 필수입니다.
  • 데이터 유형: 다음 매개변수의 맵을 포함할 수 있는 목록.

Members[].Partition

sameness group의 멤버인 로컬 데이터센터의 파티션을 지정합니다. 로컬 파티션은 sameness group에 추가되기 전에 클러스터 피어링 연결이 필요하지 않습니다.

값

  • 기본값: 없음
  • 데이터 유형: 문자열

Members[].Peer

sameness group의 멤버인 클러스터 피어의 이름을 지정합니다.

멤버 목록에 원격 파티션을 추가하기 전에 클러스터 피어링 연결이 설정되어 있어야 합니다. 자세한 내용은 establish cluster peering connections을 참조하세요.

값

  • 기본값: 없음
  • 데이터 유형: 문자열

예시 (Examples)

다음 예시는 특정 사용 사례에 대한 일반적인 sameness group 구성 패턴을 보여줍니다.

sameness group의 멤버 간 장애 조치

다음 예시에서 구성 항목은 로컬 데이터센터의 store-east 파티션에 적용되는 products-api라는 sameness group을 정의합니다. sameness group은 store-east의 서비스 인스턴스가 실패하면 Consul이 다음 순서로 장애 조치 연결을 시도하도록 구성됩니다.

  • store-east 파티션의 같은 이름을 가진 서비스
  • 같은 데이터센터의 inventory-east 파티션의 같은 이름을 가진 서비스
  • 설정된 클러스터 피어링 연결이 있는 데이터센터 dc2의 store-west 파티션의 같은 이름을 가진 서비스
  • 설정된 클러스터 피어링 연결이 있는 dc2의 inventory-west 파티션의 같은 이름을 가진 서비스
Kind                     = "sameness-group"
Name                     = "products-api"
Partition                = "store-east"
Members = [
    { Partition = "store-east" },
    { Partition = "inventory-east" },
    { Peer      = "dc2-store-west" },
    { Peer      = "dc2-inventory-west" }
]

더 알아보기 (Learn more)