독립형 관리 클러스터에서 사용할 Tanzu CLI 및 Kubernetes CLI 설치

이 항목에서는 부트스트랩 시스템에서 Tanzu CLI(명령줄 인터페이스)를 설치하는 방법을 설명합니다. 부트스트랩 시스템은 관리 및 워크로드 클러스터를 배포하는 랩톱, 호스트 또는 서버이며 배포를 위한 Tanzu 및 Kubernetes 구성 파일을 유지합니다. 부트스트랩 시스템은 일반적으로 로컬이지만 원격으로 액세스하는 물리적 시스템 또는 VM일 수도 있습니다. 명령 참조를 포함하여 Tanzu CLI에 대한 자세한 내용은 VMware Tanzu CLI v1.0.x 설명서를 참조하십시오.

Supervisor가 없는 vSphere 또는 AWS 또는 Azure에서 Tanzu Kubernetes Grid를 배포하려는 경우, Tanzu CLI를 사용하여 환경의 각 클라우드 제공자에 독립형 관리 클러스터를 생성합니다. Tanzu CLI는 이 관리 클러스터와 통신하여 대상 클라우드 인프라에서 워크로드 클러스터를 생성하고 관리합니다.

참고

이 항목의 지침은 Supervisor가 없는 vSphere 또는 AWS 또는 Azure에서 독립형 관리 클러스터를 배포하기 위해 Tanzu CLI를 설치하는 방법에만 해당됩니다. vSphere 8에서 vSphere with Tanzu Supervisor와 함께 사용할 Tanzu CLI를 설치하는 경우 Tanzu CLI를 사용하여 TKG 2.4 워크로드 클러스터 생성 및 관리 vSphere with Tanzu Supervisor에서 사용할 Tanzu CLI 및 Kubernetes CLI 설치의 해당 항목을 참조하십시오.

사전 요구 사항

Tanzu Kubernetes Grid와 함께 사용하기 위해 Tanzu CLI를 설치하고 실행하는 부트스트랩 시스템은 특정 요구 사항을 충족해야 합니다. vSphere with Tanzu Supervisor와 함께 Tanzu CLI를 관리 클러스터로 사용할지, 독립형 관리 클러스터를 배포할지 또는 둘 다 배포할지에 따라 추가 요구 사항이 있습니다.

Tanzu Kubernetes Grid v2.4에서 Tanzu CLI를 실행하려면 다음을 포함하는 Tanzu CLI를 설치하고 실행할 부트스트랩 시스템이 필요합니다.

  • 다음과 같은 하드웨어가 있는 물리적 또는 가상 시스템에서 실행되는 Linux, Windows 또는 macOS 운영 체제:
    • 8GB RAM 이상. VMware는 16GB RAM을 권장합니다.
    • 사용 가능한 스토리지가 50GB인 디스크.
    • 2코어 CPU 2개 또는 4개.
  • Tanzu Kubernetes Grid 설치 관리자 인터페이스를 사용하여 독립형 관리 클러스터를 배포하려는 경우 브라우저가 있는 시스템에서 브라우저 또는 원격 액세스. 브라우저 없이 Tanzu CLI를 사용할 수 있지만 첫 번째 배포의 경우 설치 관리자 인터페이스를 사용하는 것이 강력히 권장됩니다.
  • 시스템 시간이 NTP(Network Time Protocol) 서버와 동기화됩니다.

  • 부트스트랩 시스템이 Windows 실행되는 경우 VMware Ubuntu 20.04.4 LTS가 있는 Linux용 Windows WSL(Subsystem)을 설치하여 Windows Linux 명령을 실행할 것을 권장합니다. WSL에 대한 자세한 내용은 Microsoft 설명서에서 WSL 설치를 참조하십시오.

  • VMware Cloud on AWS 및 Azure VMware Solution에서 부트스트랩 시스템은 로컬 물리적 시스템이 아닌 클라우드 VM이어야 합니다. 설정 지침은 VMware Cloud 환경에 관리 클러스터를 배포하기 위한 준비를 참조하십시오.

  • 독립형 관리 클러스터를 배포하려면 부트스트랩 시스템이 실행 중인 운영 체제에 따라 추가적인 요구 사항이 있습니다.

    macOS
    • Docker Desktop이 부트스트랩 시스템에 설치되어 실행되고 있습니다.
    • kind 컨테이너를 수용하려면 Docker Desktop에서 6GB 이상의 메모리를 할당합니다. kind 설명서의 Docker 데스크톱 설정을 참조하십시오.
    Linux
    • Docker가 부트스트랩 시스템에 설치되어 실행되고 있습니다. 패키지 관리자에서 Docker를 설치하려면 apt 대신 snap을 사용합니다. 인터넷이 제한된 환경에서 Docker 클라이언트 애플리케이션을 설치하는 방법에 대한 지침은 인터넷 제한 환경 준비를 참조하십시오.
    • 루트가 아닌 사용자 계정을 docker 사용자 그룹에 추가합니다. 아직 없는 경우 그룹을 생성합니다. 이렇게 하면 Tanzu CLI가 root 사용자가 소유한 Docker 소켓에 액세스할 수 있습니다. 자세한 내용은 Docker 설명서의 비-루트 사용자로 Docker 관리를 참조하십시오.

    • 부트스트랩 시스템이 Ubuntu 22.04를 실행하는 경우 역방향 경로 필터링이 비활성화되어 있는지 확인합니다. 역방향 경로 필터링을 비활성화하려면 다음 재정의를 추가합니다.

      # New file /etc/sysctl.d/90-override.conf
ipv4.conf.all.rp_filter = 0

    • 부트스트랩 시스템에 2021년 5월 Linux 보안 패치 이후에 빌드된 Linux 커널이 있는 경우, Tanzu CLI가 로컬 부트스트랩 클러스터를 생성하는 데 사용하는 kind를 사용하도록 설정하여 최근 Linux 버전이 기본적으로 읽기 전용으로 만든 제어 파일에 기록해야 합니다.

      이 파일 사용 권한을 변경하는 방법은 Linux 배포에 따라 다릅니다. 예를 들어 Linux 5.11 및 5.12의 Fedora 배포에서는 다음을 실행합니다.

      sudo sysctl net/netfilter/nf_conntrack_max=131072

      Debian 배포를 사용하여 sysctl.conf 파일에 nf_conntrack_max=131072를 추가하고 다음을 실행합니다.

      sudo modprobe nf_conntrack

      기존 부트스트랩 클러스터를 사용하여 관리 클러스터 배포 및 삭제에 설명된 대로 문제를 해결하는 경우 kind v0.11 이상을 사용하여 기존 및 영구 부트스트랩 클러스터를 생성해야 합니다.

    Windows
    • Docker Desktop이 부트스트랩 시스템에 설치되어 실행되고 있습니다.
    • kind 컨테이너를 수용하려면 Docker Desktop에서 6GB 이상의 메모리를 할당합니다. kind 설명서의 Docker 데스크톱 설정을 참조하십시오.

    • 부트스트랩 시스템이 Linux용 Windows 하위 시스템을 2021년 5월 Linux 보안 패치(예: Fedora가 포함된 Linux 5.11 및 5.12) 이후에 구축된 Linux 커널을 사용하는 경우 다음을 실행합니다.

      sudo sysctl net/netfilter/nf_conntrack_max=131072

      이렇게 하면 kind CLI가 로컬 부트스트랩 클러스터를 생성하는 데 사용하는 tanzu를 사용하여 최근 Linux 버전이 기본적으로 읽기 전용으로 만든 제어 파일에 쓸 수 있습니다.
      기존 부트스트랩 클러스터를 사용하여 관리 클러스터 배포 및 삭제에 설명된 대로 문제를 해결하는 경우 kind v0.11 이상을 사용하여 기존 및 영구 부트스트랩 클러스터를 생성해야 합니다.


Tanzu CLI 설치

Tanzu Kubernetes Grid v2.4에서 사용할 Tanzu CLI를 설치하려면 호환되는 버전의 Tanzu Core CLI와 Tanzu Kubernetes Grid v2.4용 Tanzu CLI 플러그인을 설치합니다. 이러한 플러그인에서 제공하는 명령은 클러스터 및 패키지 작업을 사용하도록 설정합니다. 호환되는 CLI 버전 목록은 제품 상호 운용성 매트릭스를 참조하십시오.

Tanzu Core CLI 설치

Tanzu Core CLI를 설치하려면 아래 단계를 따르십시오. 단계를 보려면 패키지 관리자를 사용하여 설치(Install using a package manager) 또는 바이너리 릴리스에서 설치(Install from a binary release) 탭을 클릭합니다.

Tanzu Core CLI를 설치한 후 TKG v2.4용 Tanzu CLI 플러그인 제거로 이동합니다.

참고

Tanzu CLI의 기존 설치를 유지하려면 아래 단계를 수행하기 전에 CLI 바이너리를 /usr/local/bin/tanzu에서 다른 위치로 이동합니다.

패키지 관리자를 사용하여 설치
패키지 관리자를 사용하여 Tanzu CLI를 설치하려면 다음을 수행합니다.

  1. 호환되는 Tanzu CLI 버전을 선택합니다. 이 Tanzu Kubernetes Grid 릴리스와 호환되는 CLI 버전 목록은 제품 상호 운용성 매트릭스를 참조하십시오.

  2. 아래의 패키지 관리자에 대한 지침을 따르십시오.

    • 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.

  3. 올바른 버전의 CLI가 제대로 설치되어 있는지 확인합니다. 예:

    tanzu version
version: v1.0.0
...
바이너리 릴리스에서 설치
VMware Customer Connect 또는 GitHub에서 Tanzu CLI 바이너리를 다운로드할 수 있습니다. 호환되는 모든 CLI 버전 목록은 제품 상호 운용성 매트릭스를 참조하십시오.

Customer Connect에서 Tanzu CLI의 바이너리 릴리스를 다운로드한 다음 설치하려면 다음을 수행합니다.

  1. Tanzu CLI 바이너리 다운로드 및 압축 풀기:

    1. VMware Customer Connect의 VMware Tanzu CLI 페이지로 이동하고 Tanzu CLI v1.0.0의 제품 다운로드(Product Downloads)에서 해당 운영 체제(OS)용 Tanzu CLI 바이너리를 찾아 다운로드합니다.

    2. 해당 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의 압축을 풉니다.

  2. 시스템에서 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:

      1. 새 Program Files\tanzu 폴더를 생성합니다.
      2. tanzu-cli-windows_amd64.exe 파일을 새 Program Files\tanzu 폴더에 복사합니다.
      3. tanzu-cli-windows_amd64.exe의 이름을 tanzu.exe로 변경합니다.
      4. tanzu 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(Properties) > 보안(Security)을 선택한 후 사용자 계정에 모든 권한(Full Control) 권한이 있는지 확인합니다.
      5. Windows 검색을 사용하여 env를 검색합니다.
      6. 시스템 환경 변수 편집(Edit the system environment variables)를 선택하고 환경 변수(Environment Variables) 버튼을 클릭합니다.
      7. 시스템 변수(System variables) 아래에서 Path 행을 선택하고 편집(Edit)을 클릭합니다.
      8. 새로 만들기(New)를 클릭하여 새 행을 추가하고 tanzu CLI에 경로를 입력합니다. 경로 값에는 .exe 확장자가 포함되지 않아야 합니다. 예: C:\Program Files\tanzu.

  3. 올바른 버전의 CLI가 제대로 설치되어 있는지 확인합니다. 예:

    tanzu version
version: v1.0.0
...

GitHub의 바이너리 릴리스에서 Tanzu CLI를 다운로드하고 설치하려면 Tanzu CLI 설치의 GitHub 프로젝트 섹션의 바이너리 릴리스에서 지침을 따르십시오.

TKG v2.4용 Tanzu CLI 플러그인 설치

Tanzu Kubernetes Grid v2.4용 독립형 Tanzu CLI 플러그인을 설치하려면 다음을 수행합니다.

  1. Tanzu Kubernetes Grid v2.4에 대한 독립형 Tanzu CLI 플러그인을 나열합니다.

    tanzu plugin group get vmware-tkg/default:v2.4.0

    표시되는 내용은 다음과 비슷합니다.

    Plugins in Group:  vmware-tkg/default:v2.4.0
  NAME                TARGET      VERSION
  isolated-cluster    global      v0.31.0
  management-cluster  kubernetes  v0.31.0
  package             kubernetes  v0.31.0
  pinniped-auth       global      v0.31.0
  secret              kubernetes  v0.31.0
  telemetry           kubernetes  v0.31.0

    vmware-tkg/default 플러그인 그룹에 사용 가능한 모든 버전을 나열하려면 다음을 실행합니다.

    tanzu plugin group search -n vmware-tkg/default --show-details

  2. Tanzu Kubernetes Grid v2.4용 독립형 플러그인을 설치합니다.

    tanzu plugin install --group vmware-tkg/default:v2.4.0

  3. 플러그인이 설치되었는지 확인합니다.

    tanzu plugin list

    tanzu plugin group get vmware-tkg/default:v2.4.0에서 반환되는 각 플러그인 이름 및 플러그인 버전은 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 설치

부트스트랩 시스템에서 Kubernetes CLI kubectl을 다운로드하여 압축을 풀고, 시스템에서 사용할 수 있도록 합니다.

  1. VMware Customer Connect로 이동한 후 VMware Customer Connect 자격 증명을 사용하여 로그인합니다.

  2. Tanzu Kubernetes Grid 다운로드 페이지를 방문합니다.

  3. VMware Tanzu Kubernetes Grid 행에서 다운로드로 이동(Go to Downloads)을 클릭합니다.

  4. 버전 선택(Select Version) 드롭다운에서 2.4.0을 선택합니다.

  5. 제품 다운로드(Product Downloads)에서 VMware Tanzu Kubernetes Grid 2.4.0용 Kubectl 1.27.5(Kubectl 1.27.5 for VMware Tanzu Kubernetes Grid 2.4.0) 섹션으로 스크롤합니다.

    macOS
    Mac용 kubectl cli v1.27.5(kubectl cluster cli v1.23.8 for Mac)을 찾아 지금 다운로드(Download Now)를 클릭합니다.
    Linux
    Linux용 kubectl cli v1.27.5(kubectl cluster cli v1.23.8 for Linux)을 찾아 지금 다운로드(Download Now)를 클릭합니다.
    Windows
    Windows용 kubectl cli v1.27.5(kubectl cluster cli v1.23.8 for Windows)을 찾아 지금 다운로드(Download Now)를 클릭합니다.

  6. (선택 사항) 다운로드한 파일이 원래 파일과 달라지지 않는지 확인합니다. VMware는 각 다운로드에 SHA-1, SHA-256, MD5 체크섬을 제공합니다. 이러한 체크섬을 가져오려면 다운로드하려는 항목 아래에서 자세히 읽기(Read More)를 클릭합니다. 자세한 내용은 암호화 해시 사용을 참조하십시오.

  7. 해당 운영 체제의 kubectl 바이너리 압축을 풀려면 원하는 추출 도구를 사용합니다. 예: gunzip 명령.

    macOS 
    gunzip kubectl-mac-v1.27.5+vmware.1.gz
    Linux 
    gunzip kubectl-linux-v1.27.5+vmware.1.gz
    Windows
    Windows 추출기 도구를 사용하여 kubectl-windows-v1.27.5+vmware.2.exe.gz의 압축을 풉니다.

  8. 시스템에서 CLI를 사용할 수 있도록 합니다.

    macOS

    1. 다운로드한 파일을 실행 파일로 만듭니다.

      chmod ugo+x kubectl-mac-v1.27.5+vmware.1

    2. 바이너리를 /usr/local/bin에 설치합니다.

      sudo install kubectl-mac-v1.27.5+vmware.1 /usr/local/bin/kubectl

    3. kubectl version을 실행하여 올바른 버전의 kubectl가 설치되어 실행 가능한지 확인합니다.

      kubectl version
    Linux

    1. 다운로드한 파일을 실행 파일로 만듭니다.

      chmod ugo+x kubectl-linux-v1.27.5+vmware.1

    2. 바이너리를 /usr/local/bin에 설치합니다.

      sudo install kubectl-linux-v1.27.5+vmware.1 /usr/local/bin/kubectl

    3. kubectl version을 실행하여 올바른 버전의 kubectl가 설치되어 실행 가능한지 확인합니다.

      kubectl version
    Windows
    1. 새 Program Files\kubectl 폴더를 생성합니다.
    2. kubectl-windows-v1.27.5+vmware.1.exe 파일을 찾아서 새 Program Files\kubectl 폴더에 복사합니다.
    3. kubectl-windows-v1.27.5+vmware.1.exe의 이름을 kubectl.exe로 변경합니다.
    4. kubectl 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(Properties) > 보안(Security)을 선택한 후 사용자 계정에 모든 권한(Full Control) 권한이 있는지 확인합니다.
    5. Windows 검색을 사용하여 env를 검색합니다.
    6. 시스템 환경 변수 편집(Edit the system environment variables)를 선택하고 환경 변수(Environment Variables) 버튼을 클릭합니다.
    7. 시스템 변수(System variables) 아래에서 Path 행을 선택하고 편집(Edit)을 클릭합니다.
    8. 새로 만들기(New)를 클릭하여 새 행을 추가하고 kubectl CLI에 경로를 입력합니다.

    9. kubectl version을 실행하여 올바른 버전의 CLI가 제대로 설치되었는지 확인합니다.

      kubectl version

후속 작업

독립형 관리 클러스터를 클라우드 제공자에 배포하려면 독립형 관리 클러스터 배포 지침을 따르십시오.

check-circle-line exclamation-circle-line close-line
Scroll to top icon