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

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

PlikRola
aggregate.yamlIntencja dewelopera: pojedynczy komponent secrets (core/security/openbao) z włączonym wbudowanym interfejsem webowym.
manifest.yamlMapuje typ komponentu na oficjalną pobieraną encję Recipe (openbao).
release.yamlRekord 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_enabled dewelopera 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 PersistentVolumeClaim zamontowanym w /openbao/data, o rozmiarze określonym przez storage.size operatora.
  • 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:

Terminal window
aggrega scaffold --example openbao-secrets

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

Terminal window
cd openbao-secrets

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 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:

  • StatefulSet dla serwera OpenBao,
  • ConfigMap zawierają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,
  • ServiceAccount dla poda serwera,
  • ClusterRoleBinding nadający serwerowi uprawnienie token-review, którego używa do uwierzytelniania kont usług Kubernetes,
  • Pod z helm.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.