vSphere with Tanzu Supervisor에서 사용할 Tanzu CLI 및 기타 도구 설치

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

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.1 독립형 관리 클러스터 배포 및 관리, 독립형 관리 클러스터에 사용할 Tanzu CLI 및 기타 도구 설치의 해당 항목을 참조하십시오.

Tanzu CLI는 Supervisor와 통신하여 vSphere with Tanzu에서 워크로드 클러스터를 생성하고 관리합니다.

vSphere 8에서 Tanzu Kubernetes Grid v2.x 및 vSphere with Tanzu Supervisor

중요

vSphere 8.0.1c 이상의 vSphere with Tanzu Supervisor는 TKG v2.2를 실행합니다. 이전 버전의 vSphere 8은 Supervisor와 독립적으로 릴리스되지 않은 TKG v2.0을 실행합니다. TKG 2.x를 실행하는 독립형 관리 클러스터는 TKG 2.1부터 사용할 수 있습니다. 이후의 TKG 릴리스는 향후 vSphere 업데이트 릴리스에서 Supervisor에 내장될 예정입니다. 따라서 지정된 시간에 최신 vSphere with Tanzu 버전에 내장된 TKG의 버전이 사용 중인 독립형 TKG 버전과 동일하지 않을 수 있습니다. 그러나 모든 TKG v2.x 릴리스와 호환되는 Tanzu CLI 버전은 모든 vSphere 8 릴리스에서 Supervisor와 함께 사용할 수 있도록 완전히 지원됩니다.

vSphere 7에서 v2.1 및 vSphere with Tanzu Tanzu Kubernetes Grid

주의

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 CLI에 대한 자세한 내용은 VMware Tanzu CLI 설명서를 참조하십시오.

사전 요구 사항

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

Tanzu Kubernetes Grid v2.1에서 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 설치를 참조하십시오.

Supervisor 클러스터를 관리 클러스터로 사용하려면 다음도 필요합니다.

Tanzu CLI 다운로드 및 압축 풀기

Tanzu Kubernetes Grid 다운로드 페이지에서 호환되는 Tanzu CLI 버전의 파일을 다운로드합니다.

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

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

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

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

  5. 제품 다운로드(Product Downloads)에서 VMware Tanzu CLI 2.1.1 섹션으로 스크롤합니다.

    macOS
    Mac용 VMware Tanzu CLI(VMware Tanzu CLI for Mac)를 찾아 지금 다운로드(Download Now)를 클릭합니다.
    Linux
    Linux용 VMware Tanzu CLI(VMware Tanzu CLI for Linux)를 찾아 지금 다운로드(Download Now)를 클릭합니다.
    Windows
    Windows용 VMware Tanzu CLI(VMware Tanzu CLI for Windows)를 찾아 지금 다운로드(Download Now)를 클릭합니다.

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

  7. 시스템에서 이름이 tanzu라는 새 디렉토리를 생성합니다. 이전에 이 폴더에 이전 릴리스의 아티팩트를 압축 해제한 경우 폴더의 기존 내용을 삭제합니다.

  8. tanzu 폴더에서 운영 체제용 Tanzu CLI 번들 파일의 압축을 풉니다. 번들 파일의 압축을 풀려면 선택한 압축 해제 도구를 사용합니다. 예를 들어 Linux 또는 macOS에서 tar 명령을 사용할 수 있습니다.

    macOS 
    tar -xvf tanzu-cli-bundle-darwin-amd64.tar.gz
    Linux 
    tar -xvf tanzu-cli-bundle-linux-amd64.tar.gz
    Windows
    Windows 추출기 도구를 사용하여 tanzu-cli-bundle-windows-amd64.zip의 압축을 풉니다.

    번들 파일의 압축을 풀면 tanzu 폴더에 여러 하위 폴더와 파일이 포함된 cli 폴더가 표시됩니다.

Tanzu CLI 초기화

부트스트랩 시스템에서 Tanzu CLI를 다운로드하고 압축을 푼 후에는 시스템에서 사용할 수 있도록 설정해야 합니다.

  1. 이전 섹션에서 압축을 푼 tanzu 폴더 아래의 cli 하위 폴더로 이동합니다.

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

    macOS
    바이너리를 /usr/local/bin에 설치합니다. 
    sudo install core/v0.28.1/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
    Linux
    바이너리를 /usr/local/bin에 설치합니다. 
    sudo install core/v0.28.1/tanzu-core-linux_amd64 /usr/local/bin/tanzu
    Windows
    1. 새 Program Files\tanzu 폴더를 생성합니다.
    2. 압축을 푼 cli 폴더에서 core\v0.28.1\tanzu-core-windows_amd64.exe 파일을 찾아서 새 Program Files\tanzu 폴더에 복사합니다.
    3. tanzu-core-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에 경로를 입력합니다.

  3. 새 터미널의 명령줄에서 Tanzu CLI를 초기화합니다.

    tanzu init

  4. 올바른 버전의 CLI가 제대로 설치되어 있는지 확인합니다. CLI 버전은 Tanzu CLI에 포함된 Tanzu Framework의 현재 버전과 동일합니다. Tanzu Kubernetes Grid 2.1.1은 Tanzu Framework v0.28.1에 있는 Tanzu CLI v0.28.1을 사용합니다.

    tanzu version

    macOS에서 실행 중인 경우 다음 오류가 발생할 수 있습니다.

    "tanzu" cannot be opened because the developer cannot be verified.

    이 경우 tanzu 실행 파일의 보안 예외를 생성해야 합니다. Finder에서 tanzu 애플리케이션을 찾아서 Control+클릭한 후 열기(Open)를 선택합니다.

  5. 이전 CLI 설치에서 시스템에 기존 Tanzu CLI 플러그인이 설치되어 있는 경우 플러그인을 현재 CLI 버전으로 업데이트합니다.

    1. 기존 플러그인 제거:

      tanzu plugin clean

    2. 이 릴리스에 대한 모든 플러그인을 설치합니다.

      tanzu plugin sync

    3. 플러그인 설치 상태 및 버전 확인:

      tanzu plugin list
참고

Tanzu CLI를 설치했지만 관리 클러스터 로그인에 이 CLI를 사용한 후에는 모든 컨텍스트별 CLI 명령(예: tanzu cluster, tanzu kubernetes-release)을 사용할 수 없으며 Tanzu CLI --help 출력에 포함되지 않습니다.

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.1.1을 선택합니다.

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

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

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

  7. 위의 Tanzu CLI 다운로드 및 압축 풀기에서 생성한 tanzu 디렉토리로 이동하고 해당 운영 체제의 kubectl 바이너리의 압축을 풉니다. 번들 파일의 압축을 풀려면 선택한 압축 해제 도구를 사용합니다. 예: gunzip 명령.

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

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

    macOS

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

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

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

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

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

      kubectl version
    Linux

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

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

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

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

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

      kubectl version
    Windows
    1. 새 Program Files\kubectl 폴더를 생성합니다.
    2. kubectl-windows-v1.24.10+vmware.1.exe 파일을 찾아서 새 Program Files\kubectl 폴더에 복사합니다.
    3. kubectl-windows-v1.24.10+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가 제대로 설치되었는지 확인합니다.

Tanzu CLI 도움말

tanzu --help를 실행하여 Tanzu CLI가 제공하는 명령 목록을 확인합니다.

--help 옵션을 사용하여 모든 명령 그룹의 도움말 텍스트를 확인하면 특정 명령 또는 명령 그룹에 대한 정보를 볼 수 있습니다. 예: tanzu login --help, tanzu management-cluster --help 또는 tanzu management-cluster create --help.

Tanzu CLI에 대한 자세한 내용은 Tanzu CLI 명령 참조를 참조하십시오.

Carvel 도구 설치

Carvel 오픈 소스 프로젝트는 애플리케이션을 구축하고 구성하고 Kubernetes에 배포하는 데 도움이 되는, 신뢰할 수 있는 단일 용도의 구성 가능한 도구 집합을 제공합니다.

Tanzu Kubernetes Grid는 Tanzu CLI와 함께 제공되는 ytt, kapp, kbld, imgpkg의 서명된 바이너리를 제공합니다. 번들에는 Kubernetes 디렉토리 구조 도구인 vendir(최종 사용자가 현재 필요하지는 않지만 편의를 위해 제공)도 포함되어 있습니다.

Carvel 도구 찾기

  1. OS용 Tanzu CLI 번들 tar 파일의 압축을 푼 부트스트랩 환경 시스템의 위치로 이동합니다.

    예를 들어 이전 절차에서 생성한 tanzu 폴더입니다.

  2. cli 폴더를 엽니다.

    cd cli

ytt 설치

ytt YAML 파일의 템플릿 및 패치 적용을 위한 명령줄 도구입니다. 또한 ytt를 사용하여 YAML 조각과 더미를 모듈식 청크로 수집하여 쉽게 재사용할 수 있습니다. Tanzu Kubernetes Grid는 ytt를 사용하여 클러스터 및 클러스터 계획의 오버레이 기반 사용자 지정을 지원합니다. 사용자 지정 오버레이를 사용하려면 ytt가 필요할 수 있습니다.

macOS

  1. ytt 바이너리의 압축을 풀고 실행 파일로 만듭니다.

    gunzip ytt-darwin-amd64-v0.43.1+vmware.1.gz

    chmod ugo+x ytt-darwin-amd64-v0.43.1+vmware.1

  2. 바이너리를 /usr/local/bin으로 이동하고 이름을 ytt로 바꿉니다.

    sudo mv ./ytt-darwin-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt

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

    ytt --version
Linux

  1. ytt 바이너리의 압축을 풀고 실행 파일로 만듭니다.

    gunzip ytt-linux-amd64-v0.43.1+vmware.1.gz

    chmod ugo+x ytt-linux-amd64-v0.43.1+vmware.1

  2. 바이너리를 /usr/local/bin으로 이동하고 이름을 ytt로 바꿉니다.

    sudo mv ./ytt-linux-amd64-v0.43.1+vmware.1 /usr/local/bin/ytt

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

    ytt --version
Windows

  1. ytt 바이너리의 압축을 풉니다.

    gunzip ytt-windows-amd64-v0.43.1+vmware.1.gz

  2. ytt-windows-amd64-v0.43.1+vmware.1의 이름을 ytt.exe로 바꿉니다.

  3. 새 Program Files\ytt 폴더를 생성하고 ytt.exe 파일을 복사합니다.
  4. ytt 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(Properties) > 보안(Security)을 선택한 후 사용자 계정에 모든 권한(Full Control) 권한이 있는지 확인합니다.
  5. Windows 검색을 사용하여 env를 검색합니다.
  6. 시스템 환경 변수 편집(Edit the system environment variables)를 선택하고 환경 변수(Environment Variables) 버튼을 클릭합니다.
  7. 시스템 변수(System variables) 아래에서 Path 행을 선택하고 편집(Edit)을 클릭합니다.
  8. 새로 만들기(New)를 클릭하여 새 행을 추가하고 ytt 도구에 경로를 입력합니다.
  9. 새 터미널의 명령줄에서 ytt version을 실행하여 올바른 버전의 ytt가 올바르게 설치되어 있는지 확인합니다.


kapp 설치

kapp Kubernetes용 애플리케이션 배포 CLI입니다. 이를 통해 여러 Kubernetes 리소스를 하나의 애플리케이션으로 설치, 업그레이드, 삭제할 수 있습니다.

macOS

  1. kapp 바이너리의 압축을 풀고 실행 파일로 만듭니다.

    gunzip kapp-darwin-amd64-v0.53.2+vmware.1.gz

    chmod ugo+x kapp-darwin-amd64-v0.53.2+vmware.1

  2. 바이너리를 /usr/local/bin으로 이동하고 이름을 kapp로 바꿉니다.

    sudo mv ./kapp-darwin-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp

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

    kapp --version
Linux

  1. kapp 바이너리의 압축을 풀고 실행 파일로 만듭니다.

    gunzip kapp-linux-amd64-v0.53.2+vmware.1.gz

    chmod ugo+x kapp-linux-amd64-v0.53.2+vmware.1

  2. 바이너리를 /usr/local/bin으로 이동하고 이름을 kapp로 바꿉니다.

    sudo mv ./kapp-linux-amd64-v0.53.2+vmware.1 /usr/local/bin/kapp

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

    kapp --version
Windows

  1. kapp 바이너리의 압축을 풉니다.

    gunzip kapp-windows-amd64-v0.53.2+vmware.1.gz

  2. kapp-windows-amd64-v0.53.2+vmware.1의 이름을 kapp.exe로 바꿉니다.

  3. 새 Program Files\kapp 폴더를 생성하고 kapp.exe 파일을 복사합니다.
  4. kapp 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(Properties) > 보안(Security)을 선택한 후 사용자 계정에 모든 권한(Full Control) 권한이 있는지 확인합니다.
  5. Windows 검색을 사용하여 env를 검색합니다.
  6. 시스템 환경 변수 편집(Edit the system environment variables)를 선택하고 환경 변수(Environment Variables) 버튼을 클릭합니다.
  7. 시스템 변수(System variables) 아래에서 Path 행을 선택하고 편집(Edit)을 클릭합니다.
  8. 새로 만들기(New)를 클릭하여 새 행을 추가하고 kapp 도구에 경로를 입력합니다.
  9. 새 터미널의 명령줄에서 kapp version을 실행하여 올바른 버전의 kapp가 올바르게 설치되어 있는지 확인합니다.


kbld 설치

kbld 이미지 구축 및 해상도 도구입니다.

macOS

  1. kbld 바이너리의 압축을 풀고 실행 파일로 만듭니다.

    gunzip kbld-darwin-amd64-v0.35.1+vmware.1.gz

    chmod ugo+x kbld-darwin-amd64-v0.35.1+vmware.1

  2. 바이너리를 /usr/local/bin으로 이동하고 이름을 kbld로 바꿉니다.

    sudo mv ./kbld-darwin-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld

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

Linux

  1. kbld 바이너리의 압축을 풀고 실행 파일로 만듭니다.

    gunzip kbld-linux-amd64-v0.35.1+vmware.1.gz

    chmod ugo+x kbld-linux-amd64-v0.35.1+vmware.1

  2. 바이너리를 /usr/local/bin으로 이동하고 이름을 kbld로 바꿉니다.

    sudo mv ./kbld-linux-amd64-v0.35.1+vmware.1 /usr/local/bin/kbld

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

    kbld --version
Windows

  1. kbld 바이너리의 압축을 풉니다.

    gunzip kbld-windows-amd64-v0.35.1+vmware.1.gz

  2. kbld-windows-amd64-v0.35.1+vmware.1의 이름을 kbld.exe로 바꿉니다.

  3. 새 Program Files\kbld 폴더를 생성하고 kbld.exe 파일을 복사합니다.
  4. kbld 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(Properties) > 보안(Security)을 선택한 후 사용자 계정에 모든 권한(Full Control) 권한이 있는지 확인합니다.
  5. Windows 검색을 사용하여 env를 검색합니다.
  6. 시스템 환경 변수 편집(Edit the system environment variables)를 선택하고 환경 변수(Environment Variables) 버튼을 클릭합니다.
  7. 시스템 변수(System variables) 아래에서 Path 행을 선택하고 편집(Edit)을 클릭합니다.
  8. 새로 만들기(New)를 클릭하여 새 행을 추가하고 kbld 도구에 경로를 입력합니다.
  9. 새 터미널의 명령줄에서 kbld version을 실행하여 올바른 버전의 kbld가 올바르게 설치되어 있는지 확인합니다.


imgpkg 설치

imgpkg Kubernetes가 구성 및 연결된 컨테이너 이미지를 OCI 이미지로 저장하고 이러한 이미지를 전송할 수 있도록 해주는 도구입니다. imgpkg는 인터넷 제한 환경에 Tanzu Kubernetes Grid를 배포하고 자체 시스템 이미지를 구축하는 데 필요합니다. 또한 Harbor 패키지를 구성할 때도 필요합니다.

macOS

  1. imgpkg 바이너리의 압축을 풀고 실행 파일로 만듭니다.

    gunzip imgpkg-darwin-amd64-v0.31.1+vmware.1.gz

    chmod ugo+x imgpkg-darwin-amd64-v0.31.1+vmware.1

  2. 바이너리를 /usr/local/bin으로 이동하고 이름을 imgpkg로 바꿉니다.

    sudo mv ./imgpkg-darwin-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg

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

    imgpkg --version
Linux

  1. imgpkg 바이너리의 압축을 풀고 실행 파일로 만듭니다.

    gunzip imgpkg-linux-amd64-v0.31.1+vmware.1.gz

    chmod ugo+x imgpkg-linux-amd64-v0.31.1+vmware.1

  2. 바이너리를 /usr/local/bin으로 이동하고 이름을 imgpkg로 바꿉니다.

    sudo mv ./imgpkg-linux-amd64-v0.31.1+vmware.1 /usr/local/bin/imgpkg

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

    imgpkg --version
Windows

  1. imgpkg 바이너리의 압축을 풉니다.

    gunzip imgpkg-windows-amd64-v0.31.1+vmware.1.gz

  2. imgpkg-windows-amd64-v0.31.1+vmware.1의 이름을 imgpkg.exe로 바꿉니다.

  3. 새 Program Files\imgpkg 폴더를 생성하고 imgpkg.exe 파일을 복사합니다.
  4. imgpkg 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(Properties) > 보안(Security)을 선택한 후 사용자 계정에 모든 권한(Full Control) 권한이 있는지 확인합니다.
  5. Windows 검색을 사용하여 env를 검색합니다.
  6. 시스템 환경 변수 편집(Edit the system environment variables)를 선택하고 환경 변수(Environment Variables) 버튼을 클릭합니다.
  7. 시스템 변수(System variables) 아래에서 Path 행을 선택하고 편집(Edit)을 클릭합니다.
  8. 새로 만들기(New)를 클릭하여 새 행을 추가하고 imgpkg 도구에 경로를 입력합니다.
  9. 새 터미널의 명령줄에서 imgpkg version을 실행하여 올바른 버전의 imgpkg가 올바르게 설치되어 있는지 확인합니다.


후속 작업

Tanzu CLI, kubectl, 워크로드 클러스터 및 서비스 패키지를 Tanzu Kubernetes Grid에 배포하는 Carvel 도구를 사용하기 전에 아래 설명된 대로 Tanzu CLI를 Supervisor에 연결합니다.

Supervisor에 Tanzu CLI 연결

Supervisor를 Tanzu CLI에 등록한 다음 Supervisor 에 로그인하려면 다음을 수행합니다. Supervisor를 Tanzu CLI에 한 번만 등록하면 됩니다. Supervisor가 등록되면 tanzu login 단계로 건너뛸 수 있습니다.

  1. vCenter에서 Supervisor IP 주소를 가져옵니다.

    1. 호스트 및 클러스터(Hosts and Clusters) 보기에서 Supervisor를 호스팅하는 데이터 센터를 선택합니다.
    2. 네임스페이스(Namespaces)에서 3개의 SupervisorControlPlaneVM 인스턴스를 포함하고 있거나 인접한 네임스페이스를 선택합니다.
    3. 기본 창의 요약(Summary) > 상태(Status) > CLI 도구 링크(Link to CLI Tools)에서 링크 복사(Copy link)를 클릭하고 URL(예: https://192.168.123.3)을 기록합니다.

  2. IDP 없음: 외부 ID 제공자를 사용하지 않는 경우:

    1. (선택 사항) vSphere with Tanzu 클러스터의 보안 로그인 구성에 설명된 대로 신뢰할 수 있는 인증서로 kubectl vsphere 플러그인을 설치하고 구성합니다.

    2. 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를 추가하여 비보안으로 로그인할 수 있습니다.

      주의

      개발 환경에서는 비보안 로그인만 사용합니다.

    3. vCenter에 로그인하는 데 사용하는 암호를 입력합니다.

      로그인에 성공하면 kubectl vsphere login 명령을 실행합니다.

      • 로컬 kubeconfig 파일을 생성하거나 수정하여 Kubernetes API로 인증하는 토큰을 추가합니다.
      • 액세스 권한이 있는 모든 Kubernetes 컨텍스트를 나열합니다. 이 목록에는 Supervisor IP 주소가 포함되어야 합니다.

    4. kubectl 컨텍스트를 Supervisor로 설정합니다.

      kubectl config use-context SUPERVISOR-IP

      여기서 SUPERVISOR-IP는 Supervisor의 컨텍스트입니다. vSphere with Tanzu 서비스 및 워크로드에서 Supervisor 컨텍스트 가져오기 및 사용을 참조하십시오.

  3. 정보를 수집하여 Supervisor를 연결하는 tanzu login 명령을 실행합니다.

    • Supervisor용으로 사용할 tanzu CLI의 이름을 결정합니다.
    • 로컬 kubeconfig 파일의 경로로 기본값은 ~/.kube/config이며, KUBECONFIG 환경 변수로 설정됩니다.

  4. tanzu login 명령을 실행하여 위 값을 입력합니다. 예를 들면 다음과 같습니다.

    IDP 없음:

    tanzu login --name my-supervisor --kubeconfig ~/.kube/config --context 192.168.123.3

    로그인한 후 CLI는 Supervisor 전용 플러그인을 다운로드합니다.

    ???  successfully logged in to management cluster using the kubeconfig my-supervisor
Checking for required plugins...
Installing plugin 'cluster:v0.25' with target 'kubernetes'
Installing plugin 'feature:v0.25' with target 'kubernetes'
Installing plugin 'kubernetes-release:v0.25' with target 'kubernetes'
Installing plugin 'namespaces:v1.0.0' with target 'kubernetes'
Successfully installed all required plugins

    IDP 있음:

    tanzu login --endpoint https://10.73.27.32 --name 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에 연결을 참조하십시오.

  5. tanzu config server list를 실행하여 Supervisor가 추가되었는지 확인합니다. 예를 들면 다음과 같습니다.

    tanzu config server list

    NAME           TYPE               ENDPOINT                   PATH                       CONTEXT
my-supervisor  managementcluster  https://192.168.123.3:443  /home/vmware/.kube/config  192.168.123.3

    이제 tanzu login이 사용자가 입력한 이름으로 Supervisor를 표시합니다.

    tanzu login

    ? Select a server  [Use arrows to move, type to filter]
> my-supervisor  ()
 + new server

  6. tanzu plugin list를 실행하여 Supervisor별 플러그인 목록과 코어 CLI 플러그인 목록을 확인합니다.

    tanzu plugin list

    Standalone Plugins
  NAME                DESCRIPTION                                                        TARGET      DISCOVERY  VERSION   STATUS
  isolated-cluster    isolated-cluster operations                                                    default    v0.28.1   installed
  login               Login to the platform                                                          default    v0.28.1   installed
  pinniped-auth       Pinniped authentication operations (usually not directly invoked)              default    v0.28.1   installed
  management-cluster  Kubernetes management-cluster operations                           kubernetes  default    v0.28.1   installed
  package             Tanzu package management                                           kubernetes  default    v0.28.1   installed
  secret              Tanzu secret management                                            kubernetes  default    v0.28.1   installed
  telemetry           Configure cluster-wide telemetry settings                          kubernetes  default    v0.28.1   installed

Plugins from Context:  my-supervisor
  NAME                DESCRIPTION                                                TARGET      VERSION  STATUS
  cluster             Kubernetes cluster operations                              kubernetes  v0.25.0  installed
  feature             Operate on features and featuregates                       kubernetes  v0.25.0  installed
  kubernetes-release  Kubernetes release operations                              kubernetes  v0.25.0  installed
  namespaces          Discover vSphere Supervisor namespaces you have access to  kubernetes  v1.0.0   installed
    참고

    위의 예에서 Tanzu CLI를 설치할 때 설치된 독립형 플러그인(예: login 및 pinniped-auth)은 버전 v0.28.1입니다. Tanzu CLI를 Supervisor에 연결할 때 설치된 Supervisor 컨텍스트(예: cluster 또는 kubernetes-release)의 플러그인은 v0.25.0입니다. 이는 vSphere with Tanzu Supervisor의 Supervisor가 TKG 2.1이 아닌 TKG 2.0을 실행하기 때문입니다. 그러나 v0.25.0 플러그인은 Tanzu CLI 및 독립형 플러그인의 v0.28.1과 완벽하게 호환되고 지원됩니다.

  7. (선택 사항) 워크로드 클러스터 생성으로 이동합니다.
check-circle-line exclamation-circle-line close-line
Scroll to top icon