Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

sealed-secrets — kontroler deszyfrowania SealedSecret w Kubernetes

Ten przykład kompiluje mały, rzeczywisty stos — kontroler sealed-secrets — z jednej encji Aggregate napisanej przez dewelopera do Kubernetes, w oparciu o oficjalny chart Helm sealed-secrets udostępniany z repozytorium chartów HTTPS.

sealed-secrets pozwala bezpiecznie zatwierdzać zaszyfrowane sekrety w systemie kontroli wersji: klucz publiczny szyfruje sekret do zasobu niestandardowego SealedSecret, a kontroler o zasięgu klastra, przechowujący odpowiadający mu klucz prywatny, odszyfrowuje go z powrotem do natywnego obiektu Kubernetes Secret. Kontroler rozszerza API klastra o własny zasób niestandardowy SealedSecret, zamiast być serwerem, do którego kierowane są aplikacje, dlatego nie ma krawędzi uses i niczego nie eksportuje do konsumentów: aplikacje uzyskują sekrety, deklarując zasoby SealedSecret, a kontroler odpieczętowuje odpowiadające im obiekty Kubernetes Secret. Kontroler generuje swoją parę kluczy pieczętujących w klastrze w czasie działania, więc podczas renderowania nie powstaje żaden materiał kluczy.

Pliki

PlikRola
aggregate.yamlIntencja dewelopera: pojedynczy komponent sealed-secrets (core/security/sealed-secrets).
manifest.yamlMapuje typ komponentu na oficjalną pobieraną encję Recipe (sealed-secrets).
release.yamlRekord operatora dla celu Kubernetes: rozmiar zasobów obliczeniowych operatora.

Co demonstruje

  • Jedna powierzchnia tworzenia. Pojedyncza encja Aggregate jest źródłem prawdy o tym, czym jest kontroler; encja Manifest określa, jak go zrealizować.
  • Chart udostępniany przez HTTPS. Encja Recipe pobiera chart z repozytorium chartów HTTPS zamiast z rejestru OCI; kompilacja rozwiązuje go i przypina przy aggrega pull.
  • CRD dostarczane w katalogu CRD chartu. Definicja CustomResourceDefinition SealedSecret znajduje się w natywnym dla Helm katalogu CRD chartu, a nie w szablonach; jest renderowana do wyniku razem z wydaniem bezwarunkowo.
  • Kontroler rozszerzający klaster, bez krawędzi topologii. sealed-secrets dodaje własny zasób niestandardowy do API klastra; konsumenci żądają sekretów, deklarując zasoby SealedSecret, więc komponent nie tworzy krawędzi uses i niczego nie eksportuje.
  • Pojedynczy spójny kontroler. Chart renderuje jeden kontroler wraz z jego RBAC i usługami, bez obcego magazynu danych, pamięci podręcznej ani brokera. Wyrenderowany wynik jest identyczny bajt w bajt między uruchomieniami dla tych samych danych wejściowych.
  • Odtwarzalny obraz. Encja Recipe przypina obraz kontrolera do rozwiązywalnego tagu wydania (docker.io/bitnami/sealed-secrets-controller:0.38.4), więc wyrenderowane obciążenie odwołuje się do przypiętej wersji.

Generowanie przykładu

Ten przykład można zbudować za pomocą poniższych poleceń albo zlecić jego zbudowanie asystentowi AI.

Należy zapisać przykład w nowym folderze nazwanym tak jak on:

Terminal window
aggrega scaffold --example sealed-secrets-controller

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd sealed-secrets-controller

Kompilacja

Ta przestrzeń robocza nie zawiera pliku .aggrega-config.yaml, więc encje biblioteki standardowej są rozwiązywane z rejestru hub, hub.aggrega.ai, i flaga katalogu nie jest potrzebna:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Wyrenderowane artefakty trafiają do dist/. Kompilacja rozwiązuje nadrzędny chart z repozytorium chartów HTTPS przy aggrega pull i przypina go w pliku blokady.

Z asystentem AI

Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.

Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder obszaru roboczego nie zawiera jeszcze folderu `sealed-secrets-controller`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `sealed-secrets-controller` i bez `dir`: zapisze ono przykład w nowym folderze `sealed-secrets-controller`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `sealed-secrets-controller`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj mi, jakie pliki zapisała kompilacja; znajdują się w `sealed-secrets-controller/dist/`.

Co jest renderowane

Kompilacja emituje kontroler sealed-secrets jako zestaw obiektów Kubernetes:

  • jeden CustomResourceDefinition dla API sealed-secrets (SealedSecret),
  • jeden Deployment — kontroler,
  • RBAC, który go wiąże: ClusterRole, ClusterRoleBinding, dwa obiekty Role i dwa obiekty RoleBinding,
  • jeden ServiceAccount,
  • dwa obiekty Service — usługa kontrolera i jej usługa metryk.

Obraz kontrolera jest przypięty do tagu wydania, więc obciążenie odwołuje się do przypiętego tagu obrazu.