Linkerd 설치
Linkerd를 사용하려면 먼저 컨트롤 플레인을 설치해야 해요. 이 페이지에서는 그 방법을 다뤄요.
본문
참고
Linkerd 프로젝트 자체는 edge 릴리스 아티팩트만 생산해요. (Linkerd 릴리스 종류에 대한 자세한 내용은 Releases and Versions 페이지를 참고하세요.)
따라서 이 페이지에는 최신 edge 릴리스의 Linkerd를 설치하는 방법이 담겨 있어요. 안정(stable) 배포판의 Linkerd를 사용 중이라면, 설치에 대한 추가 안내는 공급업체가 제공해야 해요.
Linkerd의 컨트롤 플레인은 CLI와 Helm, 두 가지 방법으로 설치할 수 있어요. CLI는 편리하고 쉬우며, 재현 가능성(repeatability)을 원하는 프로덕션 use case에서는 Helm을 권장해요.
어느 경우든 설치 성공 여부를 검증할 수 있도록 CLI 자체를 설치하는 것을 권장해요. 아직 설치하지 않았다면 Getting Started 가이드에서 CLI 설치 방법을 확인하세요.
요구 사항
Linkerd가 실행될 Kubernetes 클러스터가 필요해요. 클러스터가 어디에 있든 상관없어요. 클라우드 제공자에 호스팅되어 있을 수도, 로컬 머신에서 실행 중일 수도, 또는 다른 곳일 수도 있어요.
Linkerd가 지원하는 Kubernetes 버전을 확인해 Linkerd 버전과 Kubernetes 버전이 호환되는지 확인하세요.
Linkerd는 또한 Gateway API CRD가 필요해요. 많은 Kubernetes 클러스터에서 이 CRD는 이미 제공되지만, 없다면 먼저 설치해야 해요.
Gateway API가 설치되어 있는지 확인하거나 설치하는 방법은 다음 설명을 따라주세요.
컨트롤 플레인을 설치하기 전에, 다음을 실행해 이 Kubernetes 클러스터가 Linkerd에 적절하게 구성되었는지 검증해요.
linkerd check --pre
계속 진행하기 전에 검사에서 식별된 문제들을 해결하세요.
참고
GKE에 Linkerd를 설치하는 경우, 클러스터 구성 방식에 따라 추가 단계가 필요할 수 있어요. 이러한 기능 중 하나를 사용한다면 GKE private clusters에 대한 추가 설명을 확인하세요.
참고
kube-proxy 대체 모드로 Cilium을 사용하는 클러스터에 Linkerd를 설치하는 경우, 서비스 디스커버리가 의도대로 동작하도록 추가 단계가 필요할 수 있어요. 설명은 Cilium cluster configuration 페이지에 있어요.
CLI로 설치
클러스터가 준비되면 Linkerd 설치를 위해 먼저 linkerd install --crds를 실행해 Linkerd CRD를 설치하고, 이어서 linkerd install을 실행해 Linkerd 컨트롤 플레인을 설치하면 돼요. 두 명령 모두 Linkerd 설치를 위해 클러스터에 적용할 수 있는 Kubernetes 매니페스트를 생성해요.
예를 들어:
# install the CRDs first
linkerd install --crds | kubectl apply -f -
# install the Linkerd control plane once the CRDs have been installed
linkerd install | kubectl apply -f -
이 기본 설치는 대부분의 경우에 동작해요. 하지만 install에는 플래그로 제공되는 설정 옵션들이 있어요. 전체 옵션 목록은 CLI reference 문서를 확인하세요. Kustomize 같은 도구를 사용해 이 매니페스트를 프로그래밍 방식으로 변경할 수도 있어요.
Helm으로 설치
Helm으로 Linkerd를 설치하려면(프로덕션 설치에 권장) Installing Linkerd with Helm 문서를 참고하세요.
검증
설치 후(CLI든 Helm이든) 다음을 실행해 Linkerd가 정상 상태인지 검증할 수 있어요.
linkerd check
다음 단계
컨트롤 플레인을 설치한 뒤에는 viz나 multicluster 같은 확장을 설치하고 싶을 거예요. 설치 방법은 Using extensions 문서를 참고하세요.
마지막으로, 컨트롤 플레인이 설치되면 Linkerd를 활성화하고 싶은 서비스들을 "메시"해야 해요. 방법은 Adding your services to Linkerd 문서를 참고하세요.
컨트롤 플레인 제거
Uninstalling Linkerd 문서를 참고하세요.