멀티클러스터 컴포넌트 업그레이드

원문 보기 위키 갱신 2026.10.03

멀티클러스터 컴포넌트 업그레이드 (Upgrading Multi-cluster components)

Linkerd 멀티클러스터를 업그레이드하고, edge-25.3.3에서 도입된 새로운 GitOps 호환 멀티클러스터 링크로 마이그레이션하는 방법을 다루는 문서예요.

출처: Linkerd Upgrading Multi-cluster components

본문

이 가이드에서는 Linkerd 멀티클러스터 업그레이드를 수행하고, edge-25.3.3에서 도입된 새로운 GitOps 호환 멀티클러스터 링크로 마이그레이션하는 방법을 안내할게요.

Helm values 업데이트 (Update the Helm values)

Helm values에서 controllers 섹션을 업데이트해 마이그레이션하려는 링크를 나열하고 컨트롤러별 구성을 지정하세요. 그러면 각 링크에 대해 새 컨트롤러(controller- 이름)를 배포하면서, 기존 컨트롤러(linkerd-service-mirror- 이름)는 그대로 둡니다. 예를 들어:

`controllers:
  - link:
      ref:
        name: east
`

Multicluster 확장 업그레이드 (Upgrade the Multicluster extension)

다음으로 values.yaml 파일을 제공하며 멀티클러스터 확장을 업그레이드합니다:

CLI로 업그레이드 (Upgrading with the CLI)

`linkerd multicluster install -f values.yaml | \
  kubectl apply -f -
`

Helm으로 업그레이드 (Upgrading via Helm)

`helm upgrade linkerd-multicluster \
  --namespace linkerd-multicluster \
  --values values.yaml \
  linkerd-buoyant/linkerd-enterprise-multicluster
`

기존 컨트롤러 제거 (Remove the old controllers)

멀티클러스터 확장이 업그레이드된 후에도, 기존 컨트롤러가 각 링크의 Lease 객체를 여전히 보유하고 있기 때문에 새 컨트롤러가 즉시 인계하지 않아요. 새 모델로 완전히 마이그레이션하려면, 다음 명령으로 기존 컨트롤러 배포를 삭제해야 합니다:

`linkerd multicluster unlink --cluster-name  --only-controller | \
  kubectl delete -f -
`

몇 초 안에 새 컨트롤러가 Lease 객체를 되찾아 각 링크 관리를 시작합니다.

Note

linkerd multicluster check 명령은 확장에 의해 관리되지 않는 컨트롤러가 있으면 경고합니다.

더 알아보기 (Learn more)

Linkerd 멀티클러스터 기능 개요
멀티클러스터 확장 설치 및 관리 문서