VMware Cloud Director Container Service Extension 4.0 릴리스 정보

VMware Cloud Director Container Service Extension 4.0 \| 2022년 11월 17일 \| 빌드: 20803846 이러한 릴리스 정보의 추가 사항 및 업데이트 사항을 확인하십시오.

VMware Cloud Director Container Service Extension 4.0 | 2022년 11월 17일 | 빌드: 20803846

이러한 릴리스 정보의 추가 사항 및 업데이트 사항을 확인하십시오.

2022년 11월의 새로운 기능

이제 VMware Cloud Director의 Kubernetes Container Clusters UI 플러그인에서 Kubernetes 클러스터 생성, 업그레이드, 크기 조정 및 삭제와 같은 클러스터 수명 주기 관리 작업을 수행할 수 있습니다.
CSE 관리 탭: Kubernetes Container Clusters UI 플러그인의 새 서비스 제공자 개인 설정 워크플로입니다. 이 워크플로는 UI 플러그인에 설정된 VMware Cloud Director Container Service Extension을 통해 서비스 제공자를 안내하며 테넌트 사용자가 Kubernetes 클러스터를 생성할 수 있도록 환경을 준비합니다.
Kubernetes 제어부의 고가용성을 허용하는 Tanzu Kubernetes Grid 클러스터를 위한 다중 노드 제어부 UI입니다.
메모리 또는 CPU 사용량이 많은 컨테이너를 수용할 수 있는 클러스터를 구축하기 위한 사용자 지정 크기의 노드가 포함된 이기종 클러스터입니다.
생성 시 Tanzu Kubernetes Grid 클러스터에 Tanzu 코어 패키지를 미리 설치하여 컨테이너화된 애플리케이션의 추가 구성을 줄입니다.
AI/ML 애플리케이션을 허용하는 Tanzu Kubernetes Grid 클러스터에 대한 GPU 지원
VMware Cloud Director Container Service Extension UI는 다음과 같은 언어로 현지화되어 있습니다. 독일어(de_DE), 프랑스어(fr_FR), 이탈리아어(it_IT), 스페인어(es_ES), 포르투갈어(브라질)(pt_BR), 일본어(ja_JP), 한국어(ko_KR), 중국어 간체(zh_CN), 중국어 번체(zh_TW).
VMware Cloud Director Container Service Extension은 장치로 패키징되고 Photon OS 3.0을 사용합니다.
VMware Cloud Director Container Service Extension은 클러스터 생성, 업그레이드, 크기 조정 및 삭제와 같은 클러스터 관리 작업의 고가용성을 허용하는 HA 배포를 지원합니다.
VMware Data Solutions 확장을 사용한 VMware RabbitMQ 배포를 지원합니다. 자세한 내용은 VMware Data Solutions용 VMware Cloud Director 확장을 참조하십시오.
추가적인 네트워크 보안을 관리하거나 무중단 업무 운영을 위해 제어부에 대한 특정 LB VIP 및 서브넷을 선택을 선택할 수 있습니다.
CAPVCD(Cluster API for VMware Cloud Director) 1.0.0은 VMware Cloud Director Container Service Extension 4.0과 함께 릴리스되었습니다. CAPVCD 1.0.0을 Kubernetes 클러스터 수명 주기에 독립적으로 사용할 수 있습니다. 자세한 내용은 https://github.com/vmware/cluster-api-provider-cloud-director를 참조하십시오.

알려진 문제

Kubernetes Container Clusters UI 플러그인에서 클러스터가 [오류] 상태인 경우 삭제 작업이 실패할 수 있음

[오류] 상태인 클러스터를 삭제하려면 클러스터에 대해 강제 삭제를 수행해야 합니다.
1. VMware Cloud Director에 로그인하고 위쪽 탐색 모음에서 더 보기 > Kubernetes 컨테이터 클러스터를 선택합니다.
2. 클러스터를 선택하고 클러스터 정보 페이지에서 삭제를 클릭합니다.
3. 클러스터 삭제 페이지에서 강제 삭제 확인란을 선택하고 삭제를 클릭합니다.
VMware Cloud Director Container Service Extension에서 스크립트 실행 오류로 인해 Tanzu Kubernetes Grid 클러스터 생성이 실패할 수 있음

Kubernetes Container Clusters UI의 클러스터 정보 페이지에 있는 이벤트 탭에

ScriptExecutionTimeout 오류가 나타나고 다음과 같은 세부 정보를 표시합니다.

error while bootstrapping the machine [cluster-name/EPHEMERAL_TEMP_VM]; timeout for post customization phase [phase name of script execution]
해결 방법:

이 오류가 발생하면 클러스터 설정에서 오류 시 자동 복구를 활성화하는 것이 좋습니다. 이렇게 하면 클러스터 생성을 재시도하도록 VMware Cloud Director Container Service Extension에 지시합니다.
1. VMware Cloud Director에 로그인하고 위쪽 탐색 모음에서 더 보기 > Kubernetes 컨테이터 클러스터를 선택합니다.
2. 클러스터를 선택하고 클러스터 정보 페이지에서 설정을 클릭한 후 오류 시 자동 복구 토글을 활성화합니다.
3. 저장을 클릭합니다.
참고:
클러스터 생성 문제를 해결할 때에는 오류 시 자동 복구 토글을 비활성화하는 것이 좋습니다.
다중 제어부 또는 다중 작업자 노드에 대한 클러스터 생성이 오류 상태가 됩니다. 클러스터 세부 정보 페이지의 [이벤트] 탭에는 VMware Cloud Director에서의 ephemeralVM 삭제 실패로 인해 EphemeralVMError 이벤트가 표시됩니다.

클러스터에서 오류 시 자동 복구 설정이 활성화된 경우 동일한 오류 이벤트가 반복적으로 나타날 수 있습니다. 오류 시 자동 복구 설정이 꺼져 있으면 제어부 및 작업자 노드가 성공적으로 생성되더라도 VMware Cloud Director에서 ephemeralVM을 삭제하지 못해 클러스터가 오류 상태를 표시할 수 있습니다.

이 문제는 VMware Cloud Director 10.3.3.3 이후의 모든 릴리스 및 패치 릴리스(VMware Cloud Director 10.3.3.3은 포함되지 않음) 그리고 VMware Cloud Director 10.4.1 이후의 모든 릴리스 및 패치 릴리스에서 발생합니다.

해결 방법:

제어부 하나와 작업자 노드 하나를 사용하여 클러스터를 생성한 다음 클러스터의 크기를 원하는 노드 수로 조정합니다.

이 문제는 VMware Cloud Director Container Service Extension 4.0.3 릴리스에서 해결되었습니다.
일부 경우에 노드가 클러스터에 가입할 수 없습니다. 이 문제는 클러스터가 사용 가능한 상태인 경우에도 간헐적인 문제로 인해 임의로 발생합니다.

Kubernetes Container Clusters UI의 클러스터 정보 페이지에 있는 이벤트 탭에

VcdMachineScriptExecutionError 오류가 나타나고 다음과 같은 세부 정보를 표시합니다.

script failed with status [x] and reason [Date Time 1 /root/node.sh: exit [x]]
해결 방법:

가입에 실패한 노드가 있는 클러스터에 대해 이 해결 방법을 수행합니다. 이 해결 방법은 향후 클러스터 생성에 대한 문제를 해결하지 못합니다.

문제가 발생하면 이 수동 해결 방법을 수행해야 합니다. 가입에 실패한 노드가 하나 이상 있을 수 있으며 가입되지 않은 모든 노드에 대해 2단계부터 아래 단계를 수행해야 합니다.
1. 일부 노드가 없는 클러스터의 Kube 구성을 다운로드합니다.
  1. VMware Cloud Director에 로그인하고 위쪽 탐색 모음에서 더 보기 > Kubernetes 컨테이터 클러스터를 선택합니다.
  2. 클러스터를 선택하고 클러스터 정보 페이지에서 Kube 구성 다운로드를 클릭합니다.
    
    Kube 구성 파일에 대한 자세한 내용은 Kubernetes 웹 사이트를 참조하십시오.
2. Kubernetes Container Clusters UI 플러그인의 클러스터 정보 페이지에 있는 이벤트 탭에서 VcdMachineScriptExecutionError를 클릭하여 오류 세부 정보를 보고 리소스 이름을 기록해 둡니다.
3. kubectl에서 다음 명령을 입력하여 클러스터의 모든 시스템을 가져옵니다.
```
kubectl get machines -A --kubeconfig=<path of downloaded kubeconfig>
```
  클러스터에 가입할 수 없는 노드는 프로비저닝 상태에서 멈춰야 합니다. 이 노드를 식별하려면 VcdMachineScriptExecutionError에 있는 리소스 이름을 사용하여 시스템 이름을 찾습니다.
4. kubectl에서 다음 명령을 입력합니다.
```
Run `kubectl --kubeconfig=<path of downloaded kubeconfig> delete machine -n clusterNamespace machineName
```
  참고:
  삭제되는 시스템 이름이 VcdMachineScriptExecutionError에 있는 리소스 이름과 일치하는지 확인합니다.
  
  VM이 삭제되면 VM이 다시 생성되고 노드가 클러스터 가입을 재시도합니다.
ERROR: failed to create cluster: failed to pull image 장애
이 오류는 다음과 같은 경우에 발생합니다.
- 사용자가 VMware Cloud Director Container Service Extension 4.0을 사용하여 Tanzu Kubernetes Grid 클러스터를 생성하려고 할 때 간헐적으로 실패합니다.
- HTTP 408 응답으로 인한 이미지 끌어오기 오류가 보고됩니다.
이 문제는 필요한 이미지를 끌어오기 위해 EPHEMERAL_TEMP_VM에서 인터넷에 연결하는 데 어려움이 있을 때 발생할 수 있습니다.

잠재적 원인:
- 인터넷 연결이 느리거나 간헐적입니다.
- 네트워크 IP 풀에서 DNS를 확인할 수 없습니다(Docker Pull 오류).
- 방화벽 뒤에 있는 네트워크 MTU를 더 낮게 설정해야 합니다.
이 문제를 해결하려면 EPHEMERAL_TEMP_VM이 인터넷에 연결하는 것을 막는 네트워킹 연결 문제가 없는지 확인합니다.
조직에 대한 레거시 권한 번들이 있는 경우 Kubernetes Container Clusters UI 플러그인에서 클러스터 작업을 실행할 때 권한 부여 오류가 발생할 수 있습니다.
- VMware Cloud Director를 버전 9.1 이하에서 업그레이드하면 시스템에서 각 조직에 대한 레거시 권한 번들이 생성될 수 있습니다. 이 레거시 권한 번들에는 업그레이드 시 연결되었던 조직에서 사용할 수 있는 권한이 포함되며, 해당 조직에만 게시됩니다. 기존 조직에 대한 권한 번들 모델을 사용하기 시작하려면 해당하는 레거시 권한 번들을 삭제해야 합니다. 자세한 내용은 권한 및 역할 관리를 참조하십시오.
- 서비스 제공자 포털의 관리 탭에서 개인 권한 번들을 삭제할 수 있습니다. 자세한 내용은 권한 번들 삭제를 참조하십시오. Kubernetes Container Clusters UI 플러그인 CSE 관리에는 Kubernetes 클러스터 권한 번들을 자동으로 생성하고 모든 테넌트에 게시하는 서버 설정 프로세스가 있습니다. 권한 번들에는 VMware Cloud Director Container Service Extension 4.0의 Kubernetes 클러스터 관리에 관련된 모든 권한이 포함되어 있습니다.
kubectl을 사용하여 Tanzu Kubernetes Grid 클러스터의 크기를 조정하거나 업그레이드합니다.

Kubernetes Container Clusters UI 플러그인에서 클러스터를 생성한 후 kubectl을 사용하여 Tanzu Kubernetes Grid 클러스터의 워크로드를 관리할 수 있습니다.
또한 Kubernetes Container Clusters UI 플러그인 대신 kubectl을 통해 클러스터의 수명 주기 관리, 크기 조정 및 업그레이드를 수행하려면 다음 단계를 완료합니다.
1. 클러스터에서 RDE 프로젝터 연산자 삭제 kubectl delete deployment -n rdeprojector-system rdeprojector-controller-manager
2. Kubernetes Container Clusters UI 플러그인에서 Tanzu Kubernetes Grid 클러스터를 분리합니다.
  1. VMware Cloud Director UI의 클러스터 개요 페이지에서 클러스터의 클러스터 ID를 검색합니다.
  2. entity.spec.vcdKe.isVCDKECluster가 포함된 RDE를 false로 업데이트합니다.
    
    클러스터의 페이로드 가져오기 - GET https://<vcd>/cloudapi/1.0.0/entities/<Cluster ID>
    
    페이로드에서 json 경로를 복사하고 업데이트합니다. - entity.spec.vcdKe.isVCDKECluster를 false로 설정합니다.
    
    PUT https://<vcd>/cloudapi/1.0.0/entities/<Cluster ID>(수정된 페이로드로). 전체 페이로드를 PUT 작업의 본문으로 포함해야 합니다.
  3. 이때 클러스터는 VMware Cloud Director Container Service Extension 4.0.0 및 4.0.1에서 분리되며 VMware Cloud Director Container Service Extension 4.0.0 및 4.0.1을 통해 클러스터를 관리할 수 없습니다. 이제 kubectl을 사용하여 클러스터 API 규격인 CAPI yaml을 직접 적용하여 클러스터를 관리, 크기 조정 또는 업그레이드할 수 있습니다.
다음 오류가 있는 잘못된 GitHub 토큰으로 인해 VMware Cloud Director Container Service Extension에서 클러스터 생성이 실패함 401 잘못된 자격 증명
이는 클러스터를 생성하는 동안 예상되는 오류입니다. 고객이 잘못된 Github 액세스 토큰을 설정하면 클러스터 생성이 실패하고 다음 오류가 나타납니다.
```
error creating the GitHub repository client: failed to get GitHub latest version: failed to get repository 
versions: failed to get repository versions: failed to get the list of releases: GET 
https://api.github.com/repos/kubernetes-sigs/cluster-api/releases: 401 Bad credentials
```
VMware Cloud Director Container Service Extension 서버를 구성할 때 정확한 Github 액세스 토큰을 입력하십시오.
정책 수정을 위해 선택한 후 VMware Cloud Director Container Service Extension 4 플러그인의 정책 선택이 전체 목록을 채우지 않음

사용자가 Kubernetes Container Clusters 플러그인에서 크기 조정 정책을 선택하고 이를 변경하려는 경우 드롭다운 메뉴에는 선택한 크기 조정 정책만 표시되고 대체 크기 조정 정책은 자동으로 로드되지 않습니다.

대체 크기 조정 정책이 표시되도록 하려면 사용자가 텍스트를 수동으로 삭제해야 합니다. 사용자가 배치 정책 및 스토리지 정책을 선택할 때도 드롭다운 메뉴에서 이런 상황이 발생합니다.

의도적인 상황입니다. 이것은 콤보 상자 html, Clarity 웹 구성 요소가 작동하는 방식입니다.

참고:Clarity는 VMware Cloud Director UI가 구축되는 웹 프레임워크입니다.

드롭다운 상자는 입력 텍스트를 필터로 사용합니다. 입력 필드에 아무것도 없으면 모든 선택 항목을 볼 수 있으며 입력 시 선택 필터를 볼 수 있습니다.
VMware Cloud Director Container Service Extension 클러스터를 생성할 때 문자 대문자 표시 오류가 나타남
Kubernetes Container Clusters UI에서 대문자를 사용하면 다음 오류가 나타납니다.
- 이름은 문자로 시작하고 영숫자로 끝나야 하며 영숫자 또는 하이픈(-) 문자만 포함해야 합니다. (최대 63자)
Kubernetes에서 설정된 제한 사항입니다. 개체 이름은 RFC 1035 레이블에 따라 유효성이 검사됩니다. 자세한 내용은 Kubernetes 웹 사이트를 참조하십시오.
Kubernetes Container Clusters UI 플러그인 4.0은 다른 Kubernetes Container Clusters UI 플러그인(예: 3.5.0)과 상호 운용되지 않음

충돌 없이 두 플러그인을 동시에 작동하는 기능은 알려진 VMware Cloud Director UI 제한 사항입니다. 한 번에 하나의 플러그인만 활성화할 수 있습니다.
vSphere 또는 다른 기본 인프라의 장애로 인해 클러스터의 노드가 삭제된 경우 VMware Cloud Director Container Service Extension은 이를 사용자에게 알리지 않으며 클러스터를 자동으로 복구하지 않음

클러스터의 노드가 삭제되면 클러스터 크기 조정 및 클러스터 업그레이드와 같은 기본 클러스터 작업이 계속 작동합니다. 삭제된 노드는 삭제된 상태로 유지되며 클러스터의 크기 계산에 포함됩니다.
1. 클러스터의 Kubeconfig를 다운로드합니다.
2. 다음 명령을 사용하여 삭제된 노드 구성을 계속 사용하는 시스템을 삭제합니다.
```
kubectl --kubeconfig=<path to downloaded kubeconfig> get machines -A # try to match the machine name 
here; also get namespace 
kubectl -n <namespace name from above> --kubeconfig=<path to downloaded kubeconfig> delete machine 
<machine name> 
# wait for machine to get deleted
```
위 명령은 시스템을 삭제하고 CAPVCD는 자동으로 새 시스템을 생성합니다.
VMware Cloud Director Container Service Extension은 수정할 수 없는 배치 정책이 설정된 TKG 템플릿을 사용하여 클러스터를 배포하지 못함
1. VMware Cloud Director 테넌트 포털에 관리자로 로그인합니다.
2. 라이브러리 > vApp 템플릿을 클릭합니다.
3. vApp 템플릿 창에서 템플릿 왼쪽에 있는 라디오 버튼을 선택합니다.
4. 상단 리본에서 계산 정책으로 태그 지정을 클릭합니다.
5. 수정 가능 확인란을 선택하고 태그를 클릭합니다.
VMware Cloud Director 10.4에서는 서비스 제공자가 기본적으로 VMware Cloud Director Container Service Extension 가상 시스템에 로그인할 수 없음
VMware Cloud Director 10.4에서는 OVA 파일에서 VMware Cloud Director Container Service Extension 가상 시스템을 배포한 후 VM 설정 페이지의 다음 두 확인란이 기본적으로 선택되지 않습니다.
- 로컬 관리자 암호 허용
- 암호 자동 생성
제공자가 나중에 문제 해결 작업을 수행하기 위해 VMware Cloud Director Container Service Extension 가상 시스템에 로그인할 수 있도록 하려면 이 확인란을 선택해야 합니다.
1. VMware Cloud Director UI에 서비스 제공자로 로그인하고 VMware Cloud Director Container Service Extension OVA 파일에서 vApp을 생성합니다. 자세한 내용은 VMware Cloud Director Container Service Extension 서버 OVA 파일에서 vApp 생성을 참조하십시오.
2. vApp을 배포한 후 전원을 켜기 전에 VM 세부 정보 > 게스트 OS 사용자 지정으로 이동하여 로컬 관리자 암호 허용 및 암호 자동 생성을 선택합니다.
3. vApp 업데이트 작업이 완료되면 vApp의 전원을 켭니다.
디스크 크기를 조정하려면 조직 VDC에서 빠른 프로비저닝을 비활성화해야 함
1. VMware Cloud Director UI에 제공자로 로그인하고 리소스를 선택합니다.
2. 클라우드 리소스 탭에서 조직 VDC를 선택하고 조직 VDC를 선택합니다.
3. 조직 VDC 창의 정책 아래에서 스토리지를 선택합니다.
4. 편집을 클릭하고 빠른 프로비저닝 토글을 비활성화합니다.
5. 저장을 클릭합니다.
서비스 제공자로 로그인할 때 최신 UI 플러그인을 업로드한 후 CSE 관리 탭이 표시되지 않음
VMware Cloud Director에 내장된 이전 UI 플러그인을 비활성화합니다.
1. VMware Cloud Director UI에 제공자로 로그인하고 더 보기 > Customize Portal을 선택합니다.
2. 대상 플러그인의 이름 옆에 있는 확인란을 선택하고 사용 또는 사용 안 함을 클릭합니다.
3. 새로 활성화된 플러그인 사용을 시작하려면 인터넷 브라우저 페이지를 새로 고칩니다.
참고:
이름이나 ID는 같지만 버전이 다른 활성화된 플러그인이 여러 개 있는 경우 가장 낮은 버전의 플러그인이 사용됩니다. 따라서 가장 높은 버전의 플러그인만 활성화하고 다른 모든 버전 플러그인은 비활성화하십시오.

플러그인 관리에 대한 자세한 내용은 플러그인 관리를 참조하십시오.