Generator values.yaml (Helm)

Generator values.yaml — konfiguracja wdrożenia w Kubernetes

Helm to menedżer pakietów dla Kubernetes. Plik values.yaml zawiera parametry wykresu — obraz, liczbę replik, zasoby i konfigurację wejścia. Ten generator tworzy gotowy szablon.

Co zawiera plik?

Typy usług

• ClusterIP — dostęp tylko wewnątrz klastra (domyślny).
• NodePort — wystawia usługę na porcie każdego węzła.
• LoadBalancer — tworzy zewnętrzny balanser (np. w chmurze).

Uruchomienie

Umieść plik w katalogu wykresu i użyj:

helm install moja-aplikacja ./chart -f values.yaml

Jak generator zamienia pola formularza na values.yaml

Generator nie tworzy manifestów Kubernetes ani nie szablonuje chartu. Zbiera wartości z formularza i zapisuje je jako dokument YAML w strukturze map, którą Helm odczytuje jako .Values. Każde pole formularza odpowiada ścieżce w drzewie, na przykład image.repository, service.type albo resources.requests.cpu. Zagnieżdżenie wynika z wcięć, a typ wartości z zapisu: liczba, tekst, boolean albo ilość.

Podczas wdrożenia Helm łączy values.yaml z chartu z plikami przekazanymi przez -f oraz nadpisaniami --set. Wartości z -f mają wyższy priorytet niż domyślne, a --set zwykle wygrywa z plikiem. Szablony chartu odczytują finalny zestaw przez .Values i podstawiają go do manifestów. Dlatego generator porządkuje tylko warstwę danych, a nie logikę szablonów.

Poprawny YAML wymaga spójnych wcięć i typów. Jeśli zamiast liczby pojawi się tekst, szablon może porównywać wartości niepoprawnie albo Helm zwróci błąd. Generator pilnuje formatu, ale nie zna wymagań Twojego chartu, więc nazwy kluczy i struktura muszą odpowiadać temu, czego oczekują szablony.

Przykład krok po kroku: wartości dla aplikacji sklepu

1. Ustal obraz. Wpisz repozytorium registry.example.com/sklep, tag 1.4.2 i pullPolicy IfNotPresent. Generator zapisze je w sekcji image.
2. Ustaw repliki. Podaj replicaCount: 3. To trzy kopie aplikacji; przy request pamięci 128Mi na replikę łączny request wyniesie 384Mi.
3. Skonfiguruj usługę. Wybierz service.type ClusterIP, port 80 i targetPort 8080. Ruch do portu 80 usługi trafi do procesu nasłuchującego na 8080 w kontenerze.
4. Dodaj zasoby. Ustaw requests.cpu 100m, requests.memory 128Mi, limits.cpu 500m i limits.memory 512Mi. Dla 3 replik sumy wyniosą: CPU requests 300m, CPU limits 1500m, pamięć requests 384Mi, pamięć limits 1536Mi, czyli 1,5Gi.
5. Włącz ingress. Podaj host sklep.example.com i ścieżkę /. Generator utworzy sekcję ingress z regułą routingu.
6. Wygeneruj plik i wdroż. Zapisz wynik jako values.yaml, a następnie wykonaj helm install sklep ./chart -f values.yaml. Helm połączy te wartości z domyślnymi z chartu i wyrenderuje manifesty.

Pola values.yaml, typy i skutek w szablonach

Praktyczne wskazówki przy generowaniu values.yaml

• Trzymaj wartości domyślne w chartcie. Plik z generatora traktuj jako nadpisanie dla konkretnego środowiska, a nie jako jedyne źródło prawdy. Dzięki temu chart pozostaje użyteczny także bez dodatkowego pliku.
• Rozdzielaj środowiska plikami. Przygotuj osobne values-dev.yaml i values-prod.yaml, jeśli konfiguracje różnią się liczbą replik, zasobami lub ingressem. Łatwiej wtedy śledzić zmiany i ograniczyć przypadkowe wdrożenie złej wersji.
• Sprawdzaj render przed instalacją. Użyj helm template oraz helm lint, aby zobaczyć, jakie manifesty powstaną z połączonych wartości. Dopiero potem wykonuj helm install lub helm upgrade.
• Nie wpisuj sekretów. Hasła, tokeny i klucze powinny trafiać do Secret, zewnętrznego menedżera albo bezpiecznego mechanizmu przekazywania. values.yaml jest jawny i często ląduje w repozytorium.
• Nazywaj klucze zgodnie z chartem. Jeśli szablon odwołuje się do .Values.app.image.repository, nie zmieniaj tej ścieżki na imageRepository. Generator nie poprawi nazw, które nie pasują do szablonów.

Ograniczenia generatora i czynniki zaburzające wynik

• Nie waliduje szablonów chartu. Poprawny YAML nie gwarantuje, że chart używa dokładnie tych kluczy i typów. Błąd może pojawić się dopiero podczas helm template albo helm install.
• Nie zna domyślnych wartości chartu. Generator nie pobiera values.yaml z repozytorium ani zależności. Jeśli pominiesz pole, Helm użyje wartości z chartu, a nie z formularza.
• Nie zarządza sekretami. Wartości wpisane do pliku są jawne. Przekazanie hasła przez values.yaml może naruszać zasady bezpieczeństwa i pozostawiać dane w historii wdrożeń.
• Nie rozstrzyga konfliktów priorytetów. Przy wielu plikach -f oraz opcjach --set wynik zależy od kolejności i sposobu nadpisywania. Ten sam formularz może dać inny efekt końcowy w zależności od polecenia Helm.

Najczęstsze pytania