0Pricing
Helm Academy · 강의

template 및 include로 부분 템플릿 삽입하기

include는 파이프라인과 조합되지만 template은 그렇지 않은 이유를 알아봅니다.

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

부분 템플릿 호출하기

정의된 부분 템플릿은 호출하기 전까지 아무 동작도 하지 않습니다. Helm은 이를 위해 template과 include라는 두 가지 동작을 제공합니다.

template 동작

template 동작은 이름이 지정된 부분 템플릿을 인라인으로 렌더링합니다. 부분 템플릿 이름과 읽어 올 범위 객체를 전달합니다.

{{ template "mychart.labels" . }}

template의 한계

template 동작은 표현식이 아니라 문입니다. 출력이 문서에 바로 들어가므로 다른 함수에 파이프로 전달할 수 없습니다.

include 등장

Helm은 이러한 한계를 해결하기 위해 include 함수를 추가했습니다. 같은 부분 템플릿을 렌더링하지만 결과를 변환할 수 있는 문자열로 반환합니다.

{{ include "mychart.labels" . }}

include와 파이프라인 조합하기

include는 값을 반환하므로 indent나 nindent와 같은 함수로 파이프할 수 있습니다. 이것이 차트에서 거의 항상 include를 선호하는 이유입니다.

{{ include "mychart.labels" . | indent 4 }}

진짜 이유는 들여쓰기입니다

삽입된 YAML은 올바른 들여쓰기 위치에 들어가야 합니다. include만 nindent로 파이프할 수 있으므로 매번 올바르게 중첩된 출력을 만들 수 있습니다.

metadata:
  labels:
    {{- include "mychart.labels" . | nindent 4 }}

범위 인수

부분 템플릿 이름 뒤의 점은 부분 템플릿에 전달하는 범위입니다. 루트 점을 전달하면 부분 템플릿에서 .Values와 .Release를 읽을 수 있습니다.

{{ include "mychart.fullname" . }}

이름을 만드는 도우미

여기서는 부분 템플릿이 이름을 반환하고, Deployment가 include를 사용해 그 이름을 메타데이터에 삽입합니다. 하나의 기준 소스를 여러 호출자가 공유합니다.

metadata:
  name: {{ include "mychart.fullname" . }}

template에도 쓰임새가 있습니다

실제 코드에서는 여전히 template을 볼 수 있습니다. 보통 파이프 전달이 필요하지 않고 자체적으로 한 줄에 전체 블록을 출력하는 부분 템플릿에 사용합니다.

{{ template "mychart.notes" . }}

경험칙

출력에 들여쓰기나 후처리가 필요하다면 include를 사용하십시오. 정말 필요하지 않은 경우에만 일반 템플릿 동작을 사용하십시오.

렌더링하여 확인하기

helm template .을 실행하고, 부분 템플릿이 예상한 들여쓰기로 확장되었는지 확인하십시오. 여기서 가장 흔한 실수는 YAML의 들여쓰기가 어긋나는 것입니다.

helm template my-release .

빠른 확인

부분 템플릿을 렌더링하고 labels 키 아래에 들여써야 합니다. 어떤 동작을 사용해야 합니까?

복습: template와 include 비교

둘 다 부분 템플릿을 호출하지만, include는 파이프로 전달할 수 있는 문자열을 반환하고 template은 인라인으로만 출력합니다. 깔끔한 YAML을 위해 nindent와 함께 include를 우선 사용하십시오. ✨

자주 묻는 질문

“template 및 include로 부분 템플릿 삽입하기” 강의는 무료인가요?

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

“template 및 include로 부분 템플릿 삽입하기”에서 뭘 배우나요?

include는 파이프라인과 조합되지만 template은 그렇지 않은 이유를 알아봅니다. 브라우저에서 직접 실행하는 실습 코드로 Helm Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“template 및 include로 부분 템플릿 삽입하기” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. define으로 부분 템플릿 정의하기
  2. template 및 include로 부분 템플릿 삽입하기
  3. 표준 Fullname 및 Labels 도우미
  4. 이름 있는 템플릿에 범위 전달하기
← Helm Academy(으)로 돌아가기