external-secrets — operator Kubernetes do synchronizacji sekretów
Ten przykład kompiluje mały, rzeczywisty stos — operator external-secrets —
z jednej encji Aggregate utworzonej przez programistę do Kubernetes, w oparciu o oficjalny
chart Helm external-secrets.
external-secrets synchronizuje dane sekretów z zewnętrznych systemów zarządzania
sekretami — HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key
Vault i innych — do natywnych obiektów Secret w Kubernetes, utrzymując ich zgodność w miarę
zmian w źródle. Jest to kontroler o zasięgu klastra, który rozszerza API klastra
o własne zasoby niestandardowe, a nie serwer, do którego kierują ruch aplikacje, dlatego
nie przyjmuje krawędzi uses, a publikuje jedynie miejsce, w którym serwer Prometheus znajduje
jego metryki: aplikacje uzyskują sekrety, deklarując zasoby ExternalSecret i
SecretStore, a operator tworzy odpowiadające im obiekty
Kubernetes Secret.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: pojedynczy komponent external-secrets (core/security/external-secrets) instalujący definicje zasobów niestandardowych wraz z wydaniem. |
manifest.yaml | Mapuje typ komponentu na oficjalną pobieraną encję Recipe (external-secrets). |
release.yaml | Rekord 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 operator; encja Manifest określa, jak go zrealizować.
- Wartość programisty trafia do renderowania. Wartość
install_crdsprogramisty jest zapisywana w wartościinstallCRDschartu, co wprowadza definicje zasobów niestandardowych external-secrets do klastra wraz z wydaniem. - Kontroler rozszerzający klaster, bez krawędzi topologii. external-secrets dodaje
własne zasoby niestandardowe do API klastra; konsumenci żądają sekretów,
deklarując te zasoby, dlatego komponent nie tworzy krawędzi
usesi eksportuje jedynie informację o tym, gdzie są jego metryki. - Jeden spójny operator. Chart renderuje kontroler, webhook i kontroler certyfikatów jako jeden operator; dołączony subchart dostawcy jest wyłączony, więc nie jest dociągany żaden obcy magazyn danych, cache ani broker. Wyrenderowany wynik jest identyczny bajt po bajcie między uruchomieniami dla tych samych danych wejściowych.
- Odtwarzalny obraz. Encja Recipe przypina wszystkie trzy obrazy kontenerów do rozwiązywalnego tagu wydania (
ghcr.io/external-secrets/external-secrets:v2.7.0), dzięki czemu wyrenderowane obciążenia odwołują 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 external-secrets-operatorNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd external-secrets-operatorKompilacja
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 obszaru roboczego nie zawiera jeszcze folderu `external-secrets-operator`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `external-secrets-operator` i bez `dir`: zapisuje ono przykład w nowym folderze `external-secrets-operator`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `external-secrets-operator`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj mi, które pliki zapisała kompilacja; znajdują się w `external-secrets-operator/dist/`.Co jest renderowane
Kompilacja emituje operator external-secrets jako zestaw obiektów Kubernetes:
- 24 obiekty
CustomResourceDefinitiondla API external-secrets (ExternalSecret,SecretStore,ClusterSecretStoreoraz powiązane zasoby push i generatorów), - trzy obiekty
Deployment— kontroler, webhook i kontroler certyfikatów, - RBAC, który je wiąże: obiekty
ClusterRole,ClusterRoleBinding,RoleorazRoleBinding, - trzy obiekty
ServiceAccount, po jednym na obciążenie, Servicedla webhooka,- dwa obiekty
ValidatingWebhookConfiguration, - zastępczy
Secret, który kontroler certyfikatów wypełnia certyfikatem serwującym webhooka w czasie działania.
Wszystkie trzy obrazy kontenerów są przypięte do tagu wydania, dzięki czemu obciążenia odwołują się do przypiętych obrazów.