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

cert-manager — kontroler cyklu życia certyfikatów TLS w Kubernetes

Ten przykład kompiluje mały, rzeczywisty stos — kontroler certyfikatów cert-manager — z jednej encji Aggregate utworzonej przez programistę do Kubernetes. Programista deklaruje, czym jest cert-manager; pojedyncza encja Recipe zespołu Ops mapuje tę intencję na oficjalny chart Helm cert-managera z rejestru jetstack i renderuje obiekty Kubernetes.

cert-manager to dodatek Kubernetes o zasięgu klastra, który automatyzuje wydawanie i odnawianie certyfikatów X.509 ze źródeł takich jak ACME (Let’s Encrypt), prywatny CA lub Vault. Rozszerza klaster o własne zasoby niestandardowe Certificate, Issuer i ClusterIssuer. Aplikacje proszą o certyfikaty, deklarując te zasoby — a nie przez podłączenie usługi nadrzędnej — dlatego komponent nie ma krawędzi uses. Z tego samego powodu nie ma samodzielnej formy lokalnego kontenera, więc ta rodzina dostarcza wyłącznie Recipe dla Helm; nie ma celu Compose. Komponent publikuje jedynie informację, gdzie serwer Prometheus znajduje jego metryki.

Pliki

PlikRola
aggregate.yamlIntencja programisty: pojedynczy komponent cert-manager (core/security/cert-manager) z włączoną instalacją CRD.
manifest.yamlMapuje typ komponentu na encję Recipe dla Helm cert-managera (cert-manager).
release.yamlRekord operatora dla celu Kubernetes: wymiarowanie kontrolera, webhooka i wstrzykiwacza CA.

Co demonstruje

  • Jedna powierzchnia tworzenia, realizowana przez encję Recipe zespołu Ops. Encja Aggregate jest źródłem prawdy o tym, czym jest cert-manager. Encja Manifest określa, jak go zrealizować, mapując typ komponentu na encję Recipe po nazwie; encja Release dostarcza wymiarowanie operacyjne. Intencja programisty i mapowanie Ops pozostają rozdzielone.
  • Trzy skoordynowane obciążenia z jednego komponentu. Encja Recipe renderuje wszystkie trzy części cert-managera: Deployment dla kontrolera, który uzgadnia żądania certyfikatów, Deployment dla webhooka, który waliduje zasoby niestandardowe i uzupełnia ich wartości domyślne, oraz Deployment dla wstrzykiwacza CA, który wprowadza pakiet CA webhooka do klastra.
  • Instalacja API certyfikatów. Wartość install_crds podana przez programistę trafia do chartu, który instaluje definicje CustomResourceDefinition cert-managera (zasoby Certificate, Issuer, ClusterIssuer oraz ACME Order/Challenge). Należy ustawić ją na false, gdy CRD są zarządzane poza tym procesem.
  • Podłączenie kontroli dopuszczania. Chart emituje ValidatingWebhookConfiguration i MutatingWebhookConfiguration obsługiwane przez webhook, Service webhooka oraz pełny zestaw RBAC — jedną parę ClusterRole/ClusterRoleBinding na każdy obszar odpowiedzialności kontrolera oraz obiekty Role wyboru lidera — dzięki czemu kontroler ma potrzebne uprawnienia.
  • Odtwarzalne obrazy. Chart dostarcza rozwiązywalne tagi wydań; encja Recipe ponownie przypina obrazy kontrolera, webhooka, wstrzykiwacza CA i solvera ACME do tych tagów, dzięki czemu wyrenderowane obciążenia odwołują się do przypiętych 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 cert-manager-tls

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

Terminal window
cd cert-manager-tls

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 `cert-manager-tls`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `cert-manager-tls` i bez `dir`: zapisze ono przykład w nowym folderze `cert-manager-tls`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `cert-manager-tls`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Powiedz mi, które pliki zapisało budowanie; znajdują się w `cert-manager-tls/dist/`.

Co jest renderowane

Kompilacja emituje pełny stos cert-managera — trzy obiekty Deployment (kontroler, webhook i wstrzykiwacz CA), sześć definicji CustomResourceDefinition cert-managera, gdy install_crds jest włączone, ValidatingWebhookConfiguration i MutatingWebhookConfiguration, Service webhooka, obiekty ServiceAccount kontrolera oraz zestaw RBAC złożony z obiektów ClusterRole, ClusterRoleBinding oraz Role i RoleBinding wyboru lidera. Zawiera też poinstalacyjny Job (sprawdzenie API przy starcie, które blokuje do czasu, aż API certyfikatów zacznie działać) oraz po jednym Service metryk dla kontrolera i dla wstrzykiwacza CA — łącznie 50 obiektów Kubernetes. Obrazy kontrolera, webhooka, wstrzykiwacza CA i solvera ACME są przypięte do tagów wydań, więc każde obciążenie odwołuje się do przypiętego tagu obrazu.