멀티클러스터 트러블슈팅
멀티클러스터 트러블슈팅 (Troubleshooting Multicluster)
멀티클러스터 및 멀티네트워크 설치의 문제를 진단하는 도구와 기법을 설명하는 문서예요.
출처: Istio 문서
본문
이 문서는 멀티클러스터/멀티네트워크 배포에서 발생하는 일반적인 문제와 이를 진단하는 방법을 설명해요.
지시자 확인 (Distinguishing indicators)
다음은 멀티클러스터 설치로 인한 문제일 수 있음을 나타내는 지표들이에요:
- 파드에서 다른 클러스터의 서비스에 접근할 때 시간 초과(timeout)가 발생
- 새로 조인한(joined) 클러스터의 서비스가 다른 클러스터에서 보이지 않음
- mTLS 또는 라우팅 관련 오류가 클러스터 경계를 넘는 트래픽에서만 발생
컨트롤 플레인 멀티클러스터 설정 확인
각 클러스터의 istiod가 remote-clusters 구성을 올바르게 가지고 있는지 확인해요. istiod의 디버그 엔드포인트를 통해 메시가 인식하는 원격 서비스들을 확인할 수 있어요.
게이트웨이 확인
클러스터 간 트래픽은 east/west 게이트웨이를 통과해요. 게이트웨이가 올바르게 배포되었는지, 그리고 필요한 포트(예: 15443)가 열려 있는지 확인해요.
네트워크 토폴로지
수평(flat) 네트워크와 다중 네트워크 토폴로지에 따라 게이트웨이 구성 방식이 달라져요. 멀티네트워크 토폴로지에서는 각 클러스터에 전용 east/west 게이트웨이가 필요해요.