linkerd upgrade

 

개요

이 가이드는 서비스 메시 툴인 Linkerd의 버전 업그레이드를 설명합니다. 가이드는 linkerd 컨트롤 플레인을 helm 차트가 아닌 linkerd install 명령어로 설치한 경우를 기준으로 합니다.

업그레이드 과정에서 필요한 사전 준비사항, 업그레이드 절차, 그리고 주의할 점을 포함하여 단계별로 안내합니다.

 

환경

쿠버네티스 클러스터

 

설치된 서비스 메시

버전 업그레이드 시나리오 요약표:

컴포넌트 이름기존 버전새 버전설치 방식
linkerdedge-24.5.3edge-24.7.5linkerd CLI로 설치
linkerd-vizedge-24.5.3edge-24.7.5헬름 차트

 

업그레이드 가이드

Linkerd에서 업그레이드해야 할 네 가지 구성 요소는 다음과 같습니다.

Linkerd architecture

  1. CLI
  2. Control plane
  3. Control plane 확장 프로그램: Linker에서 공식 지원하는 확장 프로그램Extension 목록은 Extensions List 페이지에서 확인할 수 있습니다. 이 시나리오에서는 linkerd-viz를 업그레이드 합니다.
  4. Data plane

이러한 업그레이드 절차는 반드시 순서대로 수행해야 합니다.

 

업그레이드 공지사항

추가적으로 특정 업그레이드를 시작하기 전에 현재 사용하는 버전에 대한 중요한 정보가 포함될 수 있는 버전별 업그레이드 공지사항을 읽고 작업을 진행하는 걸 권장드립니다.

 

1. CLI 업그레이드

linkerd CLI를 먼저 버전 업그레이드합니다.

curl --proto '=https' --tlsv1.2 -sSfL https://run.linkerd.io/install-edge | sh

 

1-1. CLI 경로 설정

참고: 이 과정은 선택 사항입니다. 터미널에서 which linkerd 명령어로 이미 linkerd가 경로에 추가되어 있는지 확인할 수 있습니다. linkerd의 경로가 출력되면 설정이 완료된 상태이며, 이 단계를 건너뛰어도 됩니다.

linkerd CLI를 로컬에서 사용하기 위해 PATH 환경변수에 새롭게 linkerd 명령어 파일의 경로를 추가합니다.

export PATH=${PATH}:${HOME}/.linkerd2/bin

 

아래는 echo와 tee 명령을 조합하여 .zshrc 마지막 라인에 PATH 설정을 추가하고, 영구적으로 적용하는 방법입니다.

echo 'export PATH=${PATH}:${HOME}/.linkerd2/bin' | tee -a ~/.zshrc

 

이제 새 터미널을 열 때마다 linkerd 명령어를 사용할 수 있으며, 아래 명령으로 변경된 설정을 즉시 반영할 수 있습니다.

source ~/.zshrc

 

다음을 사용하여 CLI가 설치되어 있고 새 버전을 실행하고 있는지 확인합니다.

$ linkerd version --client
Client version: edge-24.7.5

 

2. Control plane 업그레이드

제 경우 Linkerd control plane은 linkerd 명령어를 사용해서 EKS v1.30 클러스터에 설치했습니다.

--crds 플래그를 사용하여 Linkerd의 CRD를 먼저 업그레이드한 다음 Control plane을 업그레이드해야 합니다.

linkerd upgrade --crds | kubectl apply -f -

Linkerd에서 사용하는 커스텀 리소스들이 업그레이드 됩니다.

customresourcedefinition.apiextensions.k8s.io/authorizationpolicies.policy.linkerd.io configured
customresourcedefinition.apiextensions.k8s.io/httproutes.policy.linkerd.io configured
customresourcedefinition.apiextensions.k8s.io/meshtlsauthentications.policy.linkerd.io configured
customresourcedefinition.apiextensions.k8s.io/networkauthentications.policy.linkerd.io configured
customresourcedefinition.apiextensions.k8s.io/serverauthorizations.policy.linkerd.io configured
customresourcedefinition.apiextensions.k8s.io/servers.policy.linkerd.io configured
customresourcedefinition.apiextensions.k8s.io/serviceprofiles.linkerd.io configured
customresourcedefinition.apiextensions.k8s.io/httproutes.gateway.networking.k8s.io configured
customresourcedefinition.apiextensions.k8s.io/grpcroutes.gateway.networking.k8s.io configured
customresourcedefinition.apiextensions.k8s.io/externalworkloads.workload.linkerd.io configured

Linkerd에서 사용하는 CRDCustom Resource Definition를 업그레이드하더라도 linkerd-proxy가 주입된 파드들은 데이터 플레인의 일부로 자동으로 재시작되지 않으므로 안심해도 됩니다.

이제 CRDCustom Resource Definition들을 업그레이드 완료되었으므로 다음 단계로 Control plane을 업그레이드하면 됩니다.

 

Linkerd control plane을 구성하는 파드들을 업그레이드합니다.

linkerd upgrade | kubectl apply -f -

linkerd prune 명령을 사용하여 이전 버전에는 있었지만 이번 버전에는 없어야 하는 리소스를 제거합니다.

linkerd prune | kubectl delete -f -

삭제할 이전 버전의 리소스가 없는 경우 다음과 같이 출력됩니다.

No resources found

 

3. Control plane extension 업그레이드

linkerd-viz가 기존에 헬름 차트로 설치되어 있는 상태였습니다.

values.yaml의 linkerdVersion 값을 새 linkerd-viz의 버전으로 변경합니다.

# charts/linkerd-viz/values.yaml
linkerdVersion: edge-24.7.5

 

이후 helm upgrade로 새 버전의 linkerd-viz 차트를 설치합니다.

helm upgrade \
  --install \
  --namespace linkerd-viz \
  linkerd-viz . \
  --values values.yaml \
  --wait

 

linkerd check 명령어로 컨트롤 플레인과 컨트롤 플레인 확장 컴포넌트들의 업그레이드 상태를 체크합니다.

$ linkerd check
kubernetes-api
--------------
√ can initialize the client
√ can query the Kubernetes API

kubernetes-version
------------------
√ is running the minimum Kubernetes API version

linkerd-existence
-----------------
√ 'linkerd-config' config map exists
√ heartbeat ServiceAccount exist
√ control plane replica sets are ready
√ no unschedulable pods
√ control plane pods are ready
√ cluster networks contains all pods
√ cluster networks contains all services

linkerd-config
--------------
√ control plane Namespace exists
√ control plane ClusterRoles exist
√ control plane ClusterRoleBindings exist
√ control plane ServiceAccounts exist
√ control plane CustomResourceDefinitions exist
√ control plane MutatingWebhookConfigurations exist
√ control plane ValidatingWebhookConfigurations exist
√ proxy-init container runs as root user if docker container runtime is used

linkerd-identity
----------------
√ certificate config is valid
√ trust anchors are using supported crypto algorithm
√ trust anchors are within their validity period
√ trust anchors are valid for at least 60 days
√ issuer cert is using supported crypto algorithm
√ issuer cert is within its validity period
√ issuer cert is valid for at least 60 days
√ issuer cert is issued by the trust anchor

linkerd-webhooks-and-apisvc-tls
-------------------------------
√ proxy-injector webhook has valid cert
√ proxy-injector cert is valid for at least 60 days
√ sp-validator webhook has valid cert
√ sp-validator cert is valid for at least 60 days
√ policy-validator webhook has valid cert
√ policy-validator cert is valid for at least 60 days

linkerd-version
---------------
√ can determine the latest version
√ cli is up-to-date

control-plane-version
---------------------
√ can retrieve the control plane version
√ control plane is up-to-date
√ control plane and cli versions match

linkerd-control-plane-proxy
---------------------------
√ control plane proxies are healthy
√ control plane proxies are up-to-date
√ control plane proxies and cli versions match

linkerd-extension-checks
------------------------
√ namespace configuration for extensions

linkerd-viz
-----------
√ linkerd-viz Namespace exists
√ can initialize the client
√ linkerd-viz ClusterRoles exist
√ linkerd-viz ClusterRoleBindings exist
√ tap API server has valid cert
√ tap API server cert is valid for at least 60 days
√ tap API service is running
√ linkerd-viz pods are injected
√ viz extension pods are running
√ viz extension proxies are healthy
√ viz extension proxies are up-to-date
√ viz extension proxies and cli versions match
√ prometheus is installed and configured correctly
√ viz extension self-check

Status check results are √

 

4. Data plane 업그레이드

데이터 플레인을 업그레이드하려면 메시된 각 워크로드에 추가된 프록시를 업데이트해야 합니다. Kubernetes에서 Pod는 변경할 수 없으므로 Linkerd는 단순히 프록시를 업데이트할 수 없습니다.

따라서 데이터 플레인을 업그레이드하려면 각 워크로드(파드)를 다시 시작하여, 프록시 인젝터가 최신 버전의 프록시를 주입할 수 있도록 재시작하는 방법이 있습니다.

kubectl -n <namespace> rollout restart deploy
kubectl -n <namespace> rollout restart statefulset

linkerd check 명령어를 실행하여 linkerd 데이터 플레인이 정상인지 확인합니다.

linkerd check --proxy

이는 일련의 검사를 통해 데이터 플레인이 올바르게 작동하는지 확인하고 여전히 이전 버전의 linkerd 프록시를 실행 중인 모든 파드를 나열합니다.

 

참고자료

linkerd
Linkerd upgrade
Linkerd extension list

linkerd-viz
linkerd-viz helm chart

서비스메시 성능 비교글
Service Meshes Decoded Part One: A performance comparison of Istio vs Linkerd vs Cilium