Container Service for Kubernetes:Troubleshoot add-on errors

Belirtiler

Konsolda aşağıdakine benzer bir hata görüntülenir:

Addon status not match, failed upgrade helm addon arms-cmonitor for cluster c3cf94b952cd34b54b71b10b7********, err: rendered manifests contain a resource that already exists. Unable to continue with update: ConfigMap "otel-collector-config" in namespace "arms-prom" exists and cannot be imported into the current release

Neden

Eklentinin gerektirdiği bir kaynak kümede zaten mevcuttur. Yaygın nedenler şunlardır:

• Farklı bir yöntemle başka bir sürüm (örneğin açık kaynak sürümü) yüklenmiştir.

• Eklenti Helm V2 ile yüklenmiş ve Helm V3'e geçiş öncesinde kaynakları kaldırılmamıştır.

• Manuel olarak aynı ada sahip bir kaynak oluşturulmuştur.

Çözüm

Hata mesajında belirtilen çakışan kaynakları silin ve ardından işlemi yeniden deneyin.

Aşağıdaki bölümlerde belirli eklentiler için komutlar listelenmiştir.

kubectl delete ClusterRole arms-kube-state-metrics
kubectl delete ClusterRole arms-node-exporter
kubectl delete ClusterRole arms-prom-ack-arms-prometheus-role
kubectl delete ClusterRole arms-prometheus-oper3
kubectl delete ClusterRole arms-prometheus-ack-arms-prometheus-role
kubectl delete ClusterRole arms-pilot-prom-k8s
kubectl delete ClusterRoleBinding arms-node-exporter
kubectl delete ClusterRoleBinding arms-prom-ack-arms-prometheus-role-binding
kubectl delete ClusterRoleBinding arms-prometheus-oper-bind2
kubectl delete ClusterRoleBinding kube-state-metrics
kubectl delete ClusterRoleBinding arms-pilot-prom-k8s
kubectl delete ClusterRoleBinding arms-prometheus-ack-arms-prometheus-role-binding
kubectl delete Role arms-pilot-prom-spec-ns-k8s
kubectl delete Role arms-pilot-prom-spec-ns-k8s -n kube-system
kubectl delete RoleBinding arms-pilot-prom-spec-ns-k8s
kubectl delete RoleBinding arms-pilot-prom-spec-ns-k8s -n kube-system

kubectl delete MutatingWebhookConfiguration ack-node-local-dns-admission-controller

kubectl delete ConfigMap otel-collector-config -n arms-prom
kubectl delete ClusterRoleBinding arms-prom-cmonitor-role-binding
kubectl delete ClusterRoleBinding arms-prom-cmonitor-install-init-role-binding
kubectl delete ClusterRole arms-prom-cmonitor-role
kubectl delete ClusterRole arms-prom-cmonitor-install-init-role
kubectl delete ServiceAccount cmonitor-sa-install-init -n kube-system

Neden

Aynı ada sahip bir Helm sürümü zaten mevcut olduğundan yükleme veya güncelleme engellenir. Yaygın nedenler şunlardır:

• Farklı bir yöntemle başka bir sürüm yüklenmiştir.

• Önceki bir yükleme denemesinden kalan bir Helm sürümü bulunmaktadır.

Çözüm

1. ACK konsolu üzerinden oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

2. Clusters sayfasında hedef kümenin adına tıklayın. Sol bölmede Applications > Helm seçeneğini belirleyin.

3. Eklentinin Helm sürümünü bulun. Actions sütununda Delete seçeneğine tıklayın. İletişim kutusunda Clear Release Records seçeneğini işaretleyin ve OK seçeneğine tıklayın.

4. Eklentiyi yükleyin veya güncelleyin.

Neden

Güncelleme gönderildikten sonra eklenti podları zaman aşımı süresi içinde Ready durumuna ulaşamaz.

Sorun giderme

1. ACK konsolu üzerinden oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

2. Clusters sayfasında hedef kümenin adına tıklayın. Sol bölmede Operations > Event Center seçeneğini belirleyin.

3. Events (Cluster Resource Events) sekmesinde Level değerini Warning olarak ayarlayın, eklentinin dağıtıldığı ad alanını seçin ve Type değerini Pod olarak ayarlayın. Nedeni belirlemek için olay ayrıntılarını inceleyin.

Yaygın nedenler ve çözümler

Neden

ACK, Kubernetes API sunucusuna ulaşamıyor. Bu durum genellikle API sunucusunu dışa açan Server Load Balancer (SLB) örneğinin yanlış yapılandırılmasından kaynaklanır.

Çözüm

Bkz. API sunucusu istek istisnalarını giderme.

Neden

Gerekli eklenti kaynakları eksik; büyük olasılıkla harici olarak silinmiş veya değiştirilmiş olup yerinde güncellemeyi engelliyor.

Çözüm

Eklentiyi kaldırın ve en son sürümü yükleyin.

Neden

Eklenti, Tiller'a bağımlı olan Helm V2 kullanır. Tiller bir hatayla karşılaşmış ve erişilemez durumdadır.

Çözüm

1. ACK konsolu üzerinden oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

2. Clusters sayfasında hedef kümenin adına tıklayın. Sol bölmede Workloads > Pods seçeneğini belirleyin.

3. kube-system ad alanını seçin. tiller podunu bulup silin. Sistem podu otomatik olarak yeniden oluşturur.

4. Tiller podu Ready durumuna ulaştığında eklenti işlemini yeniden deneyin.

Belirtiler

Konsolda aşağıdakine benzer bir hata görüntülenir:

failed to create: Internal error occurred: failed calling webhook "rancher.cattle.io": failed to call webhook: Post "https://rancher-webhook.cattle-system.svc:443/v1/webhook/mutation?timeout=10s": no endpoints available for service "rancher-webhook"

Neden

Bir eklenti kaynağı için mutating webhook çağrılamıyor ve bu durum güncellemeleri engelliyor.

Çözüm

Hata mesajında belirtilen başarısız webhook'u düzeltin ve ardından eklenti güncellemesini yeniden deneyin.

Örnekte, cattle-system ad alanındaki rancher-webhook webhook'u kullanılamıyor.

Neden

Küme Helm V2 kullanır ancak Tiller, kaynakları yönetmek için gerekli RBAC izinlerine sahip değildir. Bu durum bileşen işlemlerini engeller.

Çözüm

Tiller'a gerekli RBAC izinlerini verin. Bkz. Rol tabanlı erişim denetimi.

Neden

Küme Helm V2 kullanır ancak çalışan bir Tiller podu yoktur.

Çözüm

kube-system ad alanındaki tiller-deploy podunun sorunlarını giderin. Pod normal çalışmaya başladıktan sonra eklenti işlemini yeniden deneyin. Bkz. Pod sorunlarını giderme.

Neden

Eklentinin gerektirdiği bir ClusterRoleBinding mevcut ancak yapılandırma çakışması var. Bu durum genellikle ayrı olarak yüklenen açık kaynak sürümünden kaynaklanır.

Çözüm

Açık kaynak bileşen sürümünü kaldırın:

1. ACK konsolu üzerinden oturum açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

2. Clusters sayfasında hedef kümenin adına tıklayın. Sol bölmede Applications > Helm seçeneğini belirleyin.

3. Eklentinin Helm sürümünü bulun. Actions sütununda Delete seçeneğine tıklayın. İletişim kutusunda Clear Release Records seçeneğini işaretleyin ve OK seçeneğine tıklayın.

4. Eklentiyi yükleyin veya güncelleyin.

Belirtiler

Konsolda aşağıdakine benzer bir hata görüntülenir:

spec.template.spec.initContainers[1].name: Duplicate value: "install-cni"

Neden

Yüklenen sürümün YAML bildirimleri hedef sürümle uyumlu değildir. Yaygın nedenler şunlardır:

• Farklı bir yöntemle başka bir sürüm (örneğin açık kaynak sürümü) yüklenmiştir.

• Eklentinin YAML bildirimleri manuel olarak değiştirilmiştir.

• Şu anda yüklü olan sürüm artık desteklenmemektedir.

Çözüm

Hata mesajına göre bileşenin YAML bildirimlerini değiştirin. Yardım almak için bir destek talebi oluşturun.

spec.template.spec.initContainers[1].name: Duplicate value: "install-cni"

kubectl -n kube-system edit ds kube-flannel-ds

      containers:
      - name: kube-flannel
        image: registry-vpc.{{.Region}}.aliyuncs.com/acs/flannel:{{.ImageVersion}}
        command: [ "/opt/bin/flanneld", "--ip-masq", "--kube-subnet-mgr" ]
        ...
        # Irrelevant lines are not shown. Delete comment lines 7 to 21.
    # - command:
      # - /bin/sh
      # - -c
      # - set -e -x; cp -f /etc/kube-flannel/cni-conf.json /etc/cni/net.d/10-flannel.conf;
        # while true; do sleep 3600; done
      # image: registry-vpc.cn-beijing.aliyuncs.com/acs/flannel:v0.11.0.1-g6e46593e-aliyun
      # imagePullPolicy: IfNotPresent
      # name: install-cni
      # resources: {}
      # terminationMessagePath: /dev/termination-log
      # terminationMessagePolicy: File
      # volumeMounts:
      # - mountPath: /etc/cni/net.d
        # name: cni
      # - mountPath: /etc/kube-flannel/
         # Irrelevant lines are not shown. Delete comment lines 7 to 21.
          name: flannel-cfg
        ...