OpenBao — serwer zarządzania sekretami w Kubernetes
Ten przykład kompiluje mały, rzeczywisty stos — pojedynczy serwer sekretów OpenBao — z jednego Aggregate napisanego przez dewelopera do Kubernetes, w oparciu o
oficjalny chart Helm OpenBao.
OpenBao przechowuje i generuje tokeny, hasła, certyfikaty oraz inne sekrety i kontroluje dostęp do nich za uwierzytelnionym API HTTP, a swój stan szyfruje w spoczynku na trwałym wolumenie danych. Działa tu jako pojedynczy samodzielny serwer, który przechowuje stan we wbudowanym backendzie pamięci plikowej, dlatego jest renderowany jako stanowy działający serwer oparty na trwałym wolumenie, a nie jako zasób zarządzanej chmury. Serwer jest inicjalizowany i odpieczętowywany w czasie działania wewnątrz klastra — jego token root i klucze odpieczętowania wytwarza działający serwer po uruchomieniu — dlatego w encji Aggregate nie deklaruje się żadnych poświadczeń, a żaden sekret nie jest materializowany w czasie kompilacji.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja dewelopera: pojedynczy komponent secrets (core/security/openbao) z włączonym wbudowanym interfejsem webowym. |
manifest.yaml | Mapuje typ komponentu na oficjalną pobieraną encję Recipe (openbao). |
release.yaml | Rekord operatora dla celu Kubernetes: wymiarowanie zasobów obliczeniowych serwera i rozmiar wolumenu danych. |
Co demonstruje
- Jedna powierzchnia tworzenia. Pojedyncza encja Aggregate jest źródłem prawdy o tym, czym jest serwer sekretów; encja Manifest określa, jak go zrealizować.
- Wartość dewelopera trafia do renderu. Wartość
ui_enableddewelopera jest zapisywana w konfiguracji serwera montowanej przez chart i włącza lub wyłącza wbudowany interfejs webowy. - Stanowy serwer na trwałym wolumenie. Pobierana encja Recipe
konfiguruje tryb samodzielny z backendem pamięci plikowej, więc serwer przechowuje
zaszyfrowany stan na
PersistentVolumeClaimzamontowanym w/openbao/data, o rozmiarze określonym przezstorage.sizeoperatora. - Brak poświadczeń w czasie renderowania. OpenBao sam się inicjalizuje i odpieczętowuje w czasie
działania, więc kompilacja nie podłącza żadnych poświadczeń i nie emituje obiektu
Secret. Wyrenderowane wyjście jest identyczne bajt w bajt między uruchomieniami dla tego samego wejścia. - Odtwarzalny obraz. Encja Recipe przypina obraz serwera do rozwiązywalnego tagu wydania (
quay.io/openbao/openbao:2.5.5), 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:
aggrega scaffold --example openbao-secretsNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd openbao-secretsKompilacja
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:
aggrega pull --release release.yamlaggrega build --release release.yamlWyrenderowane artefakty trafiają do dist/. Kompilacja rozwiązuje chart nadrzędny
przez referencję OCI 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 Workspace nie zawiera jeszcze folderu `openbao-secrets`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `openbao-secrets` i bez `dir`: zapisuje ono przykład w nowym folderze `openbao-secrets`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `openbao-secrets`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Powiedz mi, jakie pliki zapisała kompilacja; znajdują się w `openbao-secrets/dist/`.Co jest renderowane
Kompilacja emituje oszczędny stos OpenBao z jednym obciążeniem jako siedem obiektów Kubernetes:
StatefulSetdla serwera OpenBao,ConfigMapzawierający konfigurację serwera (backend pamięci plikowej i nasłuchiwacz API),- dwa obiekty
Service— główna usługa API oraz wewnętrzna usługa headless, której StatefulSet używa do stabilnej sieci podów, ServiceAccountdla poda serwera,ClusterRoleBindingnadający serwerowi uprawnienie token-review, którego używa do uwierzytelniania kont usług Kubernetes,Podzhelm.sh/hook: test, który sprawdza gotowość serwera.
Nie ma żadnych obiektów CustomResourceDefinition — OpenBao jest samodzielnym serwerem, a nie kontrolerem rozszerzającym API klastra. Obraz serwera jest przypięty do tagu wydania, więc obciążenie odwołuje się do przypiętego tagu obrazu.