이 항목에서는 부트스트랩 시스템에서 Tanzu CLI(명령줄 인터페이스)를 설치하는 방법을 설명합니다. 부트스트랩 시스템은 관리 및 워크로드 클러스터를 배포하는 랩톱, 호스트 또는 서버이며 배포를 위한 Tanzu 및 Kubernetes 구성 파일을 유지합니다. 부트스트랩 시스템은 일반적으로 로컬이지만 원격으로 액세스하는 물리적 시스템 또는 VM일 수도 있습니다. 명령 참조를 포함하여 Tanzu CLI에 대한 자세한 내용은 VMware Tanzu CLI v1.0.x 설명서를 참조하십시오.
vSphere 8에서 vSphere with Tanzu Supervisor를 관리 클러스터로 사용하는 경우 Tanzu CLI를 설치한 후 Supervisor에 연결할 수 있습니다.
참고이 항목의 지침은 vSphere 8에서 vSphere with Tanzu Supervisor에서 사용할 Tanzu CLI 설치와 관련되어 있습니다. Supervisor가 없는 vSphere 또는 AWS 또는 Azure에 독립형 관리 클러스터를 배포하기 위해 Tanzu CLI를 설치하는 경우, Tanzu Kubernetes Grid 2.3 독립형 관리 클러스터 배포 및 관리, 독립형 관리 클러스터에 사용할 Tanzu CLI 및 Kubernetes CLI 설치의 해당 항목을 참조하십시오.
Tanzu CLI는 Supervisor와 통신하여 vSphere with Tanzu에서 워크로드 클러스터를 생성하고 관리합니다.
중요vSphere 8.0.1c 이상의 vSphere with Tanzu Supervisor는 TKG v2.2를 실행합니다. 이전 버전의 vSphere 8은 Supervisor와 독립적으로 릴리스되지 않은 TKG v2.0을 실행합니다. Supervisor에 내장된 이전 TKG 버전으로 인해 vSphere with Tanzu Supervisor를 사용하여 워크로드 클러스터를 생성하는 경우, 독립형 TKG 2.3 관리 클러스터를 사용하는 경우 사용할 수 있는 기능 중 일부를 사용할 수 없습니다. 이후의 TKG 릴리스는 향후 vSphere 업데이트 릴리스에서 Supervisor에 내장될 예정입니다. 따라서 지정된 시간에 최신 vSphere with Tanzu 버전에 내장된 TKG의 버전이 TKG의 최신 독립형 버전만큼 최신 버전이 아닐 수 있습니다. 그러나 모든 TKG v2.x 릴리스와 호환되는 Tanzu CLI 버전은 모든 vSphere 8 릴리스에서 Supervisor와 함께 사용할 수 있도록 완전히 지원됩니다. 예를 들어 Tanzu CLI v1.0.0은 Supervisor가 제공하는 TKG 2.2 플러그인과 완전히 호환됩니다.
주의TKG 2.x 및 vSphere 8의 vSphere with Tanzu Supervisor와 호환되는 Tanzu CLI 버전은 vSphere 7의 Supervisor 클러스터와 호환되지 않습니다. vSphere 7의 vSphere with Tanzu Supervisor 클러스터에서 Tanzu CLI를 사용하려면 TKG v1.6의 Tanzu CLI 버전을 사용합니다. Supervisor와 TKG 2.x와 호환되는 Tanzu CLI 버전을 사용하려면 vSphere 8로 업그레이드합니다. vSphere with Tanzu Supervisor 클러스터가 없는 경우 독립형 TKG 2.x 관리 클러스터를 vSphere 7에 배포할 수 있습니다. Tanzu CLI와 VMware 제품 간의 호환성에 대한 자세한 내용은 Tanzu CLI 설명서를 참조하십시오.
Tanzu Kubernetes Grid와 함께 사용하기 위해 Tanzu CLI를 설치하고 실행하는 부트스트랩 시스템은 특정 요구 사항을 충족해야 합니다. vSphere with Tanzu Supervisor와 함께 Tanzu CLI를 관리 클러스터로 사용할지, 독립형 관리 클러스터를 배포할지 또는 둘 다 배포할지에 따라 추가 요구 사항이 있습니다.
Tanzu Kubernetes Grid v2.3에서 Tanzu CLI를 실행하려면 다음을 포함하는 Tanzu CLI를 설치하고 실행할 부트스트랩 시스템이 필요합니다.
Supervisor 클러스터를 관리 클러스터로 사용하려면 다음도 필요합니다.
다음과 같은 vSphere 8 계정:
다음 중 하나:
kubectl vsphere
CLI 플러그인.Tanzu Kubernetes Grid v2.3에서 사용할 Tanzu CLI를 설치하려면 호환되는 버전의 Tanzu Core CLI 및 Tanzu Kubernetes Grid v2.3용 Tanzu CLI 플러그인을 설치합니다. 이러한 플러그인에서 제공하는 명령은 클러스터 및 패키지 작업을 사용하도록 설정합니다. 호환되는 CLI 버전 목록은 제품 상호 운용성 매트릭스를 참조하십시오.
Tanzu Core CLI를 설치하려면 아래 단계를 따르십시오. 단계를 보려면 패키지 관리자를 사용하여 설치(Install using a package manager) 또는 바이너리 릴리스에서 설치(Install from a binary release) 탭을 클릭합니다.
Tanzu Core CLI를 설치한 후 TKG v2.3용 Tanzu CLI 플러그인 제거로 이동합니다.
참고Tanzu CLI의 기존 설치를 유지하려면 아래 단계를 수행하기 전에 CLI 바이너리를
/usr/local/bin/tanzu
에서 다른 위치로 이동합니다.
호환되는 Tanzu CLI 버전을 선택합니다. 이 Tanzu Kubernetes Grid 릴리스와 호환되는 CLI 버전 목록은 제품 상호 운용성 매트릭스를 참조하십시오.
아래의 패키지 관리자에 대한 지침을 따르십시오.
APT(Debian 또는 Ubuntu):
설치하려는 버전이 사용 가능한 최신 버전의 Tanzu CLI(예: v1.0.0
)인 경우 다음을 실행합니다.
sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install -y tanzu-cli
이전 버전의 Tanzu CLI(예: v0.90.1
)를 설치하려면 다음을 실행합니다.
sudo apt update
sudo apt install -y ca-certificates curl gpg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list
sudo apt update
sudo apt install tanzu-cli=0.90.1
Chocolatey(Windows):
설치하려는 버전이 사용 가능한 최신 버전의 Tanzu CLI(예: v1.0.0
)인 경우 다음을 실행합니다.
choco install tanzu-cli
이전 버전의 Tanzu CLI(예: v0.90.1
)를 설치하려면 다음을 실행합니다.
choco install tanzu-cli --version 0.90.1
Homebrew(MacOS):
설치하려는 버전이 사용 가능한 최신 버전의 Tanzu CLI(예: v1.0.0
)인 경우 다음을 실행합니다.
brew update
brew install vmware-tanzu/tanzu/tanzu-cli
이전 버전의 Tanzu CLI(예: v0.90.1
)를 설치하려면 다음을 실행합니다.
brew update
brew tap-new local/tap
brew extract --version=0.90.1 vmware-tanzu/tanzu/tanzu-cli local/tap
brew install [email protected]
YUM 또는 DNF(RHEL):
설치하려는 버전이 사용 가능한 최신 버전의 Tanzu CLI(예: v1.0.0
)인 경우 다음을 실행합니다.
cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF
sudo yum install -y tanzu-cli # If you are using DNF, run sudo dnf install -y tanzu-cli.
이전 버전의 Tanzu CLI(예: v0.90.1
)를 설치하려면 다음을 실행합니다.
cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo
[tanzu-cli]
name=Tanzu CLI
baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub
EOF
sudo yum install tanzu-cli-0.90.1 # If you are using DNF, run sudo dnf install tanzu-cli-0.90.1.
올바른 버전의 CLI가 제대로 설치되어 있는지 확인합니다. 예:
tanzu version
version: v1.0.0
...
Customer Connect에서 Tanzu CLI의 바이너리 릴리스를 다운로드한 다음 설치하려면 다음을 수행합니다.
Tanzu CLI 바이너리 다운로드 및 압축 풀기:
해당 OS용 Tanzu CLI 파일의 압축을 풉니다. 파일의 압축을 풀려면 원하는 압축 해제 도구를 사용합니다. 예를 들어 Linux 또는 macOS에서 tar
명령을 사용할 수 있습니다.
macOS:
tar -xvf tanzu-cli-darwin-amd64.tar.gz
Linux:
tar -xvf tanzu-cli-linux-amd64.tar.gz
Windows:
Windows 추출기 도구를 사용하여 tanzu-cli-windows-amd64.zip
의 압축을 풉니다.
시스템에서 CLI를 사용할 수 있도록 합니다.
macOS:
바이너리를 /usr/local/bin
에 설치합니다.
install tanzu-cli-darwin_amd64 /usr/local/bin/tanzu
Linux:
바이너리를 /usr/local/bin
에 설치합니다.
sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
Windows:
Program Files\tanzu
폴더를 생성합니다.tanzu-cli-windows_amd64.exe
파일을 새 Program Files\tanzu
폴더에 복사합니다.tanzu-cli-windows_amd64.exe
의 이름을 tanzu.exe
로 변경합니다.tanzu
폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(Properties) > 보안(Security)을 선택한 후 사용자 계정에 모든 권한(Full Control) 권한이 있는지 확인합니다.env
를 검색합니다.Path
행을 선택하고 편집(Edit)을 클릭합니다.tanzu
CLI에 경로를 입력합니다. 경로 값에는 .exe
확장자가 포함되지 않아야 합니다. 예: C:\Program Files\tanzu
.올바른 버전의 CLI가 제대로 설치되어 있는지 확인합니다. 예:
tanzu version
version: v1.0.0
...
GitHub의 바이너리 릴리스에서 Tanzu CLI를 다운로드하고 설치하려면 Tanzu CLI 설치의 GitHub 프로젝트 섹션의 바이너리 릴리스에서 지침을 따르십시오.
Tanzu Kubernetes Grid v2.3용 독립형 Tanzu CLI 플러그인을 설치하려면 다음을 수행합니다.
Tanzu Kubernetes Grid v2.3용 독립형 Tanzu CLI 플러그인을 나열합니다.
tanzu plugin group get vmware-tkg/default:v2.3.1
표시되는 내용은 다음과 비슷합니다.
Plugins in Group: vmware-tkg/tkg:v2.3.1
NAME TARGET VERSION
isolated-cluster global v0.30.2
management-cluster kubernetes v0.30.2
package kubernetes v0.30.2
pinniped-auth global v0.30.2
secret kubernetes v0.30.2
telemetry kubernetes v0.30.2
vmware-tkg/default
플러그인 그룹에 사용 가능한 모든 버전을 나열하려면 다음을 실행합니다.
tanzu plugin group search -n vmware-tkg/default --show-details
Tanzu Kubernetes Grid v2.3용 독립형 플러그인을 설치합니다.
tanzu plugin install --group vmware-tkg/default:v2.3.1
플러그인이 설치되었는지 확인합니다.
tanzu plugin list
tanzu plugin group get vmware-tkg/default:v2.3.1
에서 반환되는 각 플러그인 이름 및 플러그인 버전은 tanzu plugin list
출력에 포함되어야 합니다.
참고Tanzu Kubernetes Grid용 Tanzu CLI와 독립 실행형 플러그인을 설치한 후 관리 클러스터에 연결하기 전에는 모든 컨텍스트별 CLI 명령 그룹(
tanzu cluster
,tanzu kubernetes-release
)을 사용할 수 없으며 Tanzu CLI--help
출력에 포함되지 않습니다. Tanzu CLI는 관리 클러스터에 연결할 때 컨텍스트 범위 플러그인을 자동으로 설치합니다. Tanzu CLI 플러그인 및 설치 방법에 대한 자세한 내용은 Tanzu CLI 플러그인 설치를 참조하십시오.
부트스트랩 시스템에서 Kubernetes CLI kubectl
을 다운로드하여 압축을 풀고, 시스템에서 사용할 수 있도록 합니다.
VMware Customer Connect로 이동한 후 VMware Customer Connect 자격 증명을 사용하여 로그인합니다.
VMware Tanzu Kubernetes Grid 2.3.1용 Kubectl 1.26.5(Kubectl 1.25.7 for VMware Tanzu Kubernetes Grid 2.2.0) 섹션으로 스크롤합니다.
(선택 사항) 다운로드한 파일이 원래 파일과 달라지지 않는지 확인합니다. VMware는 각 다운로드에 SHA-1, SHA-256, MD5 체크섬을 제공합니다. 이러한 체크섬을 가져오려면 다운로드하려는 항목 아래에서 자세히 읽기(Read More)를 클릭합니다. 자세한 내용은 암호화 해시 사용을 참조하십시오.
해당 운영 체제의 kubectl
바이너리 압축을 풀려면 원하는 추출 도구를 사용합니다. 예: gunzip
명령.
gunzip kubectl-mac-v1.26.8+vmware.2.gz
gunzip kubectl-linux-v1.26.8+vmware.2.gz
kubectl-windows-v1.26.8+vmware.2.exe.gz
의 압축을 풉니다.
시스템에서 CLI를 사용할 수 있도록 합니다.
다운로드한 파일을 실행 파일로 만듭니다.
chmod ugo+x kubectl-mac-v1.26.8+vmware.2
바이너리를 /usr/local/bin
에 설치합니다.
sudo install kubectl-mac-v1.26.8+vmware.2 /usr/local/bin/kubectl
kubectl version
을 실행하여 올바른 버전의 kubectl
가 설치되어 실행 가능한지 확인합니다.
kubectl version
다운로드한 파일을 실행 파일로 만듭니다.
chmod ugo+x kubectl-linux-v1.26.8+vmware.2
바이너리를 /usr/local/bin
에 설치합니다.
sudo install kubectl-linux-v1.26.8+vmware.2 /usr/local/bin/kubectl
kubectl version
을 실행하여 올바른 버전의 kubectl
가 설치되어 실행 가능한지 확인합니다.
kubectl version
Program Files\kubectl
폴더를 생성합니다.kubectl-windows-v1.26.8+vmware.2.exe
파일을 찾아서 새 Program Files\kubectl
폴더에 복사합니다.kubectl-windows-v1.26.8+vmware.2.exe
의 이름을 kubectl.exe
로 변경합니다.kubectl
폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(Properties) > 보안(Security)을 선택한 후 사용자 계정에 모든 권한(Full Control) 권한이 있는지 확인합니다.env
를 검색합니다.Path
행을 선택하고 편집(Edit)을 클릭합니다.kubectl
CLI에 경로를 입력합니다.kubectl version
을 실행하여 올바른 버전의 CLI가 제대로 설치되었는지 확인합니다.
kubectl version
Tanzu CLI 및 kubectl
을 사용하여 워크로드 클러스터 및 서비스 패키지를 Tanzu Kubernetes Grid에 배포하기 전에 아래 설명된 대로 Tanzu CLI를 Supervisor에 연결합니다.
Tanzu CLI를 Supervisor에 연결하려면 다음을 수행합니다.
vCenter에서 Supervisor IP 주소를 가져옵니다.
https://192.168.123.3
)을 기록합니다.IDP 없음: 외부 ID 제공자를 사용하지 않는 경우:
(선택 사항) vSphere with Tanzu 클러스터의 보안 로그인 구성에 설명된 대로 신뢰할 수 있는 인증서로 kubectl vsphere
플러그인을 구성합니다.
kubectl vsphere login
을 실행하여 vSphere에 로그인합니다. 이 단계에 대한 자세한 내용은 Kubectl을 사용하는 vCenter Single Sign-On 사용자로 Supervisor에 연결을 참조하십시오.
kubectl vsphere login --vsphere-username VSPHERE-USERNAME --server=SUPERVISOR-IP
여기서 VSPHERE-USERNAME
은 vCenter SSO(Single Sign-On) 계정 사용자 이름(예: [email protected]
)이고, SUPERVISOR-IP
는 위에서 가져온 Supervisor IP 주소입니다.
신뢰할 수 있는 인증서로 kubectl vsphere
플러그인을 구성하지 않은 경우 위 명령에 --insecure-skip-tls-verify=true
를 추가하여 비보안으로 로그인할 수 있습니다.
주의개발 환경에서는 비보안 로그인만 사용합니다.
vCenter에 로그인하는 데 사용하는 암호를 입력합니다.
로그인에 성공하면 kubectl vsphere login
명령을 실행합니다.
kubeconfig
파일을 생성하거나 수정하여 Kubernetes API로 인증하는 토큰을 추가합니다.kubectl
컨텍스트를 Supervisor로 설정합니다.
kubectl config use-context SUPERVISOR-IP
여기서 SUPERVISOR-IP
는 Supervisor의 컨텍스트입니다. vSphere with Tanzu 서비스 및 워크로드에서 Supervisor 컨텍스트 가져오기 및 사용을 참조하십시오.
정보를 수집하여 Supervisor를 연결하는 tanzu context create
명령을 실행합니다.
kubeconfig
파일의 경로로 기본값은 ~/.kube/config
이며, KUBECONFIG
환경 변수로 설정됩니다.tanzu context create
명령을 실행하여 위 값을 입력합니다. 예를 들면 다음과 같습니다.
IDP 없음:
tanzu context create my-supervisor --kubeconfig ~/.kube/config --kubecontext 192.168.123.3
그러면 Supervisor 컨텍스트가 Tanzu CLI에 등록되고 Supervisor와 관련된 플러그인이 다운로드됩니다.
[ok] successfully logged in to management cluster using the kubeconfig my-supervisor
[i] Checking for required plugins...
[i] Installing plugin 'cluster:v0.29' with target 'kubernetes'
[i] Plugin binary for 'cluster:v0.29' found in cache
[i] Installing plugin 'feature:v0.29' with target 'kubernetes'
[i] Plugin binary for 'feature:v0.29' found in cache
[i] Installing plugin 'kubernetes-release:v0.29' with target 'kubernetes'
[i] Plugin binary for 'kubernetes-release:v0.29' found in cache
[i] Installing plugin 'namespaces:v1.0.0' with target 'kubernetes'
[i] Plugin binary for 'namespaces:v1.0.0' found in cache
[i] Successfully installed all required plugins
IDP 있음:
tanzu context create --endpoint https://10.73.27.32 --name oidc-user
tanzu context use https://10.73.27.32 oidc-user
Detected a vSphere Supervisor being used
Log in by visiting this link:
...
https://10.27.62.33/wcp/pinniped/oauth2/authorize?..
...
Optionally, paste your authorization code: G2TcS145Q4e6A1YKf743n3BJlfQAQ_UdjXy38TtEEIo.ju4QV3PTsUvOigVUtQllZ7AJFU0YnjuLHTRVoNxvdZc
...
??? successfully logged in to management cluster using the kubeconfig oidc-user
Checking for required plugins...
All required plugins are already installed and up-to-date
위 예에서 https://10.73.27.32
는 Supervisor 제어부 IP 주소입니다. 이 단계에 대한 자세한 내용은 Tanzu CLI 및 외부 IDP를 사용하여 Supervisor에 연결을 참조하십시오.
tanzu context list
를 실행하여 Supervisor가 추가되었는지 확인합니다. 예를 들면 다음과 같습니다.
tanzu context list
NAME ISACTIVE ENDPOINT KUBECONFIGPATH KUBECONTEXT
my-supervisor true https://192.168.123.3:443 /home/vmware/.kube/config 192.168.123.3
이제 tanzu context use
이 사용자가 입력한 이름으로 Supervisor를 표시합니다.
tanzu context use
? Select a server [Use arrows to move, type to filter]
> my-supervisor ()
+ new server
tanzu plugin list
를 실행하여 Supervisor별 플러그인 목록과 독립형 CLI 플러그인 목록을 확인합니다.
tanzu plugin list
Standalone Plugins
NAME DESCRIPTION TARGET VERSION STATUS
isolated-cluster Prepopulating images/bundle for internet-restricted environments global v0.30.2 installed
pinniped-auth Pinniped authentication operations (usually not directly invoked) global v0.30.2 installed
management-cluster Kubernetes management cluster operations kubernetes v0.30.2 installed
package Tanzu package management kubernetes v0.30.2 installed
secret Tanzu secret management kubernetes v0.30.2 installed
telemetry Configure cluster-wide settings for vmware tanzu telemetry kubernetes v0.30.2 installed
Plugins from Context: my-supervisor
NAME DESCRIPTION TARGET VERSION STATUS
cluster Kubernetes cluster operations kubernetes v0.29.0 installed
feature Operate on features and featuregates kubernetes v0.29.0 installed
kubernetes-release Kubernetes release operations kubernetes v0.29.0 installed
namespaces Discover vSphere Supervisor namespaces you have access to kubernetes v1.0.0 installed
참고vSphere 8.0.1c에서는 Supervisor 컨텍스트용 플러그인의 버전이 v0.29.0입니다.