헬름차트
헬름차트는 차트 저장소에 등록된 차트를 DevOps Console에서 사용가능 하도록 등록하는 기능입니다.
헬름차트는 헬름인스톨 하기를 통해 사용할 수 있습니다. 또한 지원 헬름차트 추가하기를 통해 App. 템플릿과 연계할 수 있습니다.
헬름차트 시작하기
헬름차트 관리를 시작하려면 다음 절차를 따르세요.
- 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 관리 페이지가 열립니다.
- 왼쪽 메뉴에서 툴 & 템플릿 > 헬름차트 메뉴를 클릭하세요.
프로젝트 헬름차트 시작하기
Note
프로젝트 내부에서만 사용 가능한 헬름차트를 등록/수정/삭제 할 수 있습니다.
- 메인 페이지에서 프로젝트 카드를 클릭하세요. 프로젝트 대시보드 페이지로 이동합니다.
- 왼쪽 메뉴에서 저장소 > 헬름차트 메뉴를 클릭하세요. 헬름차트 페이지로 이동합니다.
헬름차트 추가하기
사용자는 자신만의 헬름차트를 추가할 수 있습니다.
사용자는 헬름차트 등록 전 차트 업로드하기를 통해 사용할 차트를 먼저 업로드해야 합니다.
헬름차트를 추가하려면 다음 절차를 따르세요.
- 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 관리 페이지가 열립니다.
- 왼쪽 메뉴에서 툴 & 템플릿 > 헬름차트 메뉴를 클릭하세요. 헬름차트 페이지가 열립니다.
- 헬름차트 유형 메뉴에서 헬름차트 유형을 선택하세요. 선택한 정보에 따라 등록 권한이 있는 경우에만 헬름차트 추가 버튼이 보입니다.
- 헬름차트 추가 버튼을 클릭하세요. 헬름차트 등록 페이지로 이동합니다.
- 헬름차트 기본 정보 입력 후 시작 버튼을 클릭하세요.
항목 설명 헬름차트 유형 추가할 헬름차트의 유형을 선택하세요. 테넌트/프로젝트그룹 헬릌차트를 추가할 테넌트/프로젝트그룹을 선택 - 테넌트 선택 시, 선택한 테넌트의 프로젝트에서만 등록한 차트를 사용할 수 있습니다.
- 프로젝트그룹 선택 시, 선택한 프로젝트그룹의 프로젝트에서만 등록한 차트를 사용할 수 있습니다.
신규설치 허용여부 헬름인스톨 하기를 통한 신규설치 허용여부를 선택하세요 표. 헬름차트 기본 정보 설정 항목 - 헬름차트 저장소와 헬름차트 선택 후 Validation Check 버튼을 클릭하세요.
- 나머지 정보를 입력 후 다음 버튼을 클릭하세요.
저장소 항목설명 ChartMuseum헬름 차트 저장소 차트 저장소를 ChartMuseum으로 선택하세요.차트 선택 차트 업로드하기를 통해 등록한 차트중 헬름차트로 등록할 차트를 선택하세요. Harbor OCI헬름 차트 저장소 차트 저장소를 Harbor OCI로 선택하세요.인증정보 차트 저장소의 인증정보를 넣고 Connection Test 버튼을 클릭하세요. 차트 선택 입력한 인증정보로 조회가능한 헬름차트를 선택하고 Validation Check 버튼을 클릭하세요. OCI헬름 차트 저장소 차트 저장소를 OCI로 선택하세요.인증정보 차트 저장소의 인증정보를 넣고 Connection Test 버튼을 클릭하세요. 차트 입력 인증정보에서 입력한 인증정보로 조회가능한 헬름차트를 입력하고 Validation Check 버튼을 클릭하세요.
(ex. oci://chart.url/repo/chartname:version)공통 아이콘 헬름차트를 표현할 아이콘을 선택하세요. CI/CD 정보 CI/CD 기능의 지원 여부를 선택 - App. 템플릿과의 연계 여부를 나타냅니다.
- 차트의 Values.yaml 파일에 image.repository, image.tag imagePullSecrest[0].name 키값이 존재해야 합니다.
- Support CI/CD선택 시, CI/CD 정보 단계가 추가됩니다.
차트 이미지 이미지 등록 여부를 선택 - 차트의 Values.yaml 파일에 imagePullSecrets[0].name 키값이 존재해야 합니다.
- 이미지 없음 선택 시 이미지 시크릿 정보 단계가 제외됩니다.
표. 차트 저장소 설정 항목 - 이미지 저장소 선택 및 인증정보 입력 후 Connection Test 버튼을 클릭하세요.
- 나머지 정보를 입력 후 다음 버튼을 클릭하세요.
항목 설명 이미지 저장소 정보 이미지 저장소를 선택 및 인증정보를 입력하세요. - 이미지 저장소의 관리자 권한이 필요합니다.
- 헬름차트를 사용하여 헬름인스톨을 하려는 사용자에게 이미지 저장소의 조회 권한을 부여합니다.
- 입력한 인증정보를 이용하여 이미지 저장소에 권한을 부여합니다.
사용되는 이미지 추가 선택한 이미지 저장소의 이미지 경로를 추가하세요. - 목록에서 이미지 선택: Organization, Repository, Tag를 선택하여 추가합니다.
- 사용자가 직접 입력: 이미지의 docker repository, docker tag를 직접 입력하여 추가합니다.
- 복수 개 입력 가능합니다.
등록자의 인증정보 사용 이미지 저장소에서 선택한 이미지 저장소가 권한을 부여할 수 없는 툴인 경우(ex. SCR) 선택할 수 있는 옵션입니다. - 체크를 하지 않는 경우 헬름차트 사용자가 인스톨을 수행할 때, 헬름차트 사용자에게 사용되는 이미지의 Pull 권한을 추가합니다. 권한 부여를 할수 없는 툴인 경우 권한 부여를 수행하지 않습니다.
- 체크를 하지 않는 경우 헬름차트 사용자가 인스톨을 수행할 때, 헬름차트 사용자의 권한 대신 헬름차트 등록자의 인증정보를 사용합니다.
- 헬름차트 사용자에게 등록자의 인증정보가 노출될 수 있으므로, 필요한 경우에만 사용하도록 주의를 요합니다.
- 이미지 Pull만 제공하는 이미지저장소인 경우에 선택해야 사용 중에 문제가 발생하지 않습니다. 반드시 별도의 Pull 용도로만 사용할 이미지저장소를 입력해야 합니다. (체크한 경우 하나의 이미지저장소에 대해 Pull, Push가 동시에 불가능합니다.)
- 등록자의 인증정보는 프로젝트 > 이미지저장소 > Pull 전용 이미지와 헬름릴리스의 ImagePull Secret에서 사용합니다. 해당 인증정보는 헬름차트 사용자는 변경이 불가능하며, 헬름차트에서 등록자의 인증정보를 변경한 경우 일괄적으로 변경됩니다.
도커 베이스 이미지 선택 도커 베이스 이미지로 사용될 이미지를 선택 - 이전 단계에서 Support CI/CD를 선택한 경우에만 선택하며, Docker build 시 사용할 베이스 이미지로 사용합니다.
표. 이미지 시크릿 정보 설정 항목 - 지원할 App. 템플릿 선택 후 완료 버튼을 클릭하세요.
참고
Environment Only로 표기된 App. 템플릿은 프로젝트 샘플 소스코드 없이 빌드/배포환경만 제공합니다.헬름차트 수정하기
헬름차트를 수정하려면 다음 절차를 따르세요.
- 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 관리 페이지가 열립니다.
- 왼쪽 메뉴에서 툴 & 템플릿 > 헬름차트 메뉴를 클릭하세요.
- 헬름차트 목록에서 수정하려는 헬름차트 카드를 클릭하세요. 헬름차트 상세 페이지가 열립니다.
- 오른쪽 아래의 수정 버튼을 클릭 하세요.
- 정보를 수정한 후 저장 버튼을 클릭해서 수정을 완료하세요.
헬름차트 버전 추가하기
헬름차트 버전을 추가하기 위해서는 차트 업로드하기를 통해 버전만 다른 동일한 차트가 미리 등록되어 있어야 합니다.
헬름차트의 버전을 추가하려면 다음 절차를 따르세요.
- 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 관리 페이지가 열립니다.
- 왼쪽 메뉴에서 툴 & 템플릿 > 헬름차트 메뉴를 클릭하세요.
- 헬름차트 목록에서 수정하려는 헬름차트 카드를 클릭하세요. 헬름차트 상세 페이지가 열립니다.
- 오른쪽 아래의 버전 추가 버튼을 클릭하세요. 헬름차트 버전 추가 팝업창이 열립니다.
- 정보를 입력한 후 저장 버튼을 클릭해서 버전 추가를 완료하세요.
항목 설명 차트 버전 추가할 차트 버전을 선택 - 차트 저장소에 등록된 차트 중 헬름차트로 등록되지 않은 차트의 버전이 보여집니다.
표. 헬름차트 버전 추가 설정 항목
헬름차트 삭제하기
헬름차트를 삭제하려면 다음 절차를 따르세요.
- 메인 페이지 오른쪽 위의 관리 아이콘을 클릭하세요. 관리 페이지가 열립니다.
- 왼쪽 메뉴에서 툴 & 템플릿 > 헬름차트 메뉴를 클릭하세요. 헬름차트 페이지가 열립니다.
- 헬름차트 목록에서 삭제하려는 헬름차트 카드를 클릭하세요. 헬름차트 상세 페이지가 열립니다.
- 오른쪽 아래의 삭제 버튼을 클릭하세요.
- 확인 팝업창에서 확인 버튼을 클릭해서 삭제를 완료하세요.