.helmignore 파일

.helmignore 파일 (The .helmignore file)

이 문서는 헬름 차트에 포함하고 싶지 않은 파일을 지정하는 .helmignore 파일에 대해 설명해요. 패턴 매칭 규칙과 사용 방법을 다뤄요.

출처: 문서

본문

.helmignore 파일은 헬름 차트에 포함하고 싶지 않은 파일을 지정하는 데 사용해요.

.helmignore 파일은 Chart.yaml 파일과 나란히 차트의 루트 디렉터리에 배치해야 해요. 현재 작업 디렉터리나 다른 위치에서는 읽지 않아요.

이 파일이 존재하면 Helm은 차트를 로드할 때 패턴과 일치하는 모든 경로를 무시해요. 이것은 helm packagehelm install, helm upgrade, helm template처럼 디렉터리에서 직접 차트를 렌더링하거나 설치하는 명령에도 적용돼요.

.helmignore를 사용해 불필요하거나 민감한 파일을 패키징된 차트(및 차트 디렉터리에서의 로컬 설치/업그레이드 실행)에서 제외하세요.

.helmignore 파일은 Unix 셸 glob 매칭, 상대 경로 매칭, 부정(negation, ! 접두사)을 지원해요. 줄당 하나의 패턴만 고려돼요.

다음은 .helmignore 파일의 예시예요:

# comment

# .helmignore라는 이름의 파일이나 경로를 매칭
.helmignore

# .git이라는 이름의 파일이나 경로를 매칭
.git

# 모든 텍스트 파일을 매칭
*.txt

# mydir이라는 디렉터리만 매칭
mydir/

# 최상위 디렉터리의 텍스트 파일만 매칭
/*.txt

# 최상위 디렉터리의 foo.txt 파일만 매칭
/foo.txt

# ab.txt, ac.txt, ad.txt라는 파일을 매칭
a[b-d].txt

# subdir 하위의 draft/draft*와 일치하는 모든 파일을 매칭

# 두 단계 깊이의 draft 파일 매칭 (예: foo/bar/draft123)
*/*/draft*
draft?

.gitignore와의 몇 가지 주목할 만한 차이점:

  • ** 구문은 지원되지 않아요.

  • globbing 라이브러리는 Go의 'filepath.Match'이며, fnmatch(3)이 아니에요.

  • 끝의 공백은 항상 무시돼요 (지원되는 이스케이프 시퀀스가 없어요).

  • 특별한 선행 시퀀스로 '!'는 지원되지 않아요.

  • 기본적으로 자신을 제외하지 않으므로 .helmignore에 대한 명시적 항목을 추가해야 해요.

이 문서를 더 좋게 만드는 데 도움을 주시면 감사해요. 정보를 추가, 수정, 삭제하려면 이슈를 제기하거나 pull request를 보내주세요.

더 알아보기 (Learn more)