---
title: "일반적인 관례"
description: "차트에 대한 일반적인 관례"
weight: 1
---

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

## 차트 이름

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

예시:

```
drupal
nginx-lego
aws-cluster-autoscaler
```

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

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

## 버전 번호

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

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

## YAML 형식

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

## 헬름과 차트 단어의 사용

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

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

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