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
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: pojedynczy komponent cert-manager (core/security/cert-manager) z włączoną instalacją CRD. |
manifest.yaml | Mapuje typ komponentu na encję Recipe dla Helm cert-managera (cert-manager). |
release.yaml | Rekord 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:
Deploymentdla kontrolera, który uzgadnia żądania certyfikatów,Deploymentdla webhooka, który waliduje zasoby niestandardowe i uzupełnia ich wartości domyślne, orazDeploymentdla wstrzykiwacza CA, który wprowadza pakiet CA webhooka do klastra. - Instalacja API certyfikatów. Wartość
install_crdspodana przez programistę trafia do chartu, który instaluje definicjeCustomResourceDefinitioncert-managera (zasobyCertificate,Issuer,ClusterIssueroraz ACMEOrder/Challenge). Należy ustawić ją na false, gdy CRD są zarządzane poza tym procesem. - Podłączenie kontroli dopuszczania. Chart emituje
ValidatingWebhookConfigurationiMutatingWebhookConfigurationobsługiwane przez webhook,Servicewebhooka oraz pełny zestaw RBAC — jedną paręClusterRole/ClusterRoleBindingna każdy obszar odpowiedzialności kontrolera oraz obiektyRolewyboru 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:
aggrega scaffold --example cert-manager-tlsNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd cert-manager-tlsKompilacja
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 `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.