Przekazywanie zakresu do nazwanego szablonu
Przekazywanie właściwego obiektu kontekstu do partiala.
Przekazywanie zakresu do nazwanego szablonu to bezpłatna lekcja Helm Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Helm Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Helm Academy zawiera 4 lekcji w sumie.
Partiale wymagają kontekstu
Named template może odczytywać tylko to, co zostanie mu przekazane. Drugi argument funkcji include określa zakres, czyli kropkę widoczną wewnątrz partiala.
{{ include "mychart.labels" . }}Kropka określa zakres
Końcowa kropka oznacza bieżący kontekst. Przekazanie głównej kropki daje partialowi dostęp do .Values, .Release i .Chart.
Pominięcie zakresu powoduje błędy
Jeśli wywołają Państwo partial bez zakresu, jego kropka będzie miała wartość nil. Każde odwołanie do .Values wewnątrz partiala zwróci wtedy pusty wynik albo spowoduje błąd.
{{ include "mychart.name" }}Przekazywanie głównego kontekstu
Większość helperów oczekuje pełnego kontekstu chartu, dlatego należy przekazać zwykłą kropkę. To bezpieślne ustawienie domyślne, dzięki któremu standardowe helpery działają poprawnie.
{{ include "mychart.fullname" . }}Przekazywanie podobiektu
Czasami partial potrzebuje tylko jednego fragmentu values. Można przekazać mu poddrzewo, aby jego kropka wskazywała dokładnie ten fragment.
{{ include "mychart.ports" .Values.service }}Wewnątrz kropka się zmienia
Po przekazaniu .Values.service kropka w partialu wskazuje teraz ten obiekt. Odczytuje on bezpośrednio .port, a nie .Values.service.port.
{{- define "mychart.ports" -}}
port: {{ .port }}
{{- end -}}Celowe odcięcie od głównego kontekstu
Zawężenie zakresu jest przydatne, ale odcina dostęp do .Release i wartości globalnych. Partial widzi wyłącznie przekazany obiekt.
Przekazywanie obu elementów za pomocą dict
Potrzebują Państwo zarówno poddrzewa, jak i głównego kontekstu? Należy utworzyć mały dict i go przekazać, a następnie odwoływać się wewnątrz partiala do poszczególnych elementów za pomocą ich kluczy.
{{ include "mychart.tpl" (dict "top" . "svc" .Values.service) }}Odczytywanie połączonego zakresu
Wewnątrz partiala należy rozpakować dict według kluczy. W ten sposób główny kontekst jest dostępny przez .top, a poddrzewo przez .svc — oba jednocześnie.
{{- define "mychart.tpl" -}}
name: {{ .top.Release.Name }}
port: {{ .svc.port }}
{{- end -}}Błędy zakresu są częste
Klasyczny błąd polega na tym, że partial odczytuje .Release.Name, ale został wywołany z zawężonym zakresem. Zawsze należy sprawdzić, jaki kontekst został rzeczywiście przekazany.
Renderowanie w celu sprawdzenia zakresu
Uruchom helm template . i upewnij się, że wynik partiala zawiera dane. Puste pola zwykle oznaczają, że do partiala trafił nieprawidłowy zakres.
helm template my-release .Szybkie sprawdzenie
Partial potrzebuje zarówno poddrzewa, jak i .Release.Name. Jak przekazać oba elementy?
Podsumowanie: przekazywanie zakresu
Argument znajdujący się po nazwie partiala określa jego kropkę. Można przekazać główną kropkę, poddrzewo albo dict, aby połączyć oba elementy. Nieprawidłowy zakres oznacza pusty wynik. 🎯
Często zadawane pytania
Czy lekcja „Przekazywanie zakresu do nazwanego szablonu” jest bezpłatna?
Tak — pełny tekst „Przekazywanie zakresu do nazwanego szablonu” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Helm Academy, przejdź na CoddyKit PRO. Kurs Helm Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Przekazywanie zakresu do nazwanego szablonu”?
Przekazywanie właściwego obiektu kontekstu do partiala. Ćwiczysz Helm Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Helm Academy?
Nie wymagamy żadnego doświadczenia. Helm Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Przekazywanie zakresu do nazwanego szablonu”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Helm Academy?
Tak. Każda lekcja Helm Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Definiowanie partial za pomocą define
- Wstawianie partiali za pomocą template i include
- Standardowe helpery Fullname i Labels
- Przekazywanie zakresu do nazwanego szablonu