패키지 설치 및 관리

이 주제에서는 Tanzu CLI를 사용하여 패키지 및 패키지 저장소를 설치하고 관리하는 방법을 설명합니다.

참고
tanzu package CLI 플러그인은 CLI 관리 패키지에만 사용됩니다. 이 항목에 제공된 명령을 사용하여 자동 관리 패키지를 설치하고 관리하지 마십시오. 수명 주기는 Tanzu Kubernetes Grid에서 자동으로 관리됩니다. 자동 관리 패키지에 대한 자세한 내용은 자동 관리 패키지를 참조하십시오.

CLI 관리 패키지 설치 준비

standard 패키지 저장소에서 CLI 관리 패키지를 설치하기 전에 다음을 수행합니다.

Tanzu CLI를 설치합니다.
tanzu-standard 패키지 저장소를 추가합니다. 계획 기반 클러스터(레거시)를 대상으로 하는 경우 이 단계를 건너뜁니다. 계획 기반 클러스터의 경우 tanzu-standard 패키지 저장소가 모든 클러스터의 tanzu-package-repo-global 네임스페이스에서 자동으로 사용되도록 설정되었습니다.
Tanzu 표준 저장소 컨텐츠를 살펴봅니다.
워크로드 클러스터에 인증서 관리를 위한 cert-manager를 설치합니다.

설치 개요

Tanzu CLI를 사용하여 패키지를 설치하고 관리하는 방법에 대한 지침은 아래 섹션을 참조하십시오.

패키지 저장소: 다음을 수행하려면 이 섹션을 참조하십시오.
- 대상 클러스터에 사용 가능하거나 추가된 모든 패키지 저장소 나열
- 사용 가능하거나 추가된 패키지 저장소의 세부 정보 가져오기
- 패키지 저장소 추가, 업데이트 또는 삭제
패키지: 다음을 수행하려면 이 섹션을 참조하십시오.
- 대상 클러스터에서 사용 가능하거나 설치된 모든 패키지 나열
- 사용 가능하거나 설치된 패키지의 세부 정보 가져오기
- 패키지 설치, 업데이트 또는 삭제

tanzu package 명령에 대한 자세한 내용은 tanzu 패키지를 참조하십시오.

패키지 네임스페이스 및 시스템 네임스페이스

패키지 저장소 및 패키지를 원하는 네임스페이스에 설치합니다. --namespace 옵션을 설정하지 않으면 Tanzu CLI는 default 네임스페이스를 대상으로 합니다.

패키징된 서비스의 구성 요소는 패키지가 배포된 위치와는 별개인 시스템 네임스페이스에서 실행됩니다. 예를 들어, Contour와 Envoy 구성 요소는 네임스페이스 tanzu-system-ingress에서 실행되고, Harbor 구성 요소는 tanzu-system-registry에서 실행됩니다.

tanzu-system- 네임스페이스에 패키지를 설치하지 마십시오.

패키지 저장소

아래 섹션에서는 패키지 저장소를 나열, 추가, 업데이트, 삭제하는 방법을 설명합니다.

패키지 저장소 나열

tanzu package repository list 명령은 대상 클러스터에서 사용할 수 있는 모든 패키지 저장소를 나열합니다. 이 목록에는 tanzu package repository add 명령을 실행하여 대상 클러스터에 추가된 패키지 저장소가 포함됩니다. 클러스터에 패키지 저장소를 추가하려면 아래의 패키지 저장소 추가를 참조하십시오.

대상 클러스터의 모든 네임스페이스에 패키지 저장소를 나열하려면 다음을 실행합니다.
```
tanzu package repository list -A
```
특정 네임스페이스의 패키지 저장소를 나열하려면 다음을 실행합니다.
```
tanzu package repository list -n NAMESPACE
```
여기서 NAMESPACE는 대상 네임스페이스입니다. default 이외의 네임스페이스에 패키지 저장소를 나열하려면 --namespace 또는 -n 옵션이 필요합니다.

default 네임스페이스에 패키지 저장소를 나열하려면 다음을 실행할 수도 있습니다.
```
tanzu package repository list
```

패키지 저장소의 세부 정보 가져오기

tanzu package repository get 명령은 패키지 저장소의 세부 정보를 검색합니다.

패키지 저장소의 세부 정보를 검색하려면 다음을 실행합니다.

tanzu package repository get REPOSITORY-NAME -n REPOSITORY-NAMESPACE

형식 설명:

REPOSITORY-NAME는 대상 클러스터에 있는 패키지 저장소의 이름입니다.
REPOSITORY-NAMESPACE는 대상 클러스터에 있는 패키지 저장소의 네임스페이스입니다.

패키지 저장소 추가

tanzu package repository add 명령은 패키지 저장소를 추가합니다.

대상 클러스터에 패키지 저장소를 추가하려면 다음을 실행합니다.

tanzu package repository add REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE

형식 설명:

REPOSITORY-NAME은 패키지 저장소에 대해 선택하는 이름입니다.
REPOSITORY-URL은 패키지 저장소의 OCI 레지스트리 URL입니다.
- Tanzu CLI에서 이 값을 가져오려면 패키지 저장소 나열을 참조하거나 Tanzu Mission Control의 클러스터(Cluster) 창에서 추가 기능(Addons) > 저장소(Repositories) 목록을 참조하십시오.
- URL 끝에 패키지 저장소 태그를 생략하면 시스템은 최신 Tanzu Kubernetes Grid 릴리스의 태그를 사용합니다.
- 이 URL은 projects.registry.vmware.com/tce 아래에 있을 수 없습니다.
REPOSITORY-NAMESPACE는 패키지 저장소의 대상 네임스페이스입니다. 이 옵션을 지정하지 않으면 Tanzu CLI는 패키지 저장소를 default 네임스페이스에 추가합니다.

예를 들어 Tanzu Kubernetes Grid에 포함된 CLI 관리 패키지가 포함된 standard 패키지 저장소를 추가하려면 다음 명령을 실행합니다. --namespace 패키지 저장소의 대상 standard는 tkg-system입니다.

참고
계획 기반 클러스터(레거시)를 대상으로 하는 경우 이 단계를 건너뜁니다. 계획 기반 클러스터의 경우 tanzu-standard 패키지 저장소가 모든 클러스터의 tanzu-package-repo-global 네임스페이스에서 자동으로 사용되도록 설정되었습니다.

tanzu package repository add tanzu-standard --url projects.registry.vmware.com/tkg/packages/standard/repo:v2.1.1 --namespace tkg-system

패키지 저장소 업데이트

tanzu package repository update 명령은 URL에 게시된 새 버전으로 패키지 저장소를 업데이트합니다.

대상 클러스터에서 패키지 저장소를 업데이트하려면 다음을 실행합니다.

tanzu package repository update REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE

형식 설명:

REPOSITORY-NAME은 클러스터에 있는 패키지 저장소의 이름입니다.
REPOSITORY-URL은 패키지 저장소의 새 URL입니다. URL에 패키지 저장소 태그를 지정하지 않으면 시스템은 최신 Tanzu Kubernetes Grid 릴리스의 패키지 저장소 태그를 사용합니다.
REPOSITORY-NAMESPACE는 클러스터에 있는 패키지 저장소의 네임스페이스입니다.

패키지 저장소 삭제

tanzu package repository delete 명령은 패키지 저장소를 제거합니다. 대상 클러스터에서 패키지 저장소를 삭제하려면 다음을 실행합니다.

tanzu package repository delete REPOSITORY-NAME -n REPOSITORY-NAMESPACE

형식 설명:

REPOSITORY-NAME은 패키지 저장소의 이름입니다.
REPOSITORY-NAMESPACE는 패키지 저장소의 네임스페이스입니다.

패키지

아래 섹션에서는 패키지를 나열, 설치, 업데이트, 삭제하는 방법을 설명합니다.

사용 가능한 패키지 나열

tanzu package available list 명령은 사용 가능한 모든 패키지와 패키지 버전을 나열합니다.

사용 가능한 패키지 나열:

대상 클러스터의 모든 네임스페이스에서 사용 가능한 패키지를 나열하려면 다음을 실행합니다.
```
tanzu package available list -A
```
특정 네임스페이스에서 사용 가능한 패키지를 나열하려면 다음을 실행합니다.
```
tanzu package available list -n NAMESPACE
```
여기서 NAMESPACE는 사용 가능한 패키지 목록을 검색하려는 네임스페이스입니다. default 네임스페이스에서 사용 가능한 패키지를 나열하려면 다음을 실행할 수도 있습니다.
```
tanzu package available list
```

사용 가능한 패키지 버전을 나열합니다.

대상 클러스터의 모든 네임스페이스에서 패키지에 사용 가능한 패키지 버전을 나열하려면 다음을 실행합니다.
```
tanzu package available list AVAILABLE-PACKAGE-NAME -A
```
여기서 AVAILABLE-PACKAGE-NAME은 tanzu package available list 명령을 실행하여 검색한 패키지 이름입니다.
특정 네임스페이스에서 패키지에 대해 사용 가능한 패키지 버전을 나열하려면 다음을 실행합니다.
```
tanzu package available list AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE
```
형식 설명:
- AVAILABLE-PACKAGE-NAME은 tanzu package available list 명령을 실행하여 검색한 패키지 이름입니다.
- AVAILABLE-PACKAGE-NAMESPACE는 사용 가능한 패키지의 네임스페이스입니다.
default 네임스페이스에서 패키지에 사용 가능한 패키지 버전을 나열하기 위해 다음을 실행할 수도 있습니다.
```
tanzu package available list AVAILABLE-PACKAGE-NAME
```

사용 가능한 패키지의 세부 정보 가져오기

tanzu package available get 명령은 사용 가능한 패키지의 세부 정보를 검색합니다.

사용 가능한 패키지의 세부 정보를 검색하려면 다음을 실행합니다.

tanzu package available get AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE

또는:

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE

형식 설명:

AVAILABLE-PACKAGE-NAME은 사용 가능한 패키지의 이름입니다. tanzu package available list 명령을 실행하여 이 이름을 검색할 수 있습니다.
AVAILABLE-PACKAGE-VERSION은 사용 가능한 패키지의 버전입니다. tanzu package available list AVAILABLE-PACKAGE-NAME 명령을 실행하여 사용 가능한 패키지 버전 목록을 검색할 수 있습니다.
AVAILABLE-PACKAGE-NAMESPACE는 사용 가능한 패키지의 네임스페이스입니다.

사용 가능한 패키지의 기본 구성 파일을 검색하려면 tanzu package available get 명령의 --default-values-file-output 플래그를 사용합니다.

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --default-values-file-output FILE-PATH

각 키의 기본값 등 사용 가능한 패키지의 값 스키마를 검색하려면 tanzu package available get 명령의 --values-schema 플래그를 사용합니다. 그러면 사용 가능한 패키지의 Package Kubernetes API 리소스에서 valuesSchema 섹션이 검색됩니다. 값 스키마의 출력 형식인 -o를 yaml, json 또는 table로 설정할 수 있습니다.

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --values-schema

설치된 패키지 나열

tanzu package installed list 명령은 대상 클러스터에 현재 설치되어 있는 모든 패키지를 나열합니다.

클러스터의 모든 네임스페이스에 설치된 패키지를 나열하려면 다음을 실행합니다.

tanzu package installed list -A

특정 네임스페이스에 설치된 패키지를 나열하려면 다음을 실행합니다.

tanzu package installed list -n NAMESPACE

여기서 NAMESPACE는 설치된 패키지 목록을 검색할 네임스페이스입니다.

설치된 패키지의 세부 정보 가져오기

설치된 tanzu package installed get 명령은 설치된 패키지의 세부 정보를 검색합니다.

설치된 패키지의 세부 정보를 검색하려면 다음을 실행합니다.

tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE

형식 설명:

INSTALLED-PACKAGE-NAME은 설치된 패키지의 이름입니다.
INSTALLED-PACKAGE-NAMESPACE는 패키지가 설치된 네임스페이스입니다.

설치된 패키지의 현재 구성을 파일에 저장하려면 다음을 실행합니다.

tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE --values-file-output FILE-PATH

여기서 FILE-PATH는 파일의 경로입니다. 예: values.yaml.

패키지 설치

tanzu package install 명령은 CLI 관리 패키지를 설치합니다.

대상 클러스터에 CLI 관리 패키지를 설치하려면 다음을 수행합니다.

아직 추가하지 않았다면 패키지가 포함된 패키지 저장소를 추가합니다. 자세한 내용은 위의 패키지 저장소 추가를 참조하십시오.
설치하려는 패키지의 이름과 버전을 기록합니다. 패키지 이름과 버전을 보려면 tanzu package available list 명령을 실행합니다. 자세한 내용은 사용 가능한 패키지 목록을 참조하십시오.
패키지를 설치합니다.
```
tanzu package install PACKAGE-NAME -p AVAILABLE-PACKAGE-NAME -v AVAILABLE-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n TARGET-NAMESPACE
```
형식 설명:
- PACKAGE-NAME은 패키지에 선택하는 이름입니다.
- AVAILABLE-PACKAGE-NAME은 위에서 적은 패키지 이름입니다.
- AVAILABLE-PACKAGE-VERSION은 위에서 적은 패키지 버전입니다.
- PACKAGE-CONFIGURATION-FILE은 패키지에 대해 준비한 구성 파일입니다. 이 옵션을 지정하지 않으면 패키지가 기본 구성으로 설치됩니다.
- TARGET-NAMESPACE는 패키지(PackageInstall), 패키지 애플리케이션(App), 패키지를 설명하는 기타 Kubernetes 리소스를 설치할 네임스페이스입니다. 예: my-packages 또는 tanzu-cli-managed-packages 네임스페이스.
  - -n 플래그를 지정하지 않으면 Tanzu CLI는 default 네임스페이스를 사용합니다. 포드 및 서비스와 같은 패키지 콘텐츠를 이 네임스페이스에 설치하지 마십시오. 패키지 콘텐츠의 네임스페이스는 패키지 구성에서 별도로 설정됩니다.
  - 지정된 네임스페이스가 이미 존재해야 합니다(예: kubectl create namespace my-packages 실행).
이 명령을 지원하는 플래그의 전체 목록을 보려면 --help 옵션을 사용합니다.
패키지가 설치되었는지 확인하려면 tanzu package installed list 명령을 실행합니다. 위의 설치된 패키지 나열을 참조하십시오.

패키지 업데이트

tanzu package installed update 명령은 CLI 관리 패키지의 버전과 구성을 업데이트합니다.

CLI 관리 패키지의 버전을 업데이트하기 전에 일반적으로 패키지 저장소 업데이트에 설명된 대로 해당 저장소를 업데이트합니다.

CLI 관리 패키지의 버전과 구성을 모두 업데이트하려면 다음을 실행합니다.

tanzu package installed update INSTALLED-PACKAGE-NAME -v TARGET-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n INSTALLED-PACKAGE-NAMESPACE

형식 설명:

INSTALLED-PACKAGE-NAME은 패키지에 대해 선택한 이름입니다. 패키지의 이름을 보려면 tanzu package installed list 명령을 실행할 수 있습니다. 자세한 내용은 설치된 패키지 나열을 참조하십시오.
(선택 사항) TARGET-PACKAGE-VERSION은 패키지를 업데이트하려는 버전입니다. 버전이 아닌 패키지 구성을 업데이트하는 경우에는 필요하지 않습니다.
(선택 사항) PACKAGE-CONFIGURATION-FILE은 업데이트된 패키지 구성이 포함된 .yaml 파일의 경로입니다. 구성이 아닌 패키지 버전을 업데이트하는 경우에는 필요하지 않습니다. 현재 구성을 검색하려면 설치된 패키지의 세부 정보 가져오기를 참조하십시오.
INSTALLED-PACKAGE-NAMESPACE는 패키지가 설치된 네임스페이스입니다.

참고
TKG v2.1.0에서 v2.1.1로 업그레이드된 워크로드 클러스터의 경우 cert-manager, external-dns, grafana 구성을 구성을 업데이트하려면 일부 패키지에 대한 업그레이드가 필요합니다의 알려진 문제에 설명된 대로 패키지 버전을 업그레이드해야 할 수도 있습니다.

패키지 삭제

tanzu package installed delete 명령은 CLI 관리 패키지를 삭제합니다.

대상 클러스터에서 CLI 관리 패키지를 삭제하려면 다음을 실행합니다.

tanzu package installed delete INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE

형식 설명:

INSTALLED-PACKAGE-NAME은 삭제하려는 패키지의 이름입니다. 패키지의 이름을 보려면 tanzu package installed list 명령을 실행할 수 있습니다. 자세한 내용은 설치된 패키지 나열을 참조하십시오.
INSTALLED-PACKAGE-NAMESPACE는 패키지가 설치된 네임스페이스입니다. 네임스페이스를 지정하지 않으면 default 네임스페이스가 사용됩니다.

패키지에 오버레이 적용

CLI 관리 패키지를 사용자 지정하려면 ytt 오버레이를 적용할 수 있습니다.