클러스터 피어링 연결 관리

CLI, HTTP API, UI를 사용하여 클러스터 피어링(peering) 연결을 관리하는 방법을 설명해 드릴게요. 활성 피어링 목록 조회, 특정 피어링 정보 읽기, 피어링 삭제까지 다뤄볼게요.

출처: 문서

본문

이 사용 문서는 CLI, HTTP API, UI를 사용하여 클러스터 피어링 연결을 관리하는 방법을 설명해요.

클러스터 피어링 연결을 확립한 후에는 모든 활성 피어링 연결 목록을 가져오고, 특정 피어링 연결의 정보를 읽고, 피어링 연결을 삭제할 수 있어요.

클러스터 피어링 연결 관리에 대한 Kubernetes 관련 지침은 Kubernetes에서 클러스터 피어링 연결 관리를 참고해 주세요.

모든 피어링 연결 나열

클러스터의 모든 활성 피어링 연결을 나열할 수 있어요.

Consul CLI / HTTP API / Consul UI

$ consul peering list
Name        State    Imported Svcs  Exported Svcs  Meta
cluster-02  ACTIVE   0              2              env=production
cluster-03  PENDING  0              0

선택적 플래그와 매개변수를 포함한 자세한 내용은 consul peering list CLI 명령 참조를 참고해 주세요.

다음 예시는 피어링 연결을 나열하는 API 요청 형식을 보여줘요:

$ curl --header "X-Consul-Token: 0137db51-5895-4c25-b6cd-d9ed992f4a52" http://127.0.0.1:8500/v1/peerings

선택적 매개변수와 샘플 응답을 포함한 자세한 내용은 /peering 엔드포인트 참조를 참고해 주세요.

Consul UI에서 Peers를 클릭해 주세요.

UI는 데이터센터의 클러스터에 대해 만든 피어링 연결을 나열해요. 목록에 표시되는 이름은 피어링 연결이 확립된 다른 데이터센터의 클러스터 이름이에요.

피어링 연결 읽기

클러스터 간 개별 피어링 연결에 대한 정보를 얻을 수 있어요.

Consul CLI / HTTP API / Consul UI

다음 예시는 로컬에서 "cluster-02"라고 참조되는 피어링 연결에 대한 정보를 출력해요:

$ consul peering read -name cluster-02
Name:         cluster-02
ID:           3b001063-8079-b1a6-764c-738af5a39a97
State:        ACTIVE
Meta:
    env=production

Peer ID:               e83a315c-027e-bcb1-7c0c-a46650904a05
Peer Server Name:      server.dc1.consul
Peer CA Pems:          0
Peer Server Addresses:
    10.0.0.1:8300

Imported Services: 0
Exported Services: 2

Create Index: 89
Modify Index: 89

선택적 플래그와 매개변수를 포함한 자세한 내용은 consul peering read CLI 명령 참조를 참고해 주세요.

$ curl --header "X-Consul-Token: b23b3cad-5ea1-4413-919e-c76884b9ad60" http://127.0.0.1:8500/v1/peering/cluster-02

선택적 매개변수와 샘플 응답을 포함한 자세한 내용은 /peering 엔드포인트 참조를 참고해 주세요.

Consul UI에서 Peers를 클릭해 주세요.
피어링 연결에 대한 추가 세부 정보를 보려면 피어링된 클러스터의 이름을 클릭해 주세요.

피어링 연결 삭제

연결을 삭제하여 피어링된 클러스터의 연결을 끊을 수 있어요. 피어링 연결을 삭제하면 피어로의 데이터 복제가 중지되고 서비스와 CA 인증서를 포함한 가져온 데이터가 삭제돼요.

Consul CLI / HTTP API / Consul UI

다음 예시는 로컬에서 "cluster-02"라고 참조되는 클러스터에 대한 피어링 연결을 삭제해요:

$ consul peering delete -name cluster-02
Successfully submitted peering connection, cluster-02, for deletion

선택적 플래그와 매개변수를 포함한 자세한 내용은 consul peering delete CLI 명령 참조를 참고해 주세요.

$ curl --request DELETE --header "X-Consul-Token: b23b3cad-5ea1-4413-919e-c76884b9ad60" http://127.0.0.1:8500/v1/peering/cluster-02

이 엔드포인트는 응답을 반환하지 않아요. 선택적 매개변수를 포함한 자세한 내용은 /peering 엔드포인트 참조를 참고해 주세요.

Consul UI에서 Peers를 클릭해 주세요. UI는 해당 데이터센터의 클러스터에 대해 만든 피어링 연결을 나열해요.
피어 이름 옆의 More(가로 점 세 개)를 클릭한 다음 Delete를 클릭해 주세요.
Delete를 클릭하여 피어링 연결을 확인하고 제거해 주세요.

클러스터 피어링 연결 관리