Ana içeriğe geç

Cluster bağlama

OpenConsole her cluster'a tek bir kimlikle (genellikle bir ServiceAccount) bağlanır; kullanıcı bazındaki erişimi kendisi uygular (Kullanıcılar → Gruplar → Roller). Bu kimliğin RBAC'ı tavandır: rolü ne derse desin, hiçbir kullanıcı onun izin verdiğinden fazlasını yapamaz.

Cluster'lar yalnızca arayüzden eklenir (Yönetim → Cluster'lar). Ortam değişkenlerinden ya da pod'un kendi ServiceAccount'undan eklenmez; OpenConsole'un çalıştığı cluster da buna dahil. İki yöntem var:

YöntemYapıştırdığınızNe zaman
ServiceAccount TokenAPI server URL'i + token + CA sertifikasıolağan durum: OpenConsole için açılmış bir ServiceAccount (aşağıdaki 1–3. adımlar)
Kubeconfigbir kubeconfig dosyasıOpenConsole'a ayrılmış bir kimlik için statik token ya da istemci sertifikası kullanan bir kubeconfig'iniz zaten var

Kimlik bilgileri kaydedilmeden önce API server'a karşı denenir (gerçek bir namespace listesi alınır; yanlış server, token ya da CA reddedilir) ve veritabanında şifreli saklanır. Uygulama açılırken her cluster'a bağlanır.

1. ServiceAccount'u oluşturun​

Kimliğini zaten kendiniz yönettiğiniz bir kubeconfig kullanıyorsanız bu adımı atlayın; o durumda kimliğin RBAC'ı OpenConsole'un yapması gereken her şeyi kapsamalı (aşağıdaki tablo).

OpenConsole'un çalıştığı cluster'da kurulum bunu zaten oluşturdu. Diğer her cluster'da:

kubectl --context <cluster> create namespace kubernetes-openconsole
kubectl --context <cluster> apply -f \
https://raw.githubusercontent.com/vurulkan/kubernetes-openconsole/v2.23.4/deploy/rbac.yaml

Bu komut şunları oluşturur:

  • kubernetes-openconsole namespace'inde openconsole-reader ServiceAccount'u
  • openconsole-reader-token Secret'ı: süresi dolmayan bir token; token ve ca.crt alanlarını Kubernetes doldurur
  • openconsole-readonly ClusterRole'ü ve onu ServiceAccount'a bağlayan bir ClusterRoleBinding

OpenConsole pod'u bu ServiceAccount ile çalışmaz (Deployment'ı token mount etmez). ServiceAccount yalnızca arayüze yapıştıracağınız token'ı üretmek için vardır.

Tam ya da salt okuma​

DosyaClusterRoleNe çalışırKubernetes neyi reddeder (403)
rbac.yamlokumalar + OpenConsole'un kullandığı yazma verb'leriher şey—
rbac-readonly.yamlyalnızca get / list / watchPanel'in tüm sekmeleri, Canlı olaylar, loglar, Genel bakış, Node'lar, CPU / memoryrestart, ölçekleme, YAML uygulama, pod shell'i. Secret'lar hiç dahil değil

İki dosya da aynı adları kullanır; birini uygulamak diğerinin yerine geçer, arayüzde hiçbir şey değişmez. rbac-readonly.yaml kullanıyorsanız OpenConsole rollerinizden yazma aksiyonlarını da çıkarın; kullanıcılar yalnızca hata veren butonlar görmesin. Loglar dahildir; salt okuma "log da yok" anlamına gelsin istiyorsanız pods/log kuralını silin.

Secret'lar salt okuma dosyasına bilerek konmadı: Kubernetes seviyesinde Secret'larda get, değerlerini okumak demektir; tek koruma OpenConsole'daki secrets:reveal izni olurdu. Secret'lar sekmesine yalnızca metadata için ihtiyacınız varsa kuralın yorumunu kaldırın ve yalnızca secrets:list / secrets:get verin.

Yazma yalnızca bazı namespace'lerde​

rbac.yaml, OpenConsole'un kube-system dahil her namespace'te Secret okumasına, shell açmasına ve workload'ları değiştirmesine izin verir. Bunu yalnızca seçtiğiniz namespace'lerle sınırlamak için okumaları cluster genelinde bırakın (OpenConsole pod'ları, Deployment'ları, … cluster genelinde izler) ve yazma haklarını deploy/optional/rbac-namespaced-writes.yaml ile namespace başına bağlayın:

kubectl apply -f https://raw.githubusercontent.com/vurulkan/kubernetes-openconsole/v2.23.4/deploy/rbac-readonly.yaml
curl -sL https://raw.githubusercontent.com/vurulkan/kubernetes-openconsole/v2.23.4/deploy/optional/rbac-namespaced-writes.yaml \
| sed 's/namespace: team-a/namespace: payments/' | kubectl apply -f -

İkinci komutu her namespace için, o namespace'in adıyla bir kez çalıştırın. Diğer namespace'lerde Kubernetes reddeder: Secrets sekmesi OpenConsole'un bu cluster'daki hesabı bunu okuyamıyor (ClusterRole'ü kontrol edin). der (403 cluster_forbidden), bir shell ya da komut başarısız olur (exec_failed), restart, ölçekleme ve YAML apply API server'ın mesajıyla başarısız olur. OpenConsole rollerini buna uygun tutun ki kullanıcılar yalnızca hata veren butonlar görmesin. deploy/ klasörüyle kuruyorsanız dosyaları tek tek listeleyin (Kubernetes'e kurulum), yoksa her kubectl apply -k rbac.yaml'ı geri koyar.

ClusterRole kuralları ne işe yarar​

Hiç vermeyeceğiniz izinlerin kurallarını silin (dosyanın bir kopyasında).

Kural (rbac.yaml)Ne için gerekliOlmazsa
namespaces, pods, services, configmaps, events: get / list / watchPanel'in tüm sekmeleri, Canlı olaylarOpenConsole hiçbir şeyi listeleyemez
secrets: get / listsecrets:list, secrets:get, secrets:revealSecret'lar sekmesi "OpenConsole'un bu cluster'daki hesabı bunu okuyamıyor" der
secrets: updatesecrets:editbir Secret'ın YAML'ını uygulamak 403 ile başarısız olur
pods/log: getpod / deployment / job logları (pods:logs)loglar 403 ile başarısız olur
pods/exec: createpod shell'i ve tek komutluk exec (pods:exec)shell 403 ile başarısız olur
pods, services, configmaps: updateYAML uygulama ({resource}:edit)uygulama 403 ile başarısız olur
deployments, daemonsets, statefulsets: get / list / watch / updatekendi sekmeleri, YAML uygulamasekmeler hata gösterir; uygulama 403 ile başarısız olur
deployments: patchdeployments:restartrestart 403 ile başarısız olur
deployments/scale, statefulsets/scale: get / updatedeployments:scale, statefulsets:scaleölçekleme 403 ile başarısız olur
horizontalpodautoscalers, ingresses, cronjobs, jobs: get / list / watch / updatekendi sekmeleri, YAML uygulamasekmeler hata gösterir; uygulama 403 ile başarısız olur
replicasets: get / listbir Deployment'ın ayrıntı panelindeki revizyonlarırevizyon görünmez
metrics.k8s.io pods: get / listpod ve iş yüklerinin CPU / memory'si (metrics-server gerekir)CPU / memory yok; Pod'lar sekmesi nedenini söyler
nodes: get / list / watch, metrics.k8s.io nodes: get / listGenel bakış (node sayısı, allocatable yüzdesi, node şeridi) ve Node'larGenel bakış CPU / memory'yi mutlak değer olarak gösterir, node şeridi olmaz; Node'lar ekranı token'ın node'ları listeleyemediğini söyler. watch yoksa node'lar her istekte yeniden listelenir
services/proxy: Prometheus Service'inizde get (yorum satırı halinde)Prometheus'un "Cluster içinden" moduPrometheus testi ilk adımda başarısız olur

2. Token'ı ve CA'yı okuyun​

Bunu eklediğiniz cluster'a karşı çalıştırın (CTX onun kubectl context'i):

CTX=<cluster>
NS=kubernetes-openconsole
TOKEN=$(kubectl --context $CTX -n $NS get secret openconsole-reader-token -o jsonpath='{.data.token}' | base64 -d)
CA=$(kubectl --context $CTX -n $NS get secret openconsole-reader-token -o jsonpath='{.data.ca\.crt}') # already base64, use as is
SERVER=$(kubectl config view --context $CTX --minify -o jsonpath='{.clusters[0].cluster.server}')
echo "$SERVER"; echo "$TOKEN"; echo "$CA"

SERVER adresine OpenConsole pod'undan erişilebilmeli (network policy'ler, private endpoint'ler). OpenConsole'un çalıştığı cluster için bunun yerine https://kubernetes.default.svc kullanın.

3. Arayüzden ekleyin​

ServiceAccount Token yöntemi​

Yönetim → Cluster'lar → Cluster Ekle:

AlanDeğer
Adistediğiniz bir ad, ör. prod-west; cluster seçicide ve her audit olayında görünür
Açıklamaopsiyonel
YöntemServiceAccount Token (form Kubeconfig seçili açılır)
API Server$SERVER; OpenConsole'un çalıştığı cluster için https://kubernetes.default.svc
Token$TOKEN
CA Sertifikası (base64)$CA. Yalnızca API server'ın sertifikası public bir CA tarafından imzalanmışsa boş bırakın

Cluster'ı kaydet bağlantıyı dener. İlk cluster'da Varsayılan yap'a tıklayın: cluster seçmemiş kullanıcılar varsayılan cluster'da çalışır; herkes izinlerinin kapsadığı başka bir cluster'a geçebilir.

Kubeconfig yöntemi​

Yöntem: Kubeconfig → Kubeconfig yükle altında, kimliği statik token ya da istemci sertifikası kullanan bir kubeconfig yükleyin. Yukarıdaki ServiceAccount'tan bir tane oluşturmak için:

cat > openconsole-prod-west.kubeconfig <<EOF
apiVersion: v1
kind: Config
clusters:
- name: target
cluster:
server: ${SERVER}
certificate-authority-data: ${CA}
users:
- name: openconsole-reader
user:
token: ${TOKEN}
contexts:
- name: openconsole
context:
cluster: target
user: openconsole-reader
current-context: openconsole
EOF

:::warning Kişisel kubeconfig'iniz değil Bir kubeconfig kimlik bilgilerini yalnızca satır içi taşıyabilir: token, client-certificate-data / client-key-data, certificate-authority-data. Exec plugin ile giriş yapan (kubelogin, aws eks get-token, gke-gcloud-auth-plugin), auth-provider kullanan ya da bir dosya okuyan (tokenFile, client-certificate, client-key, certificate-authority) kubeconfig reddedilir (kubeconfig_unsupported): OpenConsole pod'unun içinde bir program çalıştırır ya da dosya okurdu. Kişisel bir kubeconfig ayrıca OpenConsole'un ayrı bir kimlikle değil, sizin adınıza işlem yapmasına yol açar. :::

Token'ı yenileme​

openconsole-reader-token token'ının süresi hiç dolmaz. Değiştirmek için yalnızca Secret'ı değil, ServiceAccount'u silin ve dosyayı yeniden uygulayın:

CTX=<cluster>
NS=kubernetes-openconsole
kubectl --context $CTX -n $NS delete serviceaccount openconsole-reader # its token Secret goes with it
kubectl --context $CTX -n $NS wait --for=delete secret/openconsole-reader-token --timeout=60s
kubectl --context $CTX apply -f \
https://raw.githubusercontent.com/vurulkan/kubernetes-openconsole/v2.23.4/deploy/rbac.yaml

Yalnızca Secret'ı silip yeniden oluşturursanız aynı token'ı yeniden alırsınız: Kubernetes ServiceAccount token'ını ServiceAccount'tan ve Secret'ın adından türetir; "yeni" token aynısıdır ve eskisi çalışmaya devam eder. Yeni bir ServiceAccount ise yeni bir kimlik alır ve eski token hemen reddedilir. (rbac.yaml'daki yorum 2.23.0'a kadar yalnızca Secret'ı silme yolunu anlatıyordu; bu yanlıştı.)

Ardından yeni token'ı ve CA'yı okuyun (2. adım), Yönetim → Cluster'lar ekranında cluster'ın Düzenle butonuna tıklayın, Credential'ları değiştir kutusunu işaretleyin ve yeni token'ı yapıştırın. CA alanını boş bırakın: kayıtlı CA kalır (API sunucusunun sertifikası değişmedi). Kubeconfig ile eklenmiş bir cluster için yeni dosyayı yükleyin.

Bunu yapana kadar eski token'ı kullanan her cluster kaydı (token ve kubeconfig fark etmez) erişimini kaybetmiştir. Listeler OpenConsole'un cache'inde kalanı göstermeye devam edebilir ve Cluster'lar sayfası hata göstermez; pod logunda Failed to watch … Unauthorized satırları olur.

Bunun yerine süresi kendiliğinden dolan bir token isterseniz: kubectl -n kubernetes-openconsole create token openconsole-reader --duration=8760h. Süresi dolmadan arayüzde değiştirin.

Prometheus (opsiyonel)​

Prometheus olmadan CPU ve memory grafikleri son 24 saati kapsar; veriler OpenConsole'un belleğinde tutulur (restart'ta kaybolur). 7 güne kadar geçmiş için cluster'ın Prometheus'unu Yönetim → Cluster'lar → Prometheus altında ayarlayın; bkz. Prometheus. "Cluster içinden" modu, yukarıdaki tablodaki services/proxy kuralını ister.

Sorun giderme​

  • Kaydetme başarısız oluyor: API server'a pod'dan erişilemiyor (network policy, private endpoint, kubeconfig'te 127.0.0.1) ya da CA eşleşmiyor.
  • Bir kullanıcı için sekme boş ya da 403: önce o kullanıcının rol izinlerine, sonra yukarıdaki ClusterRole kuralına bakın. OpenConsole'un bu cluster'daki hesabı bunu okuyamıyor (cluster_forbidden) diyen bir sekmenin nedeni ClusterRole'dür.
  • CPU / memory yok: cluster'da metrics-server yok (kubectl get apiservices v1beta1.metrics.k8s.io) ya da ClusterRole'de metrics.k8s.io pods eksik. Hangisi olduğunu Pod'lar sekmesi söyler.
  • Prometheus testi başarısız: test, başarısız olan adımı söyler; bkz. Prometheus.