Sürüm yükseltme
Başlamadan önce
- Mevcut sürümünüzle yeni sürüm arasındaki her sürümün notlarını okuyun (Sürüm notları).
Sürüme özel adımlar aşağıda da var. Sürümünüzü öğrenmek için sol menünün altındaki GitHub
ikonunun üzerine gelin ya da pod'un ilk log satırına bakın (
"version":"…"). - Volume'ün yedeğini alın (Yedekleme ve geri yükleme). Yükseltmeden önceki
duruma birebir dönmenin tek yolu bu. 2.23.1'den itibaren OpenConsole, yeni bir sürüm veritabanını değiştirmeden
önce onu
/data/backups/app-<zaman>-pre-upgrade.db'ye de kopyalar, ama bu kopya aynı volume'dadır. - Deployment'ın
strategy: Recreatekullandığından emin olun (Kubernetes'e kurulum). Varsayılan rolling update'te yeni pod, eskisi hâlâ çalışırken veritabanını açar; 2.23.0'da bu, bir sonraki restart'a kadar yazılanların kaybolmasına yol açabilir.
Sürüm atlayabilirsiniz: 2.21.0'dan 2.22.0'a ya da 2.16'dan 2.22'ye geçiş tek adımdır. Her sürüm kendi veritabanı değişikliklerini beraberinde getirir ve açılışta eksik olanları uygular.
Yükseltme
kustomization.yaml dosyanızda sürümü iki yerde de değiştirin ve uygulayın:
resources:
- https://github.com/vurulkan/kubernetes-openconsole//deploy?ref=v2.23.4 # was v2.23.3
images:
- name: ghcr.io/vurulkan/kubernetes-openconsole
newTag: "2.23.4" # was 2.23.3
kubectl diff -k . # the image tag, plus whatever the release changed in deploy/
kubectl apply -k .
kubectl -n kubernetes-openconsole rollout status deploy/kubernetes-openconsole --timeout=5m
kubectl -n kubernetes-openconsole logs deploy/kubernetes-openconsole | head -3 # "version":"2.23.4"
Oturumlar geçerli kalır; giriş yapmış kullanıcılar sayfayı yenileyip kaldıkları yerden devam eder. Recreate ile
konsol, yeni pod'un açılması için gereken birkaç saniye boyunca erişilemez.
Manifest'leri sürüm sabitlemeden kullanıyorsanız (deploy/'daki gibi imagePullPolicy: Always ile :latest),
kubectl -n kubernetes-openconsole rollout restart deploy/kubernetes-openconsole en yeni sürümü çeker. Manifest'lerin
kendisi (ClusterRole kuralları, yeni değişkenler) ancak yeni deploy/'u tekrar uyguladığınızda güncellenir.
ClusterRole'e bir sürümde yeni kurallar eklenebilir (ör. 2.20'de nodes için watch). OpenConsole'un çalıştığı
cluster'da deploy/ ile birlikte gelir; bağlı diğer her cluster'da yeni rbac.yaml'ı kendiniz uygulayın
(Cluster bağlama).
Veritabanına ne olur
- Migration'lar yeni sürümün ilk açılışında otomatik çalışır: tablo ve sütun eklerler; bazı sürümler mevcut satırları bir kez yeniden yazar (2.17, eski audit satırlarına yeni aksiyon / sonuç alanlarını ekledi). Elle çalıştırılacak bir adım yok.
- 2.23.1'den itibaren migration tek bir transaction içinde çalışır: başarısız olursa (dolu disk, bozuk dosya) pod hatayı loguna yazarak durur ve veritabanı olduğu gibi kalır.
- Geri migration yok. Eski bir sürüme dönmek desteklenmez. Pratikte değişiklikler yalnızca ekleme yaptığı için eski sürüm yeni veritabanıyla genellikle açılır (denendi: 2.22.0 veritabanında 2.21.0), ama yeni sürümün yazdığı veriler yok sayılabilir ya da yanlış okunabilir.
Geri dönme
kustomization.yaml'da önceki sürümü yazın vekubectl apply -k .çalıştırın.- Eski sürüm yeni veritabanıyla düzgün çalışmazsa yükseltmeden önce aldığınız yedeği geri yükleyin. Yedekten sonraki her şey (audit olayları, kullanıcılar, ayarlar) kaybolur.
Sürüme özel notlar
2.23.4'e yükseltme
- İmajı değiştirin: API yollarında, veritabanında ya da manifest'lerde değişiklik yok. 2.23.3'e geri dönmek çalışır.
- Olaylar nesneyi canlı izler: pod ve iş yükü panellerinde ve bir satırın Olaylar düğmesinde; bu düğme artık
ham JSON yerine aynı listeyi gösterir (Ayrıntı panelleri). Kubernetes
olaylarının
/ws/eventsçerçevelericounttaşır.
2.23.3'e yükseltme
- İmajı değiştirin: API'de, veritabanında ya da manifest'lerde değişiklik yok. Loglar düğmelerinin artık kendi simgesi var (bir metin sayfası); Shell'in kullandığı terminal simgesini kullanmıyorlar.
2.23.2'ye yükseltme
- İmajı değiştirin: API'de, veritabanında ya da manifest'lerde değişiklik yok. 2.23.1'e geri dönmek çalışır.
- Tarihler, tarayıcının dili ve bölgesi ne olursa olsun her yerde aynı biçimde yazılır:
2026-11-16 23:37:51(24 saat), tarayıcının saat diliminde; audit log zamanlarıTIMEZONE'u kullanmaya devam eder. - Audit,
WS_ORIGIN_CHECK=enforceile: başka bir siteden açılan log soketi artıkpod.logssuccessolarak yazılmaz; başka bir siteden açılan shellpod.execdenied, nedeniorigin_not_allowedolur ve kayıt bırakmaz. - Tablolar: işlem düğmeleri ve sütun seçici geniş bir tablonun sağ kenarında kalır.
2.23.1'e yükseltme
- Kendi manifest'iniz: imaj artık distroless ve
deploy/deployment.yaml,/tmp'de biremptyDirilereadOnlyRootFilesystem: trueayarlar. Bu ayarları kopyalıyorsanız/tmpvolume'unu da ekleyin: sunucunun/datadışında geçici dosya yazabileceği tek yer orasıdır. - İmajda shell yok: OpenConsole pod'una
kubectl execartık çalışmaz;kubectl debug -it <pod> --image=busybox:1.36 --target=dashboardkullanın. - Siteler arası istekler: API artık hiçbir origin'e CORS cevabı vermez; sayfaları API'yi çağıran başka siteler
varsa onları
ALLOWED_ORIGINS'e yazın. Başka bir siteden gelen WebSocket'lerws.origin_mismatcholarak loglanır (varsayılanWS_ORIGIN_CHECK=warnile hâlâ kabul edilir). - YAML editörü imajla gelir; tarayıcı onu artık
cdn.jsdelivr.net'ten yüklemez. - Kendi manifest'iniz:
deploy/gibistrategy: RecreateveterminationGracePeriodSeconds: 30kullanın. Kapanışta açık shell'ler 1012 koduyla (server restarting) kapanır; bitişleri ve kayıtları audit'e yazılır. - Veritabanı: ilk açılış onu
/data/backups/app-<zaman>-pre-upgrade.db'ye kopyalar. Grup üyelikleri ve rol izinleri foreign key alır: daha önce silinmiş kullanıcı, grup ve rollerden kalan satırlar atılır; olmayan bir id saklanmak yerine reddedilir (400/404). - Yedekler: her gün veritabanının bir kopyası; en yeni 7 tanesi
/data/backups'ta tutulur (Yönetim → Yedekler). Volume'daki boş alana bakın: veritabanı boyutunun yaklaşık 7 katı. LOG_RETENTION_DAYS=0artık audit olaylarını hiç silmez (eskiden 30 demekti); temizlik açılışta da çalışır.- Denetim Logları: bir sayfada en fazla 500 satır olur; CSV olarak dışa aktar artık filtreye uyan bütün satırları, en fazla 50 000, içerir (eskiden 1 000'de duruyordu).
- API hata cevapları: her hata artık problem details'tır (
application/problem+json):{"type", "title", "status", "error", "detail"}.errorher zaman bir neden kodudur; eskidenerror'un tamamı olan bir mesaj (örneğincluster "nope" is unknown or not yours to use) artıkinvalid_inputgibi bir kodun altında,detail'dedir.401ve429'un da gövdesi var (unauthorized,api_key_expired,api_key_revoked,Retry-After: 1ilerate_limited); parolasını değiştirmesi gereken bir hesabın API anahtarı sayfasıpassword_change_requireddöner.error'u İngilizce bir cümleyle karşılaştıran bir script koda geçmelidir (Hatalar). - Bilinmeyen API yolları: bilinmeyen bir
/api/…ya da/ws/…yolu404not_founddöner (eskiden web arayüzünün sayfasıyla200dönüyordu), yanlış metotAllowile405.GET/POST/PUT /api/admin/clustervePOST /api/admin/cluster/validatekaldırıldı:/api/admin/clusters'ı kullanın. - Audit hacmi: kullanıcılar, gruplar, roller ve giriş, oturum ve logo ayarlarındaki her yönetici değişikliği, retler
ve hatalar dahil her cevapta audit'e yazılır; her YAML görüntüleme bir
<kind>.getokumasıdır (Denetim logu). - Loglar: WebSocket istek satırları
status=101der; tracing açıkkentracing enabledLOG_FORMAT'a uyar; başarısız bir LDAP girişi dizinin mesajıylaldap sign-in failedyazar (Loglama). - Kubeconfig ile eklenen cluster'lar: bir program çalıştıran (
exec, örn. kubelogin),auth-providerkullanan ya da bir dosya okuyan kubeconfig reddedilir (kubeconfig_unsupported) ve böyle bir kubeconfig ile kaydedilmiş cluster artık bağlanmaz. Yükseltmeden önce Yönetim → Cluster'lar'a bakın ve böyle bir kubeconfig'i token'lı ya da inline olanla değiştirin (Kubeconfig yöntemi). - Kendi manifest'iniz:
TRUSTED_PROXIES'i konsolun önündeki proxy'lerin ağına ayarlayın (deploy/deployment.yamlözel ağları yazar). Ayarlanmazsa hiçbirX-Forwarded-For'a güvenilmez: audit log, Yönetim → Oturumlar ve giriş kilidi kullanıcının değil ingress pod'unun adresini görür (Kubernetes'e kurulum). - LDAP: parolası tutmayan bir local hesap (yerleşik
admindahil) artık dizinde denenmez. Kullanıcı base DN'leri her satıra bir DN alır: birden çok DN'i virgülle ayıran bir değer tek DN olarak okunur, her birini ayrı satıra yazın. StartTLS dizinin sertifikasını doğrular; CA'nızı CA sertifikası (PEM) alanına yapıştırın (LDAP). - Oturum süresi: Yönetim → Oturum'daki dakika artık hareketsiz geçen süredir ve oturum girişten en geç 12 saat sonra biter; sabit bir ömür olarak düşünülmüş uzun bir değeri gözden geçirin (Oturumlar).
openconsole_cluster_connected, kimlik bilgileri reddedilen ya da ulaşılamayan bir cluster için artık0'dır; buna bağlı bir alarm yükseltmeden sonra tetiklenebilir: o cluster'ın kimlik bilgilerini düzeltin (Metrikler).- API üzerinden loglar: Kubernetes OpenConsole'un kendi hesabını reddettiğinde
GET …/pods/{name}/logs403cluster_forbiddendöner (eskiden502forbidden). İsteğin kendisi hatalı olduğu için reddedilen bir cluster değişikliğifailed, nedeniinvalidolarak audit'e yazılır. - Ad: ürünün adı artık OpenConsole for Kubernetes. İmaj, repo, namespace ve manifest'ler adlarını korur.
- İsteğe bağlı: şifreleme anahtarını bir Secret'ta tutun (Şifreleme anahtarını veritabanının dışında tutun).
2.22'ye yükseltme
- Elastic:
deploy/elk/install.sh'yi bir kez yeniden çalıştırın:openconsole.api_key.id/.name,openconsole.admin_scope,openconsole.expires_at,openconsole.api_access,openconsole.by_admin,openconsole.comment,openconsole.mode,openconsole.programveopenconsole.recording_idiçin mapping ekler (pipeline değişmedi). Çalıştırmazsanız hiçbir şey kaybolmaz: alanlar dinamik olarak map'lenir ve doğru tipi, script'i çalıştırdıktan sonraki ilk rollover'da alır. - Veritabanı: yeni tablolar ve sütunlar ilk açılışta eklenir; yapmanız gereken bir şey yok.
- Elasticsearch 8.7 (
rerouteyok, dolayısıylainstall.shde yok): aynı adımları elle yapmak, bir ILM policy ve yeni alanları canlı index'e eklemek içindeploy/elk/README.md→ Elasticsearch 8.7 and older bölümüne bakın. - Loglar: anahtarla yapılan isteklerde (reddedilenler dahil)
http.requestsatırları artıkopenconsole.api_key.id/.nametaşır;openconsole.api_key.id : *ile uygulama logunda da, audit logunda olduğu gibi, API ve web isteklerini ayırabilirsiniz. - 403 yanıtları artık bir cümle ya da boş gövde yerine nedeni söyler (
{"error": "forbidden"},api_key_not_allowed,admin_only,feature_disabled,api_access_policy,api_access_off); audit CSV'sine son sütun olarakapi_key_nameeklenir. - API anahtarı politikası: mevcut her rol Güvenli salt okuma API erişimiyle başlar. Bu yüzden yükseltmeden önce oluşturulmuş anahtarlar, bir admin rolü açana kadar (Yönetim → Roller → API erişimi) exec, düzenleme, ölçekleme, restart, ConfigMap ve Secret yetkilerini kaybeder. Anahtarların kendisi değişmez: politika izin verdiğinde eskisi gibi çalışırlar.
2.16'dan yükseltme
2.17'den önce sonuç aksiyonun bir parçasıydı (deployment.restart.success), okumalar çıplak bir verb'dü (resource_type: deployments ile list) ve ayrıntılar kaynak adının içinde dururdu (boh (restartedAt=…)).
- Veritabanı: 2.17'nin ilk açılışında mevcut audit satırları yeni
action,verb,outcomealanlarını ve tekil birresource_typealır. Kaynak adları eski(k=v)ekini korur; varsayılan 30 günlük saklama süresiyle bu satırlar kendiliğinden silinir. - API:
?action=deployment.restart.successhâlâ çalışır; sonuç ayrıştırılır. - Elastic:
deploy/elk/install.sh'ı yeniden çalıştırın. Yeni mapping,logs-openconsole.audit-*'ın bir sonraki rollover'ından itibaren geçerli olur (hemen uygulamak içinPOST logs-openconsole.audit-default/_rollover). Pipeline, 2.16 satırlarını 2.17 biçimine getirir (sonuçsuz aksiyon,openconsole.verb,openconsole.outcome,event.type); böylece tek sorgu eski ve yeni olayları birlikte bulur.event.action : *.success/*.deniedile filtreleyen kayıtlı aramalar, görselleştirmeler ve alarmlarevent.action+event.outcome(ya daopenconsole.outcome) kullanacak şekilde değiştirilmeli. - Konsol: fazladan basılan
deployment.action,workload.action,secret.action,yaml.apply,recording.action,pod.exec.start/pod.exec.end,*.logs.start,user.password_resetveuser.auto_provisionsatırları kalktı;level=errorile basılandeployment.restart.failed,deployment.scale.failed,statefulset.scale.failedve<resource>.apply.failedsatırları da öyle. Bunların tüm alanlarıauditsatırında. Başarısız bir aksiyon,event.reasonveerror.messageile birlikteevent.outcome : "failure"olarak görünür.level=errorartık OpenConsole'un kendi hataları için kullanılır (ör.http.panic).
Eski sürümlerden yükseltme
- 2.13'ten önce: o zaman oluşturulan hesaplar Yönetim → Kullanıcılar'da Local kaynağıyla görünür. LDAP hesapları bir sonraki dizin girişinde LDAP'a geçer; kaynakları önceden düzeltmek için 2.22.0 README'deki adımları izleyin.
- 2.3'ten önce: eski sürümün verdiği oturum token'ları süreleri dolana kadar geçerli kalır; böylece yükseltme kimsenin oturumunu kapatmaz.