cert-manager — Kubernetes TLS sertifikası yaşam döngüsü denetleyicisi
Bu örnek, küçük ama gerçek bir yığını — bir cert-manager sertifika
denetleyicisini — Developer tarafından yazılmış tek bir Aggregate’ten Kubernetes’e derler.
Geliştirici cert-manager’ın ne olduğunu bildirir; tek bir Ops Recipe bu amacı
jetstack kayıt defterindeki resmi cert-manager Helm chart’ına eşler ve
Kubernetes nesnelerini oluşturur.
cert-manager, X.509 sertifikalarının ACME (Let’s
Encrypt), özel bir CA veya Vault gibi yayımlayıcı kaynaklardan verilmesini ve yenilenmesini otomatikleştiren, küme kapsamlı bir Kubernetes eklentisidir. Kümeyi kendi
Certificate, Issuer ve ClusterIssuer özel kaynaklarıyla genişletir. Uygulamalar sertifikaları
bir upstream bağlayarak değil, bu kaynakları bildirerek ister; bu nedenle
bileşen hiçbir uses kenarı almaz. Aynı nedenle bağımsız bir yerel konteyner biçimi yoktur; bu yüzden bu aile yalnızca bir Helm Recipe’i sunar ve
Compose hedefi yoktur. Bileşenin yayımladığı tek şey, bir Prometheus sunucusunun
metriklerini nerede bulacağıdır.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Geliştirici amacı: CRD kurulumu açık olan tek bir cert-manager bileşeni (core/security/cert-manager). |
manifest.yaml | Bileşen türünü cert-manager Helm Recipe’ine (cert-manager) eşler. |
release.yaml | Kubernetes hedefi için operatör kaydı: denetleyici/webhook/CA enjektörü boyutlandırması. |
Neyi gösteriyor
- Bir Ops Recipe ile gerçekleştirilen tek yazım yüzeyi. Aggregate, cert-manager’ın ne olduğuna dair doğruluk kaynağıdır. Manifest, bileşen türünü adıyla bir Recipe’e eşleyerek onun nasıl gerçekleştirileceğini söyler; Release ise operasyonel boyutlandırmayı sağlar. Geliştirici amacı ile Ops eşlemesi ayrı kalır.
- Tek bileşenden üç eşgüdümlü iş yükü. Recipe, cert-manager’ın üç
parçasının tamamını oluşturur: sertifika isteklerini uzlaştıran denetleyici için bir
Deployment, özel kaynakları doğrulayan ve varsayılanlarını atayan webhook için birDeploymentve webhook’un CA paketini kümeye bağlayan CA enjektörü için birDeployment. - Sertifika API’sinin kurulumu. Geliştiricinin
install_crdsdeğeri chart’a aktarılır; chart da cert-manager’ınCustomResourceDefinition’larını (Certificate,Issuer,ClusterIssuerve ACMEOrder/Challengekaynaklarını) kurar. CRD’ler bant dışında yönetiliyorsa bunu false olarak ayarlayın. - Kabul bağlantıları. Chart, webhook’un sunduğu
ValidatingWebhookConfigurationveMutatingWebhookConfiguration’ı, webhookService’ini ve tam RBAC kümesini — her denetleyici sorumluluğu için birClusterRole/ClusterRoleBindingile lider seçimiRole’lerini — üretir; böylece denetleyici ihtiyaç duyduğu izinlere sahip olur. - Yeniden üretilebilir imajlar. Chart, çözümlenebilir sürüm etiketleriyle gelir; Recipe denetleyici, webhook, CA enjektörü ve ACME çözücü imajlarını bu etiketlere yeniden sabitler; böylece oluşturulan iş yükleri sabitlenmiş sürümlere başvurur.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example cert-manager-tlsArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd cert-manager-tlsDerleme
Bu çalışma alanında .aggrega-config.yaml bulunmaz; bu nedenle standart kütüphane varlıkları hub kayıt defteri hub.aggrega.ai üzerinden çözümlenir ve katalog bayrağına gerek yoktur:
aggrega pull --release release.yamlaggrega build --release release.yamlOluşturulan yapıtlar dist/ altına yerleşir. Derleme, upstream chart’ı
aggrega pull sırasında OCI başvurusuyla çözümler ve bir kilit dosyasına sabitler.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Çalışma alanı klasöründe henüz `cert-manager-tls` klasörü yoksa `scaffold` aracını `example` değeri `cert-manager-tls` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `cert-manager-tls` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `cert-manager-tls`, `release` değeri `release.yaml`, `auto_pull` değeri true ve `write` değeri true olarak ayarlanmış şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `cert-manager-tls/dist/` altındadır.Neler oluşturulur
Derleme, cert-manager yığınının tamamını üretir: üç Deployment (denetleyici, webhook ve CA enjektörü), install_crds açık olduğunda altı cert-manager CustomResourceDefinition’ı, bir ValidatingWebhookConfiguration ve bir MutatingWebhookConfiguration, webhook Service’i, denetleyici ServiceAccount’ları ve ClusterRole’ler, ClusterRoleBinding’ler ile lider seçimi Role’leri ve RoleBinding’lerinden oluşan RBAC kümesi. Ayrıca bir kurulum sonrası Job (sertifika API’si hizmet verene kadar bekleyen başlangıç API denetimi) ile denetleyici ve CA enjektörü için birer metrik Service’i de içerir — toplamda 50 Kubernetes nesnesi. Denetleyici, webhook, CA enjektörü ve ACME çözücü imajları sürüm etiketlerine sabitlenmiştir; böylece her iş yükü sabitlenmiş bir imaj etiketine başvurur.