Linux 사용자 지정 시스템 이미지

이 절차에서는 vSphere에서 계획 기반 클러스터를 생성할 때 사용할 Linux(Ubuntu) 사용자 지정 시스템 이미지를 빌드하는 방법을 알려줍니다. 다음 섹션으로 나누어져 있습니다.

Linux 이미지 사전 요구 사항은 사용자 지정 Linux 이미지를 성공적으로 빌드하고 사용하는 데 필요한 것을 표시합니다.
OS 이미지 버전 검색은 vSphere용 기본 OVA에서 OS 이미지 버전을 검색하는 방법을 보여줍니다.
Linux 이미지 빌드는 Kubernetes Image Builder 및 Docker를 사용하여 이미지를 사용자 지정하고 빌드하는 방법을 보여 줍니다.
vSphere에 Linux 이미지 업로드에 사용자 지정 Linux 이미지를 vSphere에 업로드하는 방법이 나와 있습니다.

계획 기반(레거시) 클러스터에 대한 Linux 사용자 지정 시스템 이미지를 빌드하려면 Linux 사용자 지정 시스템 이미지(레거시)를 참조하십시오. Tanzu Kubernetes Grid의 클러스터 유형에 대한 자세한 내용은 워크로드 클러스터 유형을 참조하십시오.

Linux 이미지 사전 요구 사항

Linux 사용자 지정 시스템 이미지를 구축하려면 다음이 필요합니다.

vSphere 계정
다음이 설치된 macOS 또는 Linux 워크스테이션:
- Docker 데스크톱
- The Kubernetes CLI, kubectl
- (선택 사항) govc CLI

OS 이미지 버전 검색

이 단계에서는 사용자 지정 이미지에 사용할 Kubernetes 버전의 기본 Ubuntu OVA와 연결된 OS 이미지 버전을 검색합니다. 아래의 Linux 이미지 빌드 단계에서 사용자 지정 이미지에 이 OS 이미지 버전을 할당합니다.

OS 이미지 버전을 검색하려면 사용 사례에 따라 다음 중 하나를 수행합니다.

현재 Tanzu Kubernetes Grid 버전의 기본 Kubernetes 버전을 사용하여 생성된 관리 클러스터가 실행 중인 경우 클러스터에서 OS 이미지 버전을 검색할 수 있습니다.
1. kubectl 컨텍스트를 관리 클러스터로 설정합니다.
2. 사용 가능한 TKr 목록에서 사용자 지정 이미지에 사용할 Kubernetes 버전에 대해 Tanzu Kubernetes 릴리스(TKr)를 선택합니다. 예: v1.25.7---vmware.1-tkg.1. 사용 가능한 TKr을 나열하려면 다음을 실행합니다.
```
kubectl get tkr
```
3. TKr을 열고 osImages 속성을 찾습니다. 이 속성은 TKr과 연결된 OSImage 개체의 이름을 지정합니다.
4. 기본 Ubuntu OVA용 OSImage 개체를 찾아 엽니다. OSImage 개체의 이름이 TKr의 osImages 이름 중 하나와 일치합니다.
```
kubectl get osimages
```
5. 기본 Ubuntu OVA용 OSImage 개체에서 spec.image.ref 아래의 version 속성 값을 찾아 기록합니다. 예: v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e.
현재 Tanzu Kubernetes Grid 버전의 기본 Kubernetes 버전을 사용하여 생성된 실행 중인 관리 클러스터가 없는 경우, 로컬 또는 vSphere 기본 Ubuntu OVA에서 OS 이미지 버전을 직접 검색할 수 있습니다.
- OS 이미지 버전을 로컬로 검색하려면 다음을 수행합니다.
  1. Customer Connect에서 대상 Kubernetes 버전용 기본 Ubuntu OVA를 다운로드합니다.
    1. Tanzu Kubernetes Grid 다운로드 페이지로 이동한 후 VMware Customer Connect 자격 증명으로 로그인하고 다운로드 페이지로 이동(Go to Downloads)을 클릭합니다.
    2. OVA를 다운로드합니다. 예: Ubuntu 2004 Kubernetes v1.25.7 OVA.
  2. 선택한 압축 해제 도구를 사용하여 다운로드한 OVA의 압축을 풉니다.
  3. 압축을 푼 디렉토리에서 .ofv 파일을 찾습니다.
  4. .ofv 파일에서 OVA VERSION 속성을 검색하고 해당 값을 기록합니다. 예: v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e. 속성은 다음과 유사합니다.
```
<Property ovf:key="VERSION" ovf:type="string" ovf:userConfigurable="false" ovf:value="v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e"/>
```
- 대상 Kubernetes 버전용 기본 Ubuntu OVA를 vSphere에 이미 업로드한 경우, vSphere UI에서 OVA VM 속성을 검사하거나 govc CLI를 사용하여 OS 이미지 버전을 검색할 수도 있습니다. 이 방법을 사용하려면 OVA VM을 템플릿으로 변환하기 전에 OS 이미지 버전을 검색합니다.
  - vSphere UI에서 OS 이미지 버전을 검색하려면 다음을 수행합니다.
    1. OVA VM을 찾은 후 OVA VM 요약 페이지에서 구성(Configure) 탭을 엽니다.
    2. 설정(Settings) –> vApp 옵션(vApp Options)으로 이동합니다.
    3. 속성(Properties) 테이블에서 버전(VERSION) 키를 찾아서 기본 값(Default Value)을 기록합니다. 예: v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e.
  - govc CLI를 사용하여 OS 이미지 버전을 검색하려면 govc vm.info 명령을 실행합니다. 예:
```
govc vm.info -json /dc0/vm/ubuntu-2004-kube-v1.25.7+vmware.1-tkg.1 | jq
```
    출력에서 "Id": "VERSION"을 검색하고 "DefaultValue" 속성의 값을 기록합니다. 예:
```
{
"Key": 10,
"ClassId": "",
"InstanceId": "",
"Id": "VERSION",
"Category": "Cluster API Provider (CAPI)",
"Label": "VERSION",
"Type": "string",
"TypeReference": "",
"UserConfigurable": false,
"DefaultValue": "v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e",
"Value": "",
"Description": ""
}
```

Linux 이미지 빌드

Linux 이미지를 빌드하는 방법:

vSphere의 계획 기반 클러스터용 Linux 이미지 빌드 단계를 완료합니다. 단, 다음과 같은 예외가 있습니다. metadata.json에서 사용자 지정 이미지의 버전 문자열을 설정할 때 Linux 이미지 빌드 섹션에서 권장하는 대로 v1.25.7+vmware.1-myorg.0 대신 위의 OS 이미지 버전 검색에서 검색한 값으로 설정합니다. 예:
```
{
 "VERSION": "v1.25.7+vmware.1-tkg.1-765d418b72c247c2310384e640ee075e"
}
```
Linux 이미지 빌드 섹션의 단계를 완료한 후 이 페이지로 돌아가서 아래의 Linux 이미지를 vSphere에 업로드로 진행합니다.

Linux 이미지를 vSphere에 업로드

Linux 이미지 빌드 섹션의 단계를 완료한 후 다음을 수행합니다.

대상 Kubernetes 버전용 기본 Ubuntu OVA를 vSphere에 업로드한 경우 사용자 지정 OVA를 업로드하기 전에 기본 OVA를 삭제합니다.
사용자 지정 OVA를 vSphere에 업로드합니다. 지침은 vSphere에 관리 클러스터 배포 준비의 기본 이미지 템플릿을 vSphere로 가져오기를 참조하십시오.

후속 작업

이제 사용자 지정 이미지를 사용하여 관리 및 워크로드 클러스터를 배포할 수 있습니다. 자세한 내용은 다음을 참조하십시오.