Kubby kullanım kılavuzu

Kubby, Windows için ücretsiz bir masaüstü Kubernetes yönetim uygulamasıdır. Bu kılavuz Kubby 1.0'ı anlatır. Her bölüm önce bir ekran görüntüsü, ardından adımları gösterir.

English

Uygulamadaki ekran, menü ve düğme adları uygulamada göründüğü gibi İngilizce yazılmıştır.

İçindekiler

1. Başlarken
   • 1.1 Giriş
   • 1.2 Kurulum ve ilk açılış
   • 1.3 Cluster ekleme
   • 1.4 Arayüz
2. Günlük kullanım
   • 2.1 Overview ve sorunlar
   • 2.2 Cluster sağlık puanı
   • 2.3 Kaynak listeleri ve ayrıntılar
   • 2.4 Loglar ve event'ler
   • 2.5 Logs sayfası
   • 2.6 Terminal, shell ve port yönlendirme
   • 2.7 Komut paleti ve kısayollar
3. Değişiklik yapma
   • 3.1 YAML düzenleme ve kaynak oluşturma
   • 3.2 Aksiyonlar ve PROD koruması
   • 3.3 Helm
   • 3.4 Audit log
4. Entegrasyonlar
   • 4.1 Monitoring
   • 4.2 Log depoları ve geçmiş
   • 4.3 Log ve metrik kurulumu
   • 4.4 Argo CD
   • 4.5 Ask Kubby
5. Sorun giderme rehberleri
   • 5.1 CrashLoopBackOff
   • 5.2 OOMKilled
   • 5.3 ImagePullBackOff
   • 5.4 Pending durumundaki pod'lar
   • 5.5 Sertifika süresinin dolması
6. Hesap ve ayarlar
   • 6.1 Bildirimler
   • 6.2 Notlar
   • 6.3 Hesap ve güvenlik
   • 6.4 Preferences
7. Güncellemeler ve yardım
   • 7.1 Güncellemeler
   • 7.2 Kubby sorunlarını giderme

Bu kılavuzdaki komutlar hakkında

Her komut bloğunda nerede çalıştırılacağı yazar: PowerShell veya WSL bash. kubectl komutları, açık cluster'a bağlı olan Kubby terminalinde de çalışır. <pod>, <ns> gibi yer tutucuları kendi değerlerinizle değiştirin.

1. Başlarken

1.1 Giriş

Kubby bilgisayarınızda çalışır ve cluster'larınıza kubeconfig dosyalarınızla doğrudan bağlanır. Cluster'a hiçbir şey kurulmaz, cluster verileri hiçbir sunucuya gönderilmez.

• Kubby, Kubernetes API'nin hesabınıza izin verdiği işlemleri yapar; fazlasını yapamaz.
• Listeler canlı güncellenir (Kubernetes watch API). Yenilemeniz gerekmez.

Hızlı başlangıç:

1. Kubby'yi kurun (1.2).
2. Yerel Kubby hesabınızı oluşturun.
3. Bir cluster ekleyin (1.3).
4. Overview sayfasını açın: ilgilenilmesi gerekenler en üsttedir.

1.2 Kurulum ve ilk açılış

Kubby ücretsizdir. kubby.tech indirme sayfasındaki tek bir kurulum dosyasıyla (Kubby_<sürüm>_x64-setup.exe) gelir ve yönetici yetkisi istemeden kurulur. Sihirbaz İngilizcedir; Türkçe Windows'ta Türkçe açılır.

Kurulum

1. Kurulum dosyasını çalıştırın. Windows Windows protected your PC uyarısı gösterirse (dosya henüz kod imzalı değil) More info bağlantısına tıklayın, dosyanın Kubby kurulumu olduğunu kontrol edin ve Run anyway düğmesine basın. Kurum politikası imzasız kurulumları engelliyorsa BT ekibinden dosyaya SHA-256 özetiyle izin vermesini isteyin (özet indirme sayfasındadır).
2. Kubby'nin kimin için kurulacağını seçin ve Next düğmesine basın:
   • Only for me (varsayılan): %LOCALAPPDATA%\Programs\Kubby klasörüne, yönetici yetkisi olmadan.
   • Anyone who uses this computer (all users): C:\Program Files\Kubby klasörüne. Windows yönetici izni ister; vermezseniz Only for me seçeneğine dönün.
3. Kubby zaten kuruluysa Already Installed sayfası önce kaldırmayı mı yoksa üzerine kurmayı mı istediğinizi sorar. Kubby mevcut klasörünü korur.

4. Klasörü olduğu gibi bırakın veya Browse… ile değiştirin, ardından Install düğmesine basın.

5. İsterseniz Run Kubby ve Create desktop shortcut seçili kalsın, ardından Finish düğmesine basın.

Kaldırmak için: Windows Ayarlar → Uygulamalar → Yüklü uygulamalar → Kubby → … → Kaldır. Tüm kullanıcılar için yapılmış bir kurulumun kaldırılması yönetici izni ister.

Açma ve kapatma

• Pencereyi × ile kapatmak Kubby'yi kapatmaz; Lens'te olduğu gibi saatin yanındaki bildirim alanında çalışmaya devam eder. Simgesine tıklayınca Kubby yeniden açılır.
• Tamamen çıkmak için File → Exit menüsünü kullanın veya simgeye sağ tıklayıp Quit Kubby'yi seçin.
• Kubby'nin Windows oturumu açılınca başlaması için: Preferences → App → Start-up.

İlk açılış: hesap oluşturma

1. Create your Kubby account: First name, Last name, User name, Password ve Password again alanlarını doldurun.
2. Scan with your authenticator app: QR kodunu Microsoft Authenticator, Google Authenticator veya benzeri bir uygulamayla okutun (kaydın adı Kubby olur), ardından 6 haneli kodu Code from the app alanına yazın.
3. Save your recovery codes: telefonunuzu kaybederseniz kullanacağınız 10 tek kullanımlık kod. Güvenli bir yerde saklayın.

Bir oturum 8 saat geçerlidir. Sonraki adım: ilk cluster'ınızı ekleyin.

1.3 Cluster ekleme

Kubby cluster'lara kubeconfig dosyalarıyla bağlanır. Eklenen her context, %APPDATA%\Kubby\kubeconfigs klasörüne düz bir kubeconfig dosyası olarak kaydedilir (Lens'teki gibi); token ve parolalar loglara asla yazılmaz.

1. Cluster çubuğundaki + düğmesine, File → Add cluster… menüsüne veya Clusters sayfasındaki Add cluster düğmesine tıklayın.
2. Kubeconfig'i yapıştırın ya da Choose file… / Scan .kube folders kullanın. Birden fazla context varsa eklenecekleri seçin.
3. Test sonucunu kontrol edin: Kubernetes sürümü ve node sayısı (Test again testi tekrarlar).
4. Display name, isteğe bağlı Default namespace, Environment ve isteğe bağlı Group alanlarını doldurun.
5. İsteğe bağlı: Confirm every change (apply, delete, drain öncesinde cluster adı yazılır) ve Open read-only (kilit açılana kadar düzenleme ve exec gizlenir).
6. Add cluster düğmesine basın.

Cluster eklemenin başka yolları:

• Clusters sayfasındaki Import from folder, bir klasördeki tüm kubeconfig dosyalarını içe aktarır.
• Preferences → Kubernetes → Manage kubeconfigs, dosya ve klasörleri sürekli eşitler.

Ortamlar: her cluster bir ortama aittir (PROD, PREPROD, TEST veya kendi tanımladığınız bir ortam). Ortamın rengi pencerenin üstündeki şeritte, cluster çubuğunda ve etiketlerde görünür. Korumalı ortamlarda (varsayılan olarak PROD) her değişiklik cluster adının yazılmasıyla onaylanır (3.2). Yeni ortam: Preferences → Cluster bar → Environments → New environment.

Cluster çubuğu ve gruplar

• Cluster çubuğunda neyin görüneceğini kutucukların üstündeki düğmeden seçin.
• Kutucukları sürükleyerek sıralayın veya gruplayın. Rengini ve görünümünü değiştirmek için kutucuğa sağ tıklayın.
• Kutucuktaki kırmızı sayı, o cluster'daki sorun sayısıdır.

1.4 Arayüz

Pencere beş bölümden oluşur. Sayfalar sekme olarak açılır; tıkladığınız kaynak sağdaki ayrıntı panelinde açılır (Esc ile kapanır).

Tema: Kubby koyu temayla açılır. View → Theme veya Preferences → App ile açık temaya ya da Windows ayarını izleyen System seçeneğine geçebilirsiniz.

2. Günlük kullanım

2.1 Overview ve sorunlar

Overview, açık cluster'ı özetler: node'lar, pod'lar, CPU ve bellek, sağlık kartı (2.2) ve Needs attention listesi.

• Kubby şunları tanır: CrashLoopBackOff, ImagePullBackOff, OOMKilled, yerleştirilemeyen pod'lar (Pending, Unschedulable), başarısız Job'lar, hazır olmayan workload'lar ve Secret'lardaki süresi yakında dolacak veya dolmuş TLS sertifikaları.
• Kaynağı açmak için satıra tıklayın. Problem pods, pod listesini sorunlarla açar.
• Sağ üstteki namespace seçiciyle bir veya birden fazla namespace seçin. Seçim cluster bazında hatırlanır.

Yeniden başlayan bir pod'da Why is it restarting? son çıkış kodunu ve nedenini, OOMKilled durumunda bellek limitini ve görülen en yüksek kullanımı, yeniden başlatma örüntüsünü ve Logs before crash bağlantısını gösterir.

2.2 Cluster sağlık puanı

Her cluster A'dan F'ye bir not ve 100 üzerinden bir puan alır. Overview üzerindeki Cluster health kartı bunu gösterir.

• Not: 90 ve üzeri A, 80 ve üzeri B, 70 ve üzeri C, 60 ve üzeri D, 50 ve üzeri E, altı F.
• Last 30 days: Kubby, cluster'ı izlediği sürece puanı saatte bir kaydeder.
• By area: workloads, pods, nodes, network, storage, security alanları; her biri için kritik ve uyarı sayıları.
• Fix first: puanı en çok düşüren beş bulgu grubu. All N findings, Cluster health sayfasını açar.

Her bulguda Open ve Accept… bulunur. Accept…, bulguyu nesne, namespace'i veya tüm cluster için puan dışında bırakır. Gerekçe zorunlu, bitiş tarihi isteğe bağlıdır; kabul etme ve geri alma audit log'a yazılır.

Puanın hesaplanması: her nesne her alanda bir kez, en kötü bulgusuyla sayılır (kritik 0, uyarı 0,6, bulgusuz 1). Alan ağırlıkları: workloads 25, pods 25, nodes 15, network 15, storage 10, security 10. Nesnesi olmayan alanlar hesaba katılmaz; okuma yetkiniz olmayan alan Not checked olarak görünür.

Preferences → Cluster health ayarları: hariç tutulan namespace'ler (varsayılan: kube-system, kube-public, kube-node-lease, cattle-*, fleet-*, cis-operator-system, local-path-storage; sondaki * önek eşleşmesi yapar) ve izin verilen registry'ler, örneğin harbor.bank.local (boşsa hepsine izin verilir).

2.3 Kaynak listeleri ve ayrıntılar

Navigator'da bir kaynak türü seçin; Kubby canlı listesini açar. Ayrıntılar için bir satıra tıklayın; sağda açılır.

• Sorunlu kaynaklar Needs attention altında en üstte kalır. Pods için hızlı filtreler: All, Needs attention, Restarted in 24h, Pending, Completed.
• Arama (büyük/küçük harf, düzenli ifade), sütun başlığıyla sıralama, başlık kenarını veya başlığı sürükleme, sütun düğmesiyle sütun ekleme ve kaldırma. Seçimleriniz hatırlanır.
• Toplu işlem için satır onay kutularını kullanın. Listeyi CSV olarak dışa aktarın.
• Ayrıntı sekmeleri: Overview (özellikler, durumlar, metrikler), Edit YAML, Describe, Events, Related ve türe göre Logs veya Rollout history. Üstteki simge araç çubuğunda aksiyonlar bulunur.
• Metrikler (metrics-server varsa): son bir saatin CPU ve bellek grafiği, request ve limit çizgileriyle.
• Related: sahipler ve bağımlılıklar, örneğin Deployment → ReplicaSet → Pod, Ingress → Service. Ingress adresi tarayıcıda açılır.
• Custom Resources: cluster'daki tüm CRD'ler gruplarına göre; yerleşik türler gibi listelenir ve düzenlenir.

2.4 Loglar ve event'ler

Bir pod'un Logs sekmesi logları canlı veya önceki (çöken) çalışmadan gösterir.

• Container: çok container'lı pod'larda seçin.
• Current run / Previous run: son satırdan sonra Kubby container'ın nasıl sonlandığını gösterir (örneğin OOMKilled, çıkış kodu 137).
• Restart history zaman çizelgesinde; sayaçlı arama ("3/12"); ERROR, WARN, INFO, DEBUG seviye filtreleri.
• Zaman aralığı ve satır sayısı (örneğin Last 10,000 lines); saatler sizin saat diliminizde; kopyalama veya indirme.
• Workload logları: bir Deployment veya StatefulSet'in tüm pod'ları tek akışta, her satır pod adıyla işaretli.
• Event'ler: Events sayfası cluster'ın event'lerini önce Warning'ler olmak üzere listeler. Her kaynağın kendi Events sekmesi de vardır.
• Describe: arama ve kopyalama destekli kubectl describe çıktısı (5.1 bir örneğini gösterir).

2.5 Logs sayfası

Logs sayfası seçtiğiniz tüm pod ve container'ların loglarını tek bir canlı zaman çizelgesinde birleştirir; satırlar arasında pod başlatma, sonlandırma ve event'ler de görünür.

1. Navigator'da Logs'u açın (veya bir workload'un sağ tık menüsünden, Logs aksiyonundan ya da paletten).
2. Add source düğmesine tıklayın: bir workload (Deployment, StatefulSet, DaemonSet, CronJob), app.kubernetes.io/part-of=gateway gibi bir label seçici, bir namespace veya bir pod.
3. Kartları kullanın: Log volume (o dakikayı okumak için çubuğa tıklayın), Levels (filtrelemek için), Pods (birini gizlemek için), Restarts (Jump ile çökmeye gidin).
4. Filtreleyin: Search (düzenli ifade için .*), Exclude (örneğin /health), Lifecycle and events. Node'larınız farklıysa node, zone ve mimari filtreleri görünür.
5. Download, gösterilen satırları filtrelerinizle kaydeder.

• Jump, çökmeden beş dakika öncesinden bir dakika sonrasına kadar olan aralığı gösterir, takibi duraklatır ve çöken çalışmanın satırlarını "(previous)" işaretiyle ekler.
• Zaman aralığı: Last 5 min ile Last 24 h arası veya özel aralık. Yukarı kaydırmak takibi duraklatır; en alta inmek yeniden başlatır.
• Yeni pod'lar sayfa yenilenmeden eklenir; silinen pod'un satırları kalır. İki kaynağın seçtiği pod bir kez okunur.
• Sınırlar: 40 akış ve en yeni 10.000 satır. Kaynaklar kısıldığında durum satırı bunu belirtir.

2.6 Terminal, shell ve port yönlendirme

Alt paneldeki terminaller seçili cluster'a bağlı açılır; pod ve node shell'leri kendi sayfalarından açılır.

• Cluster terminali: Ctrl + ` alt paneli açar veya gizler (1.4 bir örneğini gösterir). Profiller: cmd, PowerShell ve WSL dağıtımlarınız (varsayılan Preferences → Terminal altında). kubectl ve helm seçili cluster'a gider; Kubby ile gelen sürümler PATH'tedir.
• Pod shell: pod sayfasındaki Shell düğmesi veya paletteki Ctrl + E.
• Node shell: node sayfasından. Kubby node üzerinde geçici, ayrıcalıklı bir pod çalıştırır ve shell'i kapattığınızda siler.
• Port forward: pod sayfasındaki Port forward düğmesi, bir pod portunu Kubby açık kaldığı sürece bilgisayarınıza yönlendirir.

2.7 Komut paleti ve kısayollar

Ctrl + K paleti açar. Kaynaklar, sayfalar ve aksiyonlar birlikte aranır; son açılan sayfalar üstte durur, açık cluster'da sonuç yoksa palet diğer cluster'larda aramayı önerir.

1. Ctrl + K'ye basın ve bir ad yazın.
2. Yalnızca komutları listelemek için önce > yazın.
3. Seçili satırın aksiyonları (loglar, shell, describe…) için Tab'a basın.

3. Değişiklik yapma

3.1 YAML düzenleme ve kaynak oluşturma

Kubby YAML'ı doğrular, farkı gösterir ve ancak ondan sonra uygular.

1. Kaynak sayfasında Edit YAML sekmesini açın. Düzenleyici siz yazarken renklendirir ve doğrular.
2. Değişikliğinizi yapın. Review before apply neyin değişeceğini gösterir.
3. Uygulayın. Kubby değişikliği sunucuda doğrular ve çakışmaları bildirir.

• Argo CD kaynakları: bir sonraki sync doğrudan düzenlemeyi geri alabilir; Copy as Git patch değişikliği Git'e taşır. Helm workload'ları: değişiklik Helm üzerinden önerilir.
• Ctrl + F kod görünümlerinde arar; düzenleyicilerde değiştirme satırı da açılır.

Kaynak oluşturmak için:

1. Liste sayfasında + düğmesine tıklayın. Oluşturma düzenleyicisi alt panelde açılır.
2. Select template: temel türler (Pod, Deployment, Service, Ingress, ConfigMap, Secret…), Gateway API, Traefik ve Istio.
3. Düzenleyip oluşturun. Kubby önce sunucu tarafında dry-run çalıştırır; hatalar düzenleyicinin altında görünür.

3.2 Aksiyonlar ve PROD koruması

Aksiyonlar kaynak sayfasının araç çubuğunda ve listelerin sağ tık menüsündedir. Korumalı bir cluster'da her değişiklik cluster adının yazılmasını bekler.

• PROD koruması: korumalı bir ortamda veya Confirm every change açıkken onay için cluster adını yazarsınız.
• Salt okunur: Open read-only açıksa değişiklik yapan tüm aksiyonlar kapalıdır ve Secret değerleri düzenlenemez.
• Sıfıra ölçekleme: Kubby önceki replica sayısını hatırlar ve tekrar ölçeklerken önerir.
• Her değişiklik (uygulanan, reddedilen veya çakışan) audit log'a yazılır (3.4).

3.3 Helm

Helm → Releases release'leri namespace, chart, sürüm, durum ve son güncelleme bilgisiyle listeler; daha yeni bir chart varsa bir rozet görünür.

• Ayrıntılar: kullanıcının verdiği ve hesaplanan values, revizyon geçmişi, release'in kaynakları ve sağlıkları, README.
• İki revizyonu karşılaştırın; values'u kaydedin (secret'lar maskelenir).

Upgrade veya rollback için:

1. Release menüsünden Upgrade'i seçin. Values'u düzenleyin veya başka bir chart sürümü seçin.
2. Dry-run sonucunu kontrol edin.
3. Onaylayın. Geri dönmek için Roll back ile geçmişten bir revizyon seçin.

Helm → Charts içinden bir chart seçip values'unuzla kurun. Depoları Preferences → Kubernetes → Helm repositories altında ekleyin. Helm işlemleri de PROD korumasına tabidir ve audit log'a yazılır.

3.4 Audit log

Kubby'den yapılan her değişiklik kullanıcı, cluster, işlem, kaynak ve sonuçla kaydedilir. Tools → Audit log ile açın.

• Kaydedilenler: YAML uygulama, ölçekleme, yeniden başlatma, silme, cordon ve drain; Helm upgrade, rollback ve uninstall; Argo CD işlemleri; Secret değerlerinin gösterilmesi; kabul edilen sağlık bulguları; kurulum asistanının yaptığı kurulumlar.
• Her kaydın sonucu: applied, forbidden, conflict veya read. Reddedilen işlemler de kaydedilir.
• Kullanıcı, işlem veya kaynağa göre arayın; cluster ve sonuca göre filtreleyin.
• Log bilgisayarınızda kalır; Secret değerleri ve kimlik bilgileri asla yazılmaz. Gönderim ayarları: Preferences → Audit log.

4. Entegrasyonlar

4.1 Monitoring

Monitoring, cluster'ın kendi Prometheus'undan (Rancher Monitoring, kube-prometheus-stack veya prometheus chart'ı) hazır panolar gösterir. Kubby ona Kubernetes API üzerinden ulaşır; port forward, ingress veya token gerekmez.

1. Navigator'da Monitoring'i açın. Birden fazla Prometheus varsa sağ üstten seçin (cluster bazında hatırlanır).
2. Zaman aralığını (5 dakika ile 24 saat arası) ve otomatik yenilemeyi (30 sn, 1 veya 5 dk) seçin ya da Refresh'e basın.
3. Grafiklerini açmak için bir çubuk listesindeki namespace veya pod'a tıklayın.

Prometheus servisi için services/proxy üzerinde get yetkiniz olmalıdır; yoksa Kubby bunu belirtir.

4.2 Log depoları ve geçmiş

Logs sayfasındaki History, geçmiş logları Loki, Elasticsearch veya OpenSearch'ten okur; artık var olmayan pod'lar dahil.

1. Logs sayfasında Live'dan History'ye geçin. Kaynaklarınız düzenleyebileceğiniz bir sorguya (LogQL veya Lucene) dönüşür.
2. Aralığı seçin (1 saat ile 30 gün arası veya özel); daraltmak için hacim grafiğindeki bir çubuğa tıklayın.
3. İsteğe bağlı: depo topluyorsa Node logs: kubelet, containerd.

• Kubernetes çöken bir çalışmayı artık tutmuyorsa Read it from the log store, History'yi çökme anının etrafında açar.
• Cluster içindeki depolar Kubernetes API üzerinden, sizin yetkilerinizle bulunur ve okunur. Elasticsearch ve OpenSearch için index, TLS ve kimlik bilgilerini Preferences → Monitoring and logs altında ayarlayıp Test'e basın.
• Merkezi depolar: tüm cluster'lara hizmet veren tek depo; her cluster için https adresi, index ve cluster etiketiyle (örneğin cluster=prod-app) eklenir. Metrikler de merkezi bir Prometheus, Thanos, Mimir veya VictoriaMetrics'ten okunabilir.
• Kimlik bilgileri: Kubby bir depo için parola, anahtar veya token saklamaz. Bunu bir Kubernetes Secret'ına koyun; Kubby yalnızca namespace, ad ve anahtar adını tutar.

WSL bash:

kubectl -n kubby-system create secret generic kubby-os-reader \
  --from-literal=username=kubby-reader --from-literal=password='<parola>'

Henüz depo yok mu? History Set up logs ve Use a central store seçeneklerini sunar (4.3).

4.3 Log ve metrik kurulumu

Kubby'nin cluster'larınızda hiçbir şeye ihtiyacı yoktur; ama maliyetini gösterdikten sonra bir log deposu (Loki ve Grafana Alloy, kubby-loki namespace'inde) veya küçük bir Prometheus kurabilir. Install'a basana kadar hiçbir şey değişmez.

1. Set up logs (Overview'da veya Logs History'de) ya da Set up monitoring (Monitoring'de) düğmesine tıklayın.
2. Seçimler: depolama (PVC veya S3), Keep for 1, 3, 7 veya 14 gün, image'lar internetten veya kendi registry'nizden (örneğin harbor.bank.local/mirror), chart'lar açık depolardan veya kendi aynanızdan.
3. Maliyet ve kontrol: Kubby log hızını yaklaşık bir dakika ölçer; ardından request'leri, önerilen disk boyutunu, yetkilerinizi, image'ları ve values'u gösterir. Copy the commands aynı kurulumu platform ekibinize verir.
4. Install: Helm kurar, Kubby pod'ları bekler. PROD'da önce cluster adını yazarsınız; kurulum audit log'a yazılır.

Preferences → Monitoring and logs → Installed by Kubby bu kurulumları listeler. Change günceller; Remove kaldırır (namespace'i ve diskleri de silmeyi seçmezseniz diskler kalır).

4.4 Argo CD

Argo CD merkezi (cluster çubuğundaki Argo CD simgesi) bir veya daha fazla Argo CD'ye bağlanır.

1. Cluster çubuğundaki Argo CD simgesine, ardından Add instance'a tıklayın.
2. Bir ad, adres ve ortam girin, bir API token'ı yapıştırın. Argo CD özel bir sertifika kullanıyorsa CA sertifikasını ekleyin.
3. Test connection sürümü, kullanıcıyı ve yetkilerinizi gösterir. Instance'ı ekleyin.

Token Windows Credential Manager'da saklanır; ayar dosyalarına ve loglara asla yazılmaz.

• Uygulama sayfası: özet, kaynak ağacı (grafik veya liste), Git ile cluster arasındaki fark, geçmiş ve rollback, event'ler ve loglar.
• Teşhis: Degraded bir uygulamada veya başarısız bir sync'te Kubby nedeni gösterir. Açmak için kaynağa tıklayın.
• İşlemler: sync, refresh, Hard refresh, rollback, çalışan işlemi durdurma, auto-sync açma veya kapatma. Bir işlemi engelleyen sync window'ları gösterilir. PROD instance'larında instance adını yazarsınız.

4.5 Ask Kubby

Ask Kubby, yapay zekâ destekli bir sorun giderme asistanıdır. Canlı cluster'ı Kubby'nin salt okunur araçlarıyla, seçtiğiniz yapay zekâ modeli üzerinden okur. Siz açana kadar kapalıdır.

Açmak için:

1. Preferences → External Tools bölümünü açın.
2. Bir bağlantı ekleyin: Subscription (kendi aboneliğinizle kurulu Claude Code, Codex CLI veya Gemini CLI) ya da API connection (Add model: OpenAI, Anthropic, Google Gemini, xAI veya kurumunuzun OpenAI uyumlu gateway'i; anahtarlar Windows Credential Manager'a gider).
3. Varsayılan bağlantıyı seçin ve Enable Ask Kubby'yi açın. Kapalıyken Kubby hiçbir yapay zekâ aracını başlatmaz ve hiçbir şey göndermez.

Soru sormak için:

1. Bir sayfadaki veya ayrıntı panelindeki Ask Kubby düğmesine tıklayın. Sohbet bağlamınızla (cluster, namespace, kaynak) başlar.
2. Sorunuzu yazın, örneğin "web-7c9d8f6b5-0009 pod'u neden sürekli yeniden başlıyor?" veya "En büyük node düşerse workload'lar kalan node'lara sığar mı?".

• Değişiklikler asla doğrudan uygulanmaz: Kubby önizleme gösterir, onayınızı bekler ve işlemi audit log'a yazar. Argo CD kaynaklarında Kubby değişikliği Git'te yapmanızı hatırlatır; Helm workload'larında değişiklik Helm upgrade ile yapılır.
• Yalnızca Kubernetes, container, Helm ve DevOps soruları yanıtlanır. Konu dışı sorular modele hiç ulaşmaz.

Kurum politikanız gerektiriyorsa kurumunuzun onayladığı yapay zekâ gateway'ini kullanın.

5. Sorun giderme rehberleri

5.1 CrashLoopBackOff

Container başlar, kapanır; Kubernetes her seferinde yeniden başlatmadan önce daha uzun bekler (10 sn, 20 sn, 40 sn … en fazla 5 dakika). Neden; çıkış kodunda, önceki çalışmanın loglarında ve event'lerdedir.

Kubby'de: sürekli çöken pod'lar Overview ve Pods sayfalarında en üsttedir; Why is it restarting? çıkış kodunu, nedeni ve örüntüyü gösterir; Logs before crash önceki çalışmayı açar.

Komut satırından (PowerShell veya WSL bash):

kubectl describe pod <pod> -n <ns>
kubectl logs <pod> -n <ns> -c <container> --previous
kubectl get events -n <ns> --field-selector involvedObject.name=<pod>

Sık nedenler: eksik yapılandırma; fazla katı bir liveness probe (startupProbe ekleyin veya initialDelaySeconds / failureThreshold değerini artırın); hazır olmayan bir bağımlılık; yetersiz bellek; yanlış komut veya image.

5.2 OOMKilled

Çekirdek, container bellek limitini aştığı (çıkış kodu 137) veya node'un belleği bittiği için (MemoryPressure; request'inden fazla kullanan pod'lar önce sonlandırılır) container'ı durdurmuştur.

Kubby'de: Overview OOMKilled pod'ları limitle birlikte listeler; Why is it restarting? limiti ve en yüksek kullanımı gösterir; bellek grafiği limit çizgisini çizer. Monitoring → Capacity bellek limiti olmayan container'ları listeler.

Doğrulayın (PowerShell veya WSL bash; kubectl top için metrics-server gerekir):

kubectl describe pod <pod> -n <ns>
kubectl top pod <pod> -n <ns> --containers
kubectl describe node <node>

Düzeltme:

1. Limiti bir gün veya bir haftalık en yüksek kullanıma %20–30 pay ekleyerek belirleyin; request'leri gerçek kullanıma yakın tutun.
2. Çalışma ortamlarını container'a göre ayarlayın: JVM -XX:MaxRAMPercentage, Node.js --max-old-space-size, worker sayıları.
3. Kullanım sonlandırılana kadar artıyorsa sızıntı arayın. Node'un belleği bitiyorsa kapasite ekleyin.
4. Argo CD veya Helm kullanıyorsanız limiti Git'te veya Helm values'ta değiştirin.

5.3 ImagePullBackOff

Kubelet image'ı çekemediği için pod hiç başlamaz. Neden event'lerdedir.

Kubby'de: ImagePullBackOff pod'ları image ve registry mesajıyla birlikte en üsttedir. Argo CD merkezinde Degraded bir uygulamanın teşhisi, image çekemeyen pod'u gösterir.

Mesajı bulun (PowerShell veya WSL bash):

kubectl describe pod <pod> -n <ns>
kubectl get pod <pod> -n <ns> -o jsonpath="{.spec.containers[*].image}"

Node üzerinde (WSL bash veya SSH oturumu): crictl pull <image>.

Önlemek için: image'ları digest veya değişmez tag'lerle sabitleyin, pull secret'larını ServiceAccount'ta tutun, hatalı tag'leri Git'te düzeltin.

5.4 Pending durumundaki pod'lar

Scheduler uygun bir node bulamıyordur veya pod'un ihtiyaç duyduğu bir şey hazır değildir. Scheduler pod'ları gerçek kullanıma değil request'lere göre yerleştirir: CPU kullanımı %40 olan bir cluster, request'lerin toplamı %100'e ulaştıysa yeni pod'ları reddedebilir.

Kubby'de: yerleştirilemeyen pod'lar Needs attention içinde scheduler mesajıyla Unschedulable olarak görünür; Pods listesinde Pending filtresi vardır.

Scheduler'ın mesajını okumak için (PowerShell veya WSL bash) kubectl describe pod <pod> -n <ns> çalıştırın ve FailedScheduling event'ine bakın.

5.5 Sertifika süresinin dolması

Üç grup önemlidir: control plane ve kubelet sertifikaları, uygulama TLS sertifikaları, webhook CA'ları.

Kubby'de: 30 gün içinde süresi dolacak veya dolmuş TLS Secret'ları Needs attention içinde görünür.

• RKE2 / k3s: sertifikalar 12 ay geçerlidir; bitişe 90 gün kala servis yeniden başlatılınca yenilenir. rke2 certificate rotate (server node'da) yenilemeyi zorlar.
• kubeadm: control plane node'unda kubeadm certs check-expiration ve kubeadm certs renew all.
• cert-manager (PowerShell veya WSL bash): kubectl get certificates -A READY durumunu gösterir; kubectl describe certificate <ad> -n <ns> yenileme zamanını ve son hatayı gösterir; nedeni düzelttikten sonra cmctl renew <sertifika> -n <ns> yeniler.
• Bir TLS Secret'ı (WSL bash):

``bash kubectl get secret <ad> -n <ns> -o jsonpath="{.data.tls\.crt}" | base64 -d | openssl x509 -noout -enddate ``

Kubelet istemci sertifikaları kendiliğinden yenilenir; sunum (serving) sertifikaları serverTLSBootstrap ve onaylanmış CSR'ler gerektirir. Prometheus alarmları: certmanager_certificate_expiration_timestamp_seconds - time() < 14 * 24 * 3600 ve kubelet_certificate_manager_client_ttl_seconds.

6. Hesap ve ayarlar

6.1 Bildirimler

Üst çubuktaki zil okunmamış haber ve alarmları gösterir (dokuzdan fazlaysa "9+"). Paneli açmak için tıklayın.

• Kategoriler: Security patch, Version upgrade ("running 1.12.1 → 1.12.2"), New feature. Zaten çalıştırdığınız sürümler gösterilmez.
• Bir öğe ekranda 2 saniye kalınca veya açılınca okunmuş sayılır; Mark all as read hepsini okunmuş yapar. Öğeye tıklamak makaleyi tarayıcıda açar.
• Kaynaklar: Preferences → News (kaynakları kapatın, kendi https RSS veya Atom akışlarınızı ekleyin, 1, 6 veya 24 saatte bir yenileyin).

6.2 Notlar

Kubby içinde, yalnızca bilgisayarınıza kaydedilen küçük bir not defteri.

1. Profil menüsünü (sağ üstte baş harfleriniz) açın → Notes.
2. + yeni bir not sekmesi açar; yeniden adlandırmak için sekmeye çift tıklayın.
3. Paneli Esc ile kapatın. Bir sekmeyi kapatmak onu ve metnini kalıcı olarak siler (Kubby önce sorar).

Notlar hiçbir yere gönderilmez ve loglara yazılmaz.

6.3 Hesap ve güvenlik

Kubby her Windows kullanıcısı için yerel bir hesap tutar: parolanız ve doğrulayıcı uygulamadaki 6 haneli kodla giriş yaparsınız.

• Bir oturum 8 saat geçerlidir. Art arda 5 hatalı denemeden sonra Kubby sizi bekletir; bekleme her seferinde uzar.
• Telefon kaybı: Use a recovery code seçeneğini seçin, parolanızı ve 10 kurtarma kodundan birini girin (her kod bir kez çalışır), ardından doğrulayıcıyı yeniden kurun.
• Parola ve kurtarma kodları yalnızca Argon2id özeti olarak saklanır; doğrulayıcı anahtarı ve oturum Windows Credential Manager'dadır.

Bilgisayarınızdan ne çıkar:

• Cluster verileri asla çıkmaz. Kubby yalnızca kubby.tech'e yeni sürüm olup olmadığını sorar ve sadece kendi sürüm numarasını gönderir. Telemetri yoktur.
• Kubeconfig'ler %APPDATA%\Kubby\kubeconfigs içinde düz dosyalardır; Argo CD token'ları ve yapay zekâ anahtarları Windows Credential Manager'dadır. Hiçbiri loglara yazılmaz.
• Uygulama logları günlük dosyalardır; yalnızca son 5 gün tutulur.

6.4 Preferences

Ctrl + , veya File → Preferences… ile açın. Ayarlar bilgisayarınıza kaydedilir; üstteki arama kutusu bir ayarı adıyla bulur.

7. Güncellemeler ve yardım

7.1 Güncellemeler

Kubby açılışta ve saatte bir kubby.tech'te yeni sürüm olup olmadığına bakar. Yeni sürüm varsa bir şerit Kubby <sürüm> is available. der.

1. Şeritteki See and install düğmesine veya Help → Check for Updates… menüsüne tıklayın.
2. Sürümü, tarihi ve notları okuyun.
3. Install and restart'a basın. Kubby güncellemeyi indirir, Kubby'nin imzası ve sağlama toplamıyla doğrular (eşleşmeyen dosya kurulmaz), kurar ve yeniden başlar.

İnternet yoksa Kubby normal çalışır; yalnızca yeni sürümleri göremez. Proxy arkasındaysanız Preferences → Proxy'yi ayarlayın. Sürümünüz profil menüsünde ve durum çubuğundadır.

7.2 Kubby sorunlarını giderme

Preferences → Data, Kubby'nin klasörlerini açar: veriler, kubeconfig'ler ve uygulama logları (son 5 gün, token veya parola içermez).

Destek: Kubby sürümünüzü (profil menüsü veya durum çubuğu), Windows sürümünüzü ve sorunu oluşturan adımları [email protected] adresine yazın. Uygulama logları Preferences → Data altındaki logs klasöründedir.