Tanzu Kubernetes Grid 업그레이드

TKG(Tanzu Kubernetes Grid)를 업그레이드하려면 부트스트랩 시스템으로 사용하는 시스템에 새 버전의 Tanzu CLI를 다운로드하고 설치합니다. 또한 이전에 배포한 클러스터를 vSphere, AWS(Amazon Web 서비스) 또는 Azure로 업그레이드하는지에 따라 기본 이미지 템플릿 및 VM도 다운로드하고 설치해야 합니다.

참고

TKG 업그레이드 경로에서 v2.3은 v2.2를 즉시 따릅니다.

새 버전의 구성 요소를 설치한 후에는 tanzu mc upgrade 및 tanzu cluster upgrade CLI 명령을 사용하여 관리 클러스터 및 워크로드 클러스터를 업그레이드합니다.

다음 섹션은 Tanzu Kubernetes Grid를 업그레이드하는 데 필요한 전체 단계입니다. 이 절차에서는 Tanzu Kubernetes Grid v2.3.1로 업그레이드한다고 가정합니다.

일부 단계는 Tanzu Kubernetes Grid를 v2.2.x에서 v2.3.x로 부분 업그레이드하는 경우에만 필요하며, Tanzu Kubernetes Grid를 v2.3.x에서 v2.3.y로 패치 업그레이드하는 경우에는 필요하지 않습니다.

중요

Tanzu Kubernetes Grid v2.4.x는 AWS 및 Azure에서 기존 독립형 TKG 관리 클러스터 및 TKG 워크로드 클러스터 업그레이드를 지원하는 TKG의 마지막 버전입니다. 독립형 TKG 관리 클러스터 및 AWS 및 Azure의 TKG 워크로드 클러스터를 업그레이드하는 기능이 Tanzu Kubernetes Grid v2.5 릴리스에서 제거됩니다.

지금부터는 VMware Tanzu Mission Control을 사용하여 네이티브 AWS EKS 및 Azure AKS 클러스터를 생성하는 것이 좋습니다. 그러나 기존 독립형 TKG 관리 클러스터 및 AWS 및 Azure의 TKG 워크로드 클러스터 업그레이드는 TKG v2.4.x를 포함하여 모든 TKG 릴리스에 대해 완전히 지원됩니다.

자세한 내용은 VMware Tanzu Kubernetes Grid v2.4 Release Notes에서 AWS 및 Azure에서 TKG 관리 및 워크로드 클러스터의 사용 중단을 참조하십시오.

사전 요구 사항

TKG v2.3.x로 업그레이드하기 전에 현재 배포가 TKG v2.2.x 또는 이전 v2.3 버전인지 확인합니다. v2.2 이전 버전에서 v2.3.x로 업그레이드하려면 먼저 Tanzu CLI의 v2.2.x를 사용하여 v2.2.x로 업그레이드해야 합니다.

Tanzu CLI의 새 버전 다운로드 및 설치

이 단계는 주요 v2.2.x에서 v2.3.x로의 업그레이드와 v2.3.x에서 v2.3.y로의 업그레이드에 모두 필요합니다.

새 버전의 Tanzu CLI를 다운로드하고 설치하려면 다음 단계를 수행합니다.

1. ~/.config/tanzu/tkg/compatibility/tkg-compatibility.yaml 파일을 삭제합니다.

   이 파일을 삭제하지 않으면 새 버전의 Tanzu CLI는 이전 릴리스의 BOM(Bill of Materials)을 계속 사용합니다. 이 파일을 삭제하면 Tanzu CLI가 업데이트된 BOM을 가져옵니다. 2.2.x에서 2.3.x로 업그레이드할 때와 2.3.x에서 2.3.y로 업그레이드할 때 이 단계를 수행해야 합니다.

2. 독립형 관리 클러스터에서 사용할 Tanzu CLI 및 Kubernetes CLI 설치 지침에 따라 현재 tanzu 명령을 실행하는 시스템에 Tanzu CLI 및 kubectl를 다운로드하고 설치합니다. 독립형 관리 클러스터가 LDAP ID 제공자를 사용하도록 구성된 경우, Tanzu CLI를 설치한 후 그리고 CLI 플러그인을 Tanzu Kubernetes Grid v2.3으로 업데이트하기 전에 (LDAP만 해당) LDAP 설정 업데이트의 단계를 수행합니다.

3. 새 버전의 Tanzu CLI를 설치한 후 tanzu version을 실행하여 올바른 버전의 Tanzu CLI가 제대로 설치되었는지 확인합니다. Tanzu Kubernetes Grid v2.3과 호환되는 CLI 버전 목록은 제품 상호 운용성 매트릭스를 참조하십시오.
4. kubectl을 설치한 후 kubectl version을 실행하여 올바른 버전의 kubectl이 적절하게 설치되어 있는지 확인합니다.

사용할 수 있는 Tanzu CLI 명령 및 옵션에 대한 자세한 내용은 Tanzu CLI 명령 참조를 참조하십시오.

클러스터 업그레이드 준비

관리 및 워크로드 클러스터를 업그레이드하려면 먼저 vSphere, AWS 또는 Azure에 클러스터를 배포했는지에 따라 준비 단계를 수행해야 합니다. 이 단계는 주요 v2.2.x에서 v2.3.x로의 업그레이드와 v2.3.x에서 v2.3.y로의 업그레이드에 모두 필요합니다.

vSphere

vSphere에서 Tanzu Kubernetes Grid 배포를 업그레이드하려면 먼저 업그레이드된 관리 및 워크로드 클러스터가 실행할 기본 이미지 템플릿의 vSphere 새 버전으로 가져와야 합니다. VMware는 지원되는 각 OS 및 Kubernetes 버전의 기본 이미지 템플릿을 OVA 형식으로 게시합니다. OVA를 가져온 후에는 결과 VM을 VM 템플릿으로 변환해야 합니다.

이 절차에서는 Tanzu Kubernetes Grid v2.3.x로 업그레이드한다고 가정합니다.

1. VMware Customer Connect로 이동한 후 VMware Customer Connect 자격 증명을 사용하여 로그인합니다.
2. Tanzu Kubernetes Grid v2.3.1 제품 다운로드로 이동하세요.

3. 관리 및 워크로드 클러스터가 실행 중인 OS 및 Kubernetes 버전 라인의 최신 Tanzu Kubernetes Grid OVA를 다운로드합니다.

   예를 들어 Photon v3 이미지의 경우:

   • Kubernetes v1.26.8: Photon v3 Kubernetes v1.26.8 OVA
   • Kubernetes v1.25.13: Photon v3 Kubernetes v1.25.13 OVA
   • Kubernetes v1.24.17: Photon v3 Kubernetes v1.24.17 OVA

   Ubuntu 20.04 이미지:

   • Kubernetes v1.26.8: Ubuntu 2004 Kubernetes v1.26.8 OVA
   • Kubernetes v1.25.13: Ubuntu 2004 Kubernetes v1.25.13 OVA
   • Kubernetes v1.24.17: Ubuntu 2004 Kubernetes v1.24.17 OVA

   중요

   보안 패치 릴리스가 있는 경우 가장 최근의 OVA 기본 이미지 템플릿을 다운로드해야 합니다. Tanzu Kubernetes Grid 제품 다운로드 페이지에서 보안 패치가 포함된 업데이트된 기본 이미지 템플릿을 찾을 수 있습니다.

4. vSphere Client vCenter Server 인벤토리에서 개체를 마우스 오른쪽 버튼으로 클릭하고 OVF 템플릿 배포(Deploy OVF template)를 선택합니다.
5. 로컬 파일(Local file)을 선택하고 버튼을 클릭하여 파일을 업로드한 후 로컬 시스템에서 다운로드한 OVA 파일로 이동합니다.

6. 설치 관리자 프롬프트에 따라 OVA에서 VM을 배포합니다.

   • 장치 이름을 수락하거나 수정합니다.
   • 대상 데이터 센터 또는 폴더를 선택합니다.
   • 대상 호스트, 클러스터 또는 리소스 풀을 선택합니다.
   • EULA(최종 사용자 라이센스 계약)를 수락합니다.
   • 디스크 형식 및 대상 데이터스토어를 선택합니다.
   • VM을 연결할 네트워크를 선택합니다.
7. 마침을 클릭하여 VM을 배포합니다.
8. OVA 배포가 완료되면 VM을 마우스 오른쪽 버튼으로 클릭하고 템플릿(Template) > 템플릿으로 변환(Convert to Template)을 선택합니다.
9. VM 및 템플릿(VMs and Templates) 보기에서 새 템플릿을 마우스 오른쪽 버튼으로 클릭하고 사용 권한 추가(Add Permission)를 선택한 다음 Tanzu Kubernetes Grid 사용자(예: tkg-user)를 Tanzu Kubernetes Grid 역할이 있는 템플릿(예: TKG)에 할당합니다. vSphere에 관리 클러스터 배포 준비에서 이 사용자와 역할을 생성했습니다.

OVA 파일을 다운로드한 각 Kubernetes 버전에 이 절차를 반복합니다.

VMware Cloud on AWS SDDC 호환성

VMware Cloud on AWS에 배포된 워크로드 클러스터를 업그레이드하는 경우 기존 배포에서 사용하는 기본 SDDC(소프트웨어 정의 데이터 센터) 버전이 업그레이드하려는 Tanzu Kubernetes Grid 버전과 호환되는지 확인합니다.

SDDC의 버전을 보려면 VMware Cloud 콘솔의 SDDC 타일에서 세부 정보 보기(View Details)를 선택하고 지원(Support) 창을 클릭합니다.

Tanzu Kubernetes Grid와의 호환성을 검증하려면 VMware 제품 상호 운용성 매트릭스를 참조하십시오.

AWS

새 버전의 Tanzu CLI 및 기타 도구를 설치한 후 관리 클러스터를 업그레이드하기 전에 tanzu mc permissions aws set 명령을 실행하여 AWS 계정의 사용 권한을 재설정해야 합니다.

tanzu mc permissions aws set

이 단계는 주요 v2.2.x에서 v2.3.x로의 업그레이드와 패치 v2.3.x에서 v2.3.y로의 업그레이드에 모두 필요합니다. 명령이 설정하는 AWS 사용 권한에 대한 자세한 내용은 필요한 AWS 사용 권한을 참조하십시오.

지원되는 Kubernetes 버전을 포함하는 Amazon Linux 2 Amazon AMI(시스템 이미지)는 지원되는 모든 AWS 지역에서 모든 AWS 사용자가 공개적으로 사용할 수 있습니다. Tanzu Kubernetes Grid는 업그레이드할 때 지정한 Kubernetes 버전에 적합한 AMI를 자동으로 사용합니다.

Azure

Azure에서 Tanzu Kubernetes Grid 배포를 업그레이드하기 전에 새 기본 VM 이미지 및 클러스터 VM에 사용하려는 기본이 아닌 각 VM 이미지의 약관에 동의해야 합니다. 구독당 한 번씩 이러한 약관에 동의해야 합니다.

약간에 동의하려면 다음을 수행합니다.

1. Azure Marketplace에서 Tanzu Kubernetes Grid에 사용할 수 있는 모든 VM 이미지를 나열합니다.

   az vm image list --publisher vmware-inc --offer tkg-capi --all
   

2. 새 기본 VM 이미지의 약관에 동의합니다.

   az vm image terms accept --urn publisher:offer:sku:version
   

   예를 들어 Tanzu Kubernetes Grid v2.3.1, k8s-1dot26dot8-ubuntu-2004의 기본 VM 이미지 약관에 동의하려면 다음을 실행합니다.

   az vm image terms accept --urn vmware-inc:tkg-capi:k8s-1dot26dot8-ubuntu-2004:2021.05.17
   

3. 워크로드 클러스터를 기본이 아닌 Kubernetes 버전(예: v1.25.13 또는 v1.24.17)으로 업그레이드하려는 경우 클러스터 VM에 사용하려는 기본이 아닌 각 버전에 대한 약관에 동의합니다.

독립형 관리 클러스터 업그레이드

이 단계는 독립형 관리 클러스터가 있는 TKG에만 필요합니다. vSphere with Tanzu Supervisor와 함께 TKG를 실행하는 경우 vSphere의 일부로 Supervisor를 업그레이드하고 해당 TKr을 업그레이드하여 Supervisor의 Kubernetes 버전을 업데이트합니다.

이 단계는 주요 v2.2.x에서 v2.3.x로의 업그레이드와 v2.3.x에서 v2.3.y로의 업그레이드에 모두 필요합니다.

Tanzu Kubernetes Grid를 업그레이드하려면 배포의 모든 관리 클러스터를 업그레이드해야 합니다. 워크로드 클러스터를 관리하는 관리 클러스터를 업그레이드할 때까지 워크로드 클러스터를 업그레이드할 수 없습니다.

독립형 관리 클러스터 업그레이드의 절차에 따라 관리 클러스터를 업그레이드합니다.

워크로드 클러스터 업그레이드

이 단계는 주요 v2.2.x에서 v2.3.x로의 업그레이드와 v2.3.x에서 v2.3.y로의 업그레이드에 모두 필요합니다.

워크로드 클러스터 업그레이드의 절차에 따라 워크로드를 실행하는 워크로드 클러스터를 업그레이드합니다.

사후 업그레이드 작업

클러스터를 업그레이드한 후에는 업그레이드 프로세스를 완료하기 위해 수행해야 하는 추가 단계가 있습니다.

n-2보다 오래된 패키지 버전 동기화

관리 클러스터에 기본적으로 설치되는 일부 패키지(예: cert-manager)는 워크로드 및 공유 서비스 클러스터에 CLI 관리 패키지로 설치할 수 있습니다. 관리 클러스터가 최신 Tanzu Kubernetes Grid 릴리스로 업그레이드되면 기본 패키지가 자동으로 업데이트됩니다.

서로 다른 워크로드 클러스터에서 서로 다른 버전의 CLI 관리 패키지를 실행할 수 있습니다. 워크로드 클러스터에서 지원되는 최신 버전의 CLI 관리 패키지 또는 이전에 설치된 Tanzu Kubernetes Grid의 마지막 두 버전에 있는 패키지 버전을 실행할 수 있습니다. 예를 들면 다음과 같습니다. 최신 패키징된 cert-manager 버전이 v1.11.1이고 이전 두 Tanzu Kubernetes Grid 설치가 워크로드 클러스터에서 cert-manager v1.10.1 및 v1.7.2로 실행된 경우 워크로드 클러스터에서 cert-manager 버전 v1.11.1, v1.10.1, v1.7.2를 실행할 수 있습니다.

관리 클러스터의 패키지 버전보다 오래된 n-2 설치 Tanzu Kubernetes Grid 버전인 패키지 버전을 실행하는 워크로드 클러스터의 경우, 패키지 저장소를 업데이트한 다음(패키지 저장소 업데이트 참조) 워크로드 클러스터에서 패키지를 업그레이드해야 합니다(패키지 업데이트 참조). 패키지 버전을 업그레이드하지 않으면 패키지 저장소에 n-2 이전 버전의 패키지가 포함되지 않을 수 있기 때문에 패키지 구성을 업데이트할 수 없습니다.

중요

워크로드 클러스터에 Prometheus를 설치하고 워크로드 클러스터를 Kubernetes v1.25로 업그레이드하는 경우 Prometheus를 적어도 버전 2.37.0+vmware.3-tkg.1로 업그레이드해야 합니다. 이전 버전의 Prometheus 패키지(예: 버전 2.37.0+vmware.1-tkg.1)는 Kubernetes 1.25와 호환되지 않습니다.

제공자별 사후 업그레이드 작업

클러스터가 vSphere, AWS 또는 Azure에서 실행 중인지 여부에 따라 클러스터를 업그레이드한 후 수행해야 하는 작업이 있습니다.

vSphere

Tanzu Kubernetes Grid 업그레이드 후 NSX Advanced Load Balancer 구성 업그레이드

TKG v2.2 설치에서 NSX ALB를 사용하도록 설정하지 않은 경우 NSX ALB를 설치하는 방법에 대한 자세한 내용은 NSX Advanced Load Balancer 설치 및 구성을 참조하십시오.

TKG v2.2 설치에서 NSX ALB를 사용하도록 설정한 경우 이 릴리스에서 Avi 컨트롤러 버전이 지원되는 Tanzu Kubernetes Grid v2.3 릴리스 정보를 참조하고, 필요한 경우 Avi 컨트롤러를 호환되는 버전으로 업그레이드하십시오. Avi 컨트롤러를 업그레이드하는 방법은 Avi Vantage의 유연한 업그레이드를 참조하십시오.

AWS

Tanzu Kubernetes Grid 업그레이드 후 AWS EBS CSI 드라이버 설치

TKG v2.2 이상에서는 새로 생성된 워크로드 클러스터에 AWS EBS CSI 드라이버를 자동으로 설치하지만 v2.1에서 업그레이드된 클러스터에서 AWS EBS CSI를 실행하려면 드라이버를 수동으로 설치해야 합니다. 다음 절차에 따라 TKG v2.1 또는 이전 버전에서 생성되었으며 AWS EBS CSI 드라이버가 설치되지 않은 클러스터에 AWS EBS CSI 드라이버를 수동으로 설치합니다.

1. AWS EBS CSI 드라이버의 사용 권한을 부여합니다.

   export AWS_REGION={YOUR_AWS_REGION}
   tanzu mc permissions aws set
   

2. CSI 스토리지를 사용하는 각 워크로드 클러스터에 다음을 수행합니다.

   1. 다음 환경 변수를 내보내고 기능 플래그를 설정합니다.

      export _TKG_CLUSTER_FORCE_ROLE="management"
      export FILTER_BY_ADDON_TYPE="csi/aws-ebs-csi-driver"
      export NAMESPACE="tkg-system"
      export DRY_RUN_MODE="legacy"
      tanzu config set features.cluster.allow-legacy-cluster true
      

      위의 예에서 NAMESPACE를 클러스터의 네임스페이스인 tkg-system으로 설정합니다.

   2. CSI 드라이버 매니페스트를 생성합니다.

      tanzu cl create ${TARGET_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      여기서 TARGET_CLUSTER_NAME은 CSI 드라이버를 설치하는 클러스터의 이름입니다.

   3. 워크로드 클러스터의 네임스페이스로 csi-driver-addon-manifest.yaml의 메타데이터에 있는 암호의 네임스페이스를 업데이트합니다. kubectl get cluster -A 명령을 사용하여 클러스터의 네임스페이스를 확인합니다.

   4. 관리 클러스터의 컨텍스트에 변경 내용을 적용합니다.

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   5. 다음 환경 변수 및 기능 플래그를 설정 해제합니다.

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

3. CSI 스토리지를 사용하는 관리 클러스터의 경우:

   1. 다음 환경 변수를 내보냅니다.

      export _TKG_CLUSTER_FORCE_ROLE="management"
      export FILTER_BY_ADDON_TYPE="csi/aws-ebs-csi-driver"
      export NAMESPACE="tkg-system"
      export DRY_RUN_MODE="legacy"
      tanzu config set features.cluster.allow-legacy-cluster true
      

      위의 예에서 NAMESPACE를 클러스터의 네임스페이스인 tkg-system으로 설정합니다.

   2. CSI 드라이버 매니페스트를 생성합니다.

      tanzu mc create ${MANAGEMENT_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      여기서 MANAGEMENT_CLUSTER_NAME은 관리 클러스터의 이름입니다.

   3. 관리 클러스터의 네임스페이스로 csi-driver-addon-manifest.yaml의 메타데이터에 있는 암호의 네임스페이스를 업데이트합니다. kubectl get cluster -A 명령을 사용하여 클러스터의 네임스페이스를 확인합니다.

   4. 관리 클러스터의 컨텍스트에 변경 내용을 적용합니다.

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   5. 다음 환경 변수 및 기능 플래그를 설정 해제합니다.

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

Azure

Tanzu Kubernetes Grid 업그레이드 후 Azure 디스크 CSI 드라이버 설치

TKG v2.1 이상에서는 새로 생성된 워크로드 클러스터에 Azure 디스크 CSI 드라이버를 자동으로 설치하지만 v1.6에서 업그레이드된 클러스터에서 Azure 디스크 CSI를 실행하려면 드라이버를 수동으로 설치해야 합니다. 다음 절차에 따라 TKG v1.6 이하에서 생성되었으며 Azure 디스크 CSI 드라이버가 설치되지 않은 클러스터에 Azure 디스크 CSI 드라이버를 수동으로 설치합니다.

1. 다음 환경 변수를 내보내고 기능 플래그를 설정합니다.

   export _TKG_CLUSTER_FORCE_ROLE="management"
   export FILTER_BY_ADDON_TYPE="csi/azuredisk-csi-driver"
   export NAMESPACE="tkg-system"
   export DRY_RUN_MODE="legacy"
   tanzu config set features.cluster.allow-legacy-cluster true
   

   위의 예에서 NAMESPACE를 클러스터의 네임스페이스인 tkg-system으로 설정합니다.

2. CSI 스토리지를 사용하는 각 워크로드 클러스터에 다음을 수행합니다.

   1. CSI 드라이버 매니페스트를 생성합니다.

      tanzu cl create ${TARGET_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      여기서 TARGET_CLUSTER_NAME은 CSI 드라이버를 설치하는 클러스터의 이름입니다.

   2. 워크로드 클러스터의 네임스페이스로 csi-driver-addon-manifest.yaml의 메타데이터에 있는 암호의 네임스페이스를 업데이트합니다. kubectl get cluster -A 명령을 사용하여 클러스터의 네임스페이스를 확인합니다.

   3. 관리 클러스터의 컨텍스트에 변경 내용을 적용합니다.

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   4. 다음 환경 변수 및 기능 플래그를 설정 해제합니다.

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

3. CSI 스토리지를 사용하는 관리 클러스터의 경우:

   1. 다음 환경 변수를 내보냅니다.

      export _TKG_CLUSTER_FORCE_ROLE="management"
      export FILTER_BY_ADDON_TYPE="csi/azuredisk-csi-driver"
      export NAMESPACE="tkg-system"
      export DRY_RUN_MODE="legacy"
      tanzu config set features.cluster.allow-legacy-cluster true
      

      위의 예에서 NAMESPACE를 클러스터의 네임스페이스인 tkg-system으로 설정합니다.

   2. CSI 드라이버 매니페스트를 생성합니다.

      tanzu mc create ${MANAGEMENT_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      여기서 MANAGEMENT_CLUSTER_NAME은 관리 클러스터의 이름입니다.

   3. 관리 클러스터의 네임스페이스로 csi-driver-addon-manifest.yaml의 메타데이터에 있는 암호의 네임스페이스를 업데이트합니다. kubectl get cluster -A 명령을 사용하여 클러스터의 네임스페이스를 확인합니다.

   4. 관리 클러스터의 컨텍스트에 변경 내용을 적용합니다.

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   5. 다음 환경 변수 및 기능 플래그를 설정 해제합니다.

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

Tanzu Kubernetes Grid 업그레이드 후 Azure 파일 CSI 드라이버 설치

이전에 클러스터를 설치하지 않은 경우 Tanzu Kubernetes Grid 설치를 v2.3 이상으로 업그레이드한 후 다음 절차에 따라 파일 CSI 드라이버를 설치합니다.

1. 다음 환경 변수를 내보내고 기능 플래그를 설정합니다.

   export _TKG_CLUSTER_FORCE_ROLE="management"
   export FILTER_BY_ADDON_TYPE="csi/azurefile-csi-driver"
   export NAMESPACE="tkg-system"
   export DRY_RUN_MODE="legacy"
   tanzu config set features.cluster.allow-legacy-cluster true
   

   위의 예에서 NAMESPACE를 클러스터의 네임스페이스인 tkg-system으로 설정합니다.

2. CSI 스토리지를 사용하는 각 워크로드 클러스터에 다음을 수행합니다.

   1. CSI 드라이버 매니페스트를 생성합니다.

      tanzu cl create ${TARGET_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      여기서 TARGET_CLUSTER_NAME은 CSI 드라이버를 설치하는 클러스터의 이름입니다.

   2. 워크로드 클러스터의 네임스페이스로 csi-driver-addon-manifest.yaml의 메타데이터에 있는 암호의 네임스페이스를 업데이트합니다. kubectl get cluster -A 명령을 사용하여 클러스터의 네임스페이스를 확인합니다.

   3. 관리 클러스터의 컨텍스트에 변경 내용을 적용합니다.

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   4. 다음 환경 변수 및 기능 플래그를 설정 해제합니다.

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

3. CSI 스토리지를 사용하는 관리 클러스터의 경우:

   1. 다음 환경 변수를 내보냅니다.

      export _TKG_CLUSTER_FORCE_ROLE="management"
      export FILTER_BY_ADDON_TYPE="csi/azurefile-csi-driver"
      export NAMESPACE="tkg-system"
      export DRY_RUN_MODE="legacy"
      tanzu config set features.cluster.allow-legacy-cluster true
      

      위의 예에서 NAMESPACE를 클러스터의 네임스페이스인 tkg-system으로 설정합니다.

   2. CSI 드라이버 매니페스트를 생성합니다.

      tanzu mc create ${MANAGEMENT_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      여기서 MANAGEMENT_CLUSTER_NAME은 관리 클러스터의 이름입니다.

   3. 관리 클러스터의 네임스페이스로 csi-driver-addon-manifest.yaml의 메타데이터에 있는 암호의 네임스페이스를 업데이트합니다. kubectl get cluster -A 명령을 사용하여 클러스터의 네임스페이스를 확인합니다.

   4. 관리 클러스터의 컨텍스트에 변경 내용을 적용합니다.

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   5. 다음 환경 변수 및 기능 플래그를 설정 해제합니다.

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

충돌 복구 및 진단 업그레이드

이 단계는 주요 v2.2.x에서 v2.3.x로의 업그레이드와 v2.3.x에서 v2.3.y로의 업그레이드에 모두 필요합니다.

충돌 복구 및 진단을 업그레이드하는 방법에 대한 자세한 내용은 충돌 복구 및 진단 바이너리 설치 또는 업그레이드를 참조하십시오.

후속 작업

업그레이드된 관리 클러스터를 검토하거나 Tanzu Mission Control에 등록합니다. 새로 배포된 독립형 관리 클러스터 검사 및 등록을 참조하십시오.