일반적인 관례

이 부분은 모범사례 가이드의 일부로서 일반적인 관례를 설명한다.

차트 이름

차트 이름은 소문자와 숫자여야 한다. 단어는 대시(-)로 구분할 수 있다.

예시:

drupal
nginx-lego
aws-cluster-autoscaler

대문자나 밑줄문자는 차트 이름에 사용할 수 없다. 점도 사용할 수 없다.

차트를 담은 디렉토리는 차트와 이름이 같아야 한다. 따라서 nginx-lego 차트는 nginx-lego/라는 디렉토리 안에 생성되어야 한다. 이것은 단지 스타일 세부사항이 아니라 헬름 차트 형식의 요건이다.

버전 번호

가능하다면 어디서든, 헬름은 버전 번호를 표현할 때 SemVer 2를 사용한다. (도커 이미지 태그는 SemVer를 따를 필요가 없고 아쉽지만 규칙에서 예외로 취급된다는 점을 알아두자.)

SemVer 버전을 쿠버네티스 레이블로 저장할 때, 관례적으로 + 문자를 _ 문자로 변경하는데, + 기호는 레이블 값으로 허용되지 않기 때문이다.

YAML 형식

YAML 파일은 2칸 (탭이 아니다) 들여쓰기해야 한다.

헬름과 차트 단어의 사용

Helmhelm 단어 사용에 관한 관례는 다음과 같다.

  • Helm(헬름)은 전체 프로젝트를 가리킨다.
  • helm은 클라이언트측 명령어를 가리킨다.
  • chart는 첫글자를 대문자로 쓸 필요가 없는데, 고유명사가 아니기 때문이다.
  • 반면, Chart.yaml는 첫글자를 대문자로 써야 하는데, 파일명에는 대소문자 구분이 있기 때문이다.

애매할 때는 Helm(대문자 'H', 헬름)을 쓰자.