Generator ConfigMap (Kubernetes)

Generator ConfigMap Kubernetes

ConfigMap przechowuje niesekretną konfigurację aplikacji: zmienne środowiskowe, pliki konfiguracyjne, parametry. Oddzielenie konfiguracji od obrazu pozwala zmieniać ustawienia bez przebudowy kontenera.

ConfigMap czy Secret?

Jak używać ConfigMap?

1. Zapisz manifest jako plik configmap.yaml.
2. Zastosuj: kubectl apply -f configmap.yaml.
3. W Deployment odwołaj się przez envFrom lub valueFrom.configMapKeyRef.

Przykład użycia w Deployment

envFrom:
  - configMapRef:
      name: app-config

Jak działa generator ConfigMap

Generator działa jak formularz, który zamienia dane wejściowe na manifest YAML. Zbiera nazwę obiektu, przestrzeń nazw, etykiety, adnotacje oraz pary klucz-wartość. Następnie układa je w ustalonej kolejności: apiVersion: v1, kind: ConfigMap, metadata i data. Wynik jest zwykłym tekstem YAML, który można skopiować albo pobrać. Narzędzie nie łączy się z klastrem, nie wykonuje kubectl i nie sprawdza, czy obiekt już istnieje.

Mechanizm opiera się na mapowaniu pól formularza na strukturę obiektu. Klucze w sekcji data są tekstowe, a wartości również są traktowane jako tekst. Dlatego liczby, daty i wartości logiczne warto ujmować w cudzysłów, jeśli aplikacja odczytuje je jako stringi. Wartości wieloliniowe, na przykład plik konfiguracyjny, generator może zapisać jako blok skalarny z odpowiednim wcięciem. To ważne, bo YAML jest wrażliwy na spacje i tabulatory.

Zasada jest prosta: generator tylko porządkuje dane w poprawny manifest. Nie interpretuje znaczenia kluczy, nie zna wymagań aplikacji i nie zastępuje walidacji po stronie klastra. Po wygenerowaniu YAML nadal trzeba go sprawdzić, na przykład poleceniem kubectl apply --dry-run=client, oraz upewnić się, że dane nie zawierają informacji wrażliwych. Dzięki temu konfiguracja jest oddzielona od obrazu kontenera i może być wersjonowana razem z manifestami.

Przykład krok po kroku: ConfigMap dla aplikacji webp-config

1. W generatorze wpisujesz nazwę webp-config i przestrzeń nazw prod. Dodajesz cztery pary klucz-wartość: APP_ENV=production, LOG_LEVEL=info, MAX_CONNECTIONS=50 oraz TIMEOUT_SECONDS=30.
2. Narzędzie zamienia wartości liczbowe na tekst i w YAML zapisuje je w cudzysłowie: 50 i 30. Dzięki temu ConfigMap przechowuje stringi, a nie liczby, co jest wymagane w sekcji data.
3. Generator buduje manifest: apiVersion: v1, kind: ConfigMap, sekcję metadata z nazwą i namespace oraz sekcję data z czterema kluczami.
4. Sprawdzasz długość sekcji data. Klucze i wartości mają razem 64 znaki: APP_ENV i production to 17, LOG_LEVEL i info to 13, MAX_CONNECTIONS i 50 to 17, TIMEOUT_SECONDS i 30 to 17. Suma: 17 + 13 + 17 + 17 = 64.
5. Doliczasz formatowanie YAML: wcięcia, separatory, znaki nowej linii, nagłówek data oraz cudzysłowy wokół wartości liczbowych. Daje to dodatkowe 30 znaków, więc sama sekcja data ma 94 znaki. Po dodaniu nagłówków apiVersion, kind i metadata cały manifest ma 173 znaki.
6. Kopiujesz wynik do pliku YAML i wykorzystujesz go w swoim repozytorium lub procesie wdrożeniowym. Przed użyciem warto sprawdzić składnię i upewnić się, że klucze odpowiadają oczekiwaniom aplikacji.

Pola manifestu ConfigMap generowane z formularza

Praktyczne wskazówki użycia

• Ustal konwencję nazw kluczy. Wybierz jeden styl, na przykład wielkie litery z podkreśleniami, i trzymaj go we wszystkich środowiskach. Dzięki temu odwołania w Deployment są przewidywalne i łatwiej je wyszukiwać.
• Grupuj ustawienia według aplikacji lub komponentu. Jeden ConfigMap dla całego systemu bywa trudny w utrzymaniu. Lepiej tworzyć mniejsze obiekty, na przykład dla frontendu, backendu i workera.
• Uważaj na typy wartości. Jeśli aplikacja oczekuje stringa, nie polegaj na automatycznej interpretacji YAML. Wartości liczbowe i logiczne zapisuj w cudzysłowie, gdy mają być tekstem.
• Wersjonuj manifest razem z kodem. Zmiany w ConfigMap powinny przechodzić przegląd i mieć historię w repozytorium. To ułatwia rollback oraz audyt konfiguracji.
• Testuj zmiany poza produkcją. Nawet poprawny YAML może wywołać błąd, jeśli aplikacja nie zna nowego klucza albo oczekuje innego formatu. Warto najpierw sprawdzić manifest w środowisku testowym.

Ograniczenia generatora i typowe pułapki

• Brak połączenia z klastrem. Narzędzie generuje tylko YAML. Nie sprawdza, czy nazwa jest już zajęta, czy namespace istnieje i czy masz uprawnienia RBAC.
• Brak walidacji semantycznej. Generator nie wie, jakich kluczy oczekuje aplikacja. Poprawny YAML może nadal zawierać literówkę w nazwie klucza, która ujawni się dopiero w środowisku.
• Brak szyfrowania i kontroli sekretów. Wartości wpisane do formularza pozostają jawne w manifeście. Jeśli przypadkowo umieścisz tam hasło, trafi ono do pliku i historii repozytorium.
• Wrażliwość YAML na formatowanie. Wcięcia, znaki specjalne i wieloliniowe wartości mogą zostać źle wklejone. Generator nie zastąpi sprawdzenia składni ani testu na klastrze.

Najczęstsze pytania