0Pricing
Helm Academy · 강의

재사용 가능한 이름 지정 템플릿 내보내기

다른 차트에서 포함할 수 있는 부분 템플릿을 공개합니다.

재사용 가능한 이름 지정 템플릿 내보내기은(는) CoddyKit의 무료 Helm Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Helm Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Helm Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

명명된 템플릿이 핵심입니다

라이브러리 차트는 명명된 템플릿을 핵심으로 제공합니다. 다른 _helpers.tpl 파일에서와 마찬가지로 define을 사용해 작성합니다.

{{- define "common.fullname" -}}
{{ .Release.Name }}-{{ .Chart.Name }}
{{- end -}}

템플릿 이름에 네임스페이스 지정하기

템플릿 이름은 차트와 해당 종속 항목 전체에서 전역으로 사용됩니다. 충돌을 피하려면 common.labels처럼 라이브러리 이름을 접두사로 붙이십시오.

{{- define "common.labels" -}}
app.kubernetes.io/managed-by: {{ .Release.Service }}
{{- end -}}

templates에 넣기

라이브러리 템플릿은 차트의 templates 디렉터리에 있으며, Helm이 매니페스트로 렌더링하지 않도록 이름 앞에 밑줄을 붙인 파일에 작성합니다.

common/
  templates/
    _labels.tpl
    _names.tpl

define만으로는 출력되지 않습니다

단독으로 작성한 define 블록은 차트가 렌더링될 때 아무것도 생성하지 않습니다. 다른 차트가 나중에 포함할 때만 템플릿이 텍스트를 출력합니다.

전체 리소스 내보내기

전체 Kubernetes 객체를 하나의 이름 있는 템플릿으로 정의할 수 있습니다. 그러면 사용하는 차트는 include를 한 번 호출하여 완전한 Service를 렌더링할 수 있습니다.

{{- define "common.service" -}}
apiVersion: v1
kind: Service
metadata:
  name: {{ .Release.Name }}
{{- end -}}

호출자의 컨텍스트 받기

부분 템플릿 안에서 점(.)은 호출자가 전달한 값입니다. .Values와 .Release를 읽으면 템플릿이 각 차트를 사용하는 환경에 맞게 동작할 수 있습니다.

{{- define "common.image" -}}
{{ .Values.image.repository }}:{{ .Values.image.tag }}
{{- end -}}

필요한 범위 문서화하기

부분 템플릿은 입력을 신뢰하므로 필요한 컨텍스트를 설명하는 주석을 남기십시오. 잘못된 점(.)을 전달하면 사용자에게 혼란스러운 오류가 발생합니다.

{{/* common.fullname expects the root context (.) */}}

템플릿 하나당 한 가지 관심사 유지하기

로직을 작고 집중된 부분 템플릿으로 나누십시오. 하나는 이름, 하나는 레이블, 하나는 선택자를 담당하게 하면 여러 차트에서 작은 구성 요소를 깔끔하게 조합할 수 있습니다.

공백 표식이 중요합니다

define과 end를 {{- 및 -}}와 같은 대시 표식으로 감싸면 라이브러리 출력이 사용하는 차트의 YAML에 불필요한 빈 줄을 삽입하지 않습니다.

{{- define "common.name" -}}
{{ .Chart.Name }}
{{- end -}}

include할 때까지 아무것도 내보내지지 않습니다

템플릿을 정의하면 사용 가능해질 뿐 활성화되지는 않습니다. application 차트가 include 또는 template으로 호출할 때만 출력에 포함됩니다.

작고 재사용 가능한 도우미 모음

common.fullname 및 common.labels와 같은 몇 개의 부분 템플릿만으로도 모든 팀 차트가 기반으로 삼을 수 있는 공통 어휘를 만들 수 있습니다.

{{- define "common.fullname" -}}
{{ printf "%s-%s" .Release.Name .Chart.Name }}
{{- end -}}

빠른 확인

라이브러리는 labels 대신 common.labels처럼 템플릿 이름에 접두사를 붙여야 하는 이유가 무엇일까요?

요약: 템플릿 내보내기

밑줄로 시작하는 파일에서 define으로 재사용 가능한 로직을 공개하고, 이름에 네임스페이스를 지정하며, 컨텍스트는 호출자의 점(.)을 사용하도록 하는 방법을 배웠습니다. 🧩

자주 묻는 질문

“재사용 가능한 이름 지정 템플릿 내보내기” 강의는 무료인가요?

네 — “재사용 가능한 이름 지정 템플릿 내보내기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Helm Academy 강의 전체를 잠금 해제할 수 있습니다. Helm Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“재사용 가능한 이름 지정 템플릿 내보내기”에서 뭘 배우나요?

다른 차트에서 포함할 수 있는 부분 템플릿을 공개합니다. 브라우저에서 직접 실행하는 실습 코드로 Helm Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Helm Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Helm Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“재사용 가능한 이름 지정 템플릿 내보내기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Helm Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Helm Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 라이브러리 차트 유형 선언하기
  2. 재사용 가능한 이름 지정 템플릿 내보내기
  3. 라이브러리를 종속성으로 사용하기
  4. 로컬에서 라이브러리 기본값 재정의하기
← Helm Academy(으)로 돌아가기