title: “Kubernetes Kümenizde Yönetilen Dağıtım” description: “Kubernetes Kümenizde AgentEye Yönetilen Dağıtım belgelendirmesi.”
AgentEye, AI ve LLM ajanları için kendi kendini barındıran bir gözlemlenebilirlik ve değerlendirme platformudur. Ajan oturumlarını, araç çağrılarını, model isteklerini ve hataları yakalar, bunları aranabilir analizlere ve değerlendirmelere dönüştürür ve sonuçları isteğe bağlı salt okunur bir yapay zeka asistanı ile bir panoyla ortaya çıkarır. Yönetilen dağıtım modelinde, siz özel bir Kubernetes kümesi sağlar ve Exosphere tüm platformu kümenin içinde çalıştırarak her bir bileşeni dağıtır, yapılandırır, işletir, yedekler ve günceller. Ekibiniz platformun değerini (ajan görünürlüğü, analiz, değerlendirme ve isteğe bağlı asistan) veritabanlarını, sertifikaları veya güncellemeleri işletmeden alır. Tüm veriler bulut hesabınız içinde kalır.Ön Koşullar
- Konteyner görüntülerini çekmek ve yapıtları indirmek için bir GitHub PAT (bkz. enterprise-docs/github-token.md)
- Bir özel Kubernetes kümesi (aşağıdaki gereksinimlere bakınız)
- Veritabanı yedekleri için bir depolama demeti
- Ağ bağlantısı: kümenin yük dengeleyicisine 443 numaralı bağlantı noktasında gelen trafik
Adım 1: Özel Bir Kubernetes Kümesi Sağlayın
AgentEye’a adanmış bir Kubernetes kümesi oluşturun. Bu küme diğer iş yükleri ile paylaşılmamalıdır, böylece tüm platform (uygulama hizmetleri, veritabanları, analiz ve önbelleğe alma) mevcut altyapınızı etkilemeden izolasyon içinde çalışır.| Gereksinim | Detaylar |
|---|---|
| Dağıtım | Herhangi bir uyumlu Kubernetes: EKS, GKE, AKS veya kendi kendini yönetilen |
| Sürüm | 1.27 veya sonrası |
| Düğüm havuzu | Minimum: 3 düğüm, her biri 4 vCPU / 8 GB RAM (standart genel amaçlı örnekler) |
| Depolama | Blok birimler sağlayan bir varsayılan StorageClass (örneğin AWS’de gp3, GCP’de pd-ssd) |
| Yük Dengeleyici | Küme, bulut LoadBalancer hizmetlerini sağlayabilmelidir (EKS, GKE, AKS’de varsayılan) |
Exosphere, kümenin içinde diğer her şeyi yükler ve yönetir: giriş kontrolörleri, TLS sertifikaları, veritabanları, önbelleğe alma, izleme ve tüm uygulama dağıtımları.
Adım 2: AgentEye Ekibine Erişim İzni Verin
Exosphere’in ad alanlarını, özel kaynak tanımlarını, giriş kontrolörlerini ve depolama sağlayıcılarını yönetmek için cluster-admin erişimine (veya eşdeğer geniş RBAC) ihtiyacı vardır.| Gereksinim | Detaylar |
|---|---|
| Erişim yöntemi | IAM rolü (EKS/GKE için tercih edilen), kubeconfig veya SSO tabanlı erişim |
| VPN / bastion | Kubernetes API sunucusu özel ise, Exosphere operasyon ekibine VPN kimlik bilgileri veya bastion erişimi sağlayın |
Adım 3: Ağ Bağlantısını Yapılandırın
Ağ ekibinizin kümenin yük dengeleyicilerine 443 numaralı bağlantı noktasında gelen trafiğe izin vermesi gerekir. Dağıtım iki ayrı yük dengeleyici çalıştırır: biri olay alımı (mTLS korumalı) için ve biri pano için:| Trafik | Kaynak | Hedef | Güvenlik |
|---|---|---|---|
| Olay alımı | Kümelerinizde bulunan Collector podları | Ingest LoadBalancer, 443 numaralı bağlantı noktası | mTLS (istemci sertifikası) + API anahtarı |
| Pano | Geliştirici tarayıcıları | Dashboard LoadBalancer, 443 numaralı bağlantı noktası | Etki alanınızda HTTPS, şifresiz e-posta OTP oturum açması |
agenteye.your-company.example) — Exosphere tarafından sağlanan yük dengeleyici ana bilgisayar adlarına işaret ederek. Exosphere daha sonra otomatik olarak her iki ana bilgisayar adı için de genel olarak güvenilir TLS sertifikaları sağlar; yenilemeler de dahildir.
80 numaralı bağlantı noktası notu: otomatik sertifika verme ve yenileme, her yük dengeleyicinin 80 numaralı bağlantı noktasında HTTP üzerinde doğrulama yapar. Güvenlik politikanız pano yük dengeleyicisini kurumsal IP aralıklarına kısıtlamayı gerektiriyorsa, önce Exosphere’e söyleyin — sertifika doğrulamayı DNS tabanlı bir yönteme geçiririz (sizin tarafınızda bir ek DNS kaydı), böylece yenilemeler kısıtlama arkasında çalışmaya devam eder.
Giden trafik: Küme düğümleri, konteyner görüntülerinighcr.ioadresinden çekmek için İnternet erişimine ihtiyaç duyar. Ağınız giden trafiği kısıtlıyorsa,ghcr.ioadresini beyaz listeye alın veya görüntüleri iç kayıt defterinize yansıtın.
Adım 4: Bir Yedekleme Depolama Demeti Sağlayın
Veritabanı yedekleri, sahip olduğunuz bir bulut depolama demetinde saklanır.| Gereksinim | Detaylar |
|---|---|
| Hizmet | S3 (AWS), GCS (GCP) veya Azure Blob Storage |
| Erişim | IAM rolü aracılığıyla hizmet hesaplarına küme düğümlerinin yazma erişimini verin (EKS’de IRSA, GKE’de Workload Identity) veya kimlik bilgileri sağlayın |
| Bekletme | Demetin yaşam döngüsü politikasını kontrol edersiniz (bekletme süresi, arşivleme kuralları). Exosphere yedekleri yazar; ne kadar süre tutacağınızı siz karar verirsiniz |
Adım 5: İletişim Kişisini Belirleyin
Küme düzeyindeki sorunlar için kendi tarafınızdan bir kişi veya Slack/Teams kanalı sağlayın: düğüm durumu, bulut hesabı sınırları, ağ değişiklikleri. Günlük işlemler bu iletişim kişisini içermez.Dağıtılanlar
Exosphere’in küme erişimi olduktan sonra, aşağıdaki bileşenler sizin için dağıtılır ve yönetilir:| Bileşen | Rol |
|---|---|
| AgentEye Server | Toplayıcılardan olayları alan, analiz çalıştıran ve verileri panoya sunan HTTP API’si |
| Pano | Ajan oturumlarını, araç çağrılarını, model isteklerini ve hataları görüntülemek için web arayüzü; isteğe bağlı salt okunur yapay zeka asistanını barındırır |
| ClickHouse | Alınan olaylar, analiz ve değerlendirmeler için gerekli kanonik depo |
| PostgreSQL | Kuruluşlar, API anahtarları, kullanıcılar, panolar ve kaydedilmiş sorgular için ilişkisel depo |
| Redis | İsteğe bağlı paylaşılan önbellek ve hız sınırlama arka ucu; kullanılamıyorsa platform düzgün bir şekilde bozulur |
| Yapay zeka asistanı (isteğe bağlı) | İç salt okunur asistan konteyner; bir LLM uç noktası yapılandırılıncaya kadar devre dışı kalır |
| Giriş kontrolörleri | İki yük dengeleyici (biri mTLS korumalı alım için, biri pano için) genel olarak güvenilir, otomatik olarak yenilenen sertifikalar ile TLS sonlandırarak ve alım uç noktasında mTLS’i uygulayan |
| cert-manager | TLS sertifika sağlamayı ve mTLS istemci sertifika vermeyi otomatikleştirir |
| Sertifika izleme | Planlı bir iş sertifika süresini kontrol eder ve sertifikalar yenilemeye yaklaştığında uyarılar gönderir (örneğin Slack’e) |
Siz Ne Alırsınız
Dağıtım tamamlandıktan sonra şunları alırsınız:| Öğe | Detaylar |
|---|---|
| Pano URL’si | Etki alanınız altında bir ana bilgisayar adı (örneğin https://agenteye.your-company.example), genel olarak güvenilir, otomatik olarak yenilenen bir TLS sertifikası ile sunulan. Sağladığımız yük dengeleyici ana bilgisayar adına bir CNAME oluşturursunuz; oturum açma şifresiz e-posta OTP’dir |
| Toplayıcı uç noktası | Alım ana bilgisayar adının /events yolu (örneğin https://ingest.your-company.example/events), mTLS korumalı |
| İstemci sertifika paketi | Küme başına: istemci sert, özel anahtar ve CA sert bir Kubernetes Secret manifestinde sunulan. Küme başına bir kere uygulayın |
| GitHub PAT | Toplayıcı ikili dosyalarını ve Python SDK paketlerini indirmek için |
| Toplayıcı API anahtarları | events:add izni ile kapsamlı anahtarlar, her toplayıcı dağıtımı için birer tane |
| Kurulum kılavuzları | Toplayıcı ve Python SDK için adım adım belgeler |
Kurulumdan Sonra Yapacaklarınız
Tek devam eden iş, AgentEye kümesi değil, kendi ajan makinelerinizde:- Toplayıcıyı yükleyin AI ajanlarının çalıştırıldığı her Kubernetes kümesinde: istemci sertifikasını monte edin ve uç nokta URL’sini ve API anahtarını yapılandırın. Bkz. enterprise-docs/collector-installation.md.
- Python SDK’yı entegre edin ajan kodunuza. Bkz. enterprise-docs/python-sdk.md.
- Tarayıcıda panolu açın ajan aktivitesini görüntülemek için.
Güvenlik
- Veriler bulut hesabınızda kalır. Küme, depolama ve veritabanları tümü ortamınızda çalışır. Hiç veri sınırınızı terk etmez.
- Siz erişimi kontrol edersiniz. Küme hesabınızdadır. Exosphere’in erişimini dilediğiniz zaman denetleyebilir, izleyebilir veya iptal edebilirsiniz. Tüm işlemler bulutunuzun denetim günlüğüne gider (CloudTrail, GCP Audit Logs, vb.).
- Olay alımında mTLS. Her toplayıcı isteği geçerli bir istemci sertifikası ve bir API anahtarı gerektirir. Sızan bir anahtar sert olmadan işe yaramaz; çalıntı bir sert geçerli bir anahtar olmadan işe yaramaz.
- Pano erişim denetimi. Pano kendi yük dengeleyicisinde çalışır, olay alımından ayrı olarak çalışır ve oturum açma, izin verilenler listenize alınan e-posta adreslerine/alanlara kısıtlanmış şifresiz e-posta OTP’dir. Yük dengeleyicide bir IP kaynak aralığı beyaz listesi istekte mevcuttur; otomatik sertifika yenileme yük dengeleyiciye ulaşması gerektiğinden, Exosphere kısıtlamayı DNS tabanlı sertifika doğrulaması ile eşleştirir, böylece yenilemeler çalışmaya devam eder.
- Küme başına sertifikalar. Kümelerinizin her biri kendi istemci sertifikasını alır. Bir küme tehlikeye atılırsa, o sertifika bağımsız olarak iptal edilir, diğerleri etkilenmez.
Dağıtım Zaman Çizelgesi
| Aşama | Süre | Katılımınız |
|---|---|---|
| Küme sağlama | 1-2 gün | Kümeyi sağlayın ve Exosphere’e erişim verin |
| Platform kurulumu | 1 gün | Yok; Exosphere tüm altyapı bileşenlerini kurar |
| Uygulama dağıtımı | 1 gün | Yok; Exosphere sunucu, pano dağıtır ve API anahtarları oluşturur |
| Toplayıcı dağıtımı | 1-3 gün | Kümelerinizde toplayıcıları yükleyin (Exosphere’den rehberlik ile) |
| Üretim çalışması | 1 hafta | Yok; Exosphere izler ve ayarlar |
Destek
Sorular veya sorunlar için Exosphere’esupport@exosphere.host adresinden iletişim kurun.
Sonraki Adımlar
- Başlangıç: uçtan uca anlatım
- Toplayıcı Kurulumu: toplayıcıyı yükleyin ve yapılandırın
- Python SDK: ajan kodunuzu enstrüman edin
- API Anahtarları: erişim ve izinleri yönetin
- Sorun Giderme: yaygın sorunlar ve düzeltmeler