İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

DosyaRol
aggregate.yamlGeliştirici amacı: CRD kurulumu açık olan tek bir cert-manager bileşeni (core/security/cert-manager).
manifest.yamlBileşen türünü cert-manager Helm Recipe’ine (cert-manager) eşler.
release.yamlKubernetes 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 bir Deployment ve webhook’un CA paketini kümeye bağlayan CA enjektörü için bir Deployment.
  • Sertifika API’sinin kurulumu. Geliştiricinin install_crds değeri chart’a aktarılır; chart da cert-manager’ın CustomResourceDefinition’larını ( Certificate, Issuer, ClusterIssuer ve ACME Order/Challenge kaynaklarını) kurar. CRD’ler bant dışında yönetiliyorsa bunu false olarak ayarlayın.
  • Kabul bağlantıları. Chart, webhook’un sunduğu ValidatingWebhookConfiguration ve MutatingWebhookConfiguration’ı, webhook Service’ini ve tam RBAC kümesini — her denetleyici sorumluluğu için bir ClusterRole/ClusterRoleBinding ile lider seçimi Role’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:

Terminal window
aggrega scaffold --example cert-manager-tls

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd cert-manager-tls

Derleme

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:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Oluş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.