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

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

PlikRola
aggregate.yamlIntencja programisty: pojedynczy komponent external-secrets (core/security/external-secrets) instalujący definicje zasobów niestandardowych wraz z wydaniem.
manifest.yamlMapuje typ komponentu na oficjalną pobieraną encję Recipe (external-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 operator; encja Manifest określa, jak go zrealizować.
  • Wartość programisty trafia do renderowania. Wartość install_crds programisty jest zapisywana w wartości installCRDs chartu, 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 uses i 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:

Terminal window
aggrega scaffold --example external-secrets-operator

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

Terminal window
cd external-secrets-operator

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 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 CustomResourceDefinition dla API external-secrets (ExternalSecret, SecretStore, ClusterSecretStore oraz 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, Role oraz RoleBinding,
  • trzy obiekty ServiceAccount, po jednym na obciążenie,
  • Service dla 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.