Tüm Ürünler
Search

Bu Ürün

    Container Service for Kubernetes:Troubleshoot cluster access issues in the ACK console

    Belge Merkezi

    Container Service for Kubernetes:Troubleshoot cluster access issues in the ACK console

    Son Güncelleme:Oct 06, 2026

    API server istek hataları, pod günlüğüne erişim başarısızlıkları ve eksik küme RBAC izinleri gibi konsol küme erişimi sorunlarını çözün.

    Küme API server istek hataları: ErrorQueryClusterNamespace veya APIServer.500

    Belirti

    Konsoldan küme kaynaklarına erişirken, An exception occurred with the request to the cluster's API server hata iletisiyle birlikte ErrorQueryClusterNamespace veya APIServer.500 hata kodu görüntülenir. Küme yönetim konsolu; An exception occurred with the request to the cluster's API server iletisini, ErrorQueryClusterNamespace hata kodunu, failed to query access namespace for user ayrıntılarını, https://192.168.xxx:10885/api/v1/namespaces?limit=300 istek URL’sini ve context deadline exceeded (Client.Timeout exceeded while awaiting headers) hatasını içeren bir hata iletişim kutusu gösterir.

    Neden

    API server yük dengeleyicisinin anormal yapılandırması veya durumu, Container Service kontrol düzlemi ile küme API server arasındaki bağlantıyı keser.

    Çözüm

    1. ACK konsolunda oturum açın. Sol gezinme bölmesinde Clusters öğesini tıklayın.

    2. Clusters sayfasında kümenizin adını tıklayın. Sol gezinme bölmesinde Cluster Information öğesini tıklayın.

    3. Basic Information sekmesinde, API server SLB örnek kimliğine tıklayarak SLB konsolunu açın.

      • Arayüzde the load balancer ID does not exist uyarısı görüntüleniyorsa, API server yük dengeleyicisi silinmiş veya serbest bırakılmıştır ve küme kurtarılamaz. Yeniden oluşturmak için Yönetilen bir ACK kümesi oluşturma konusuna bakın.

      • Örnek mevcutsa sonraki adıma geçin.

    4. Yük dengeleyicinin Status değerinin Running olup olmadığını kontrol edin.

      • Değilse, örneğin ödeme gecikmesi veya süresi dolmuş durumunu kontrol edin. Böyle bir durum varsa yenileyip etkinleştirin. SLB faturalama ayrıntıları için Geciken ödemeler bölümüne bakın.

      • Evet ise sonraki adıma geçin.

    5. Listeners öğesini tıklayın ve ön uç ile arka uçta TCP:6443 dinleyicilerinin mevcut olduğunu ve Status değerinin Running olduğunu doğrulayın.

      • Değilse, API server yük dengeleyici dinleyicisi değiştirilmiş demektir.

        • Dinleyici Disable durumundaysa dinleyiciyi seçin ve ardından Enable öğesini tıklayın.

        • Dinleyici mevcut değilse aşağıdaki yordamı uygulayın.

          Tüm küme ana düğümlerinin varsayılan sunucu grubuna eklendiğinden emin olun, ardından ön uç ve arka ucun TCP:6443 olarak ayarlandığı bir dinleyici oluşturun. Arka ucu Default Server Group olarak ayarlayın ve dinleyiciyi etkinleştirin. Dinleyici ekleme hakkında daha fazla bilgi için TCP dinleyici ekleme konusuna bakın.

      • Evet ise sonraki adıma geçin.

    6. Dinleyicinin Health Check Status değerinin Healthy olup olmadığını kontrol edin.

      • Değilse, API server yük dengeleyici arka ucu anormal durumdadır. Aşağıda açıklandığı gibi sorun giderin.

        • ACK konsolunda, Nodes > Nodes yolunu izleyin. Her ana düğüm için ECS örnek kimliğine tıklayarak ECS konsolunu açın ve Running durumunu doğrulayın.

        • ECS konsolunda, her ana düğüme uzaktan oturum açın ve API Server konteynerinin çalıştığını doğrulayın.

          1. Ana düğüme oturum açma hakkında bilgi için Bağlantı yöntemleri konusuna bakın.

          2. Konteyner runtime ortamına göre API sunucusu konteyner durumunu kontrol edin.

            • Docker runtime: docker ps | grep kube-apiserver komutunu çalıştırın, ardından çıktıdan konteyner durumunu kontrol etmek için docker inspect kullanın.

            • containerd runtime: crictl ps | grep kube-apiserver komutunu çalıştırın, ardından çıktıdan konteyner durumunu kontrol etmek için crictl inspect kullanın.

      • Evet ise sonraki adıma geçin.

    7. Dinleyici için erişim kontrolünün etkin olup olmadığını kontrol edin. Erişim kontrolü etkinse, API server yük dengeleyici dinleyicisinin erişim kontrolü izin listesi yanlış yapılandırılmıştır. İzin listesine 100.104.0.0/16 adres bloğunu ekleyin. Bu blok, ACK kontrol düzleminin API server dahili erişimi için kullandığı kaynak adres aralığıdır.

    Pod günlüklerine erişirken oluşan **API server istek hataları**

    Diğer küme kaynaklarına erişilebiliyor ancak pod günlüklerine erişilemiyorsa aşağıdaki adımları uygulayın.

    1. Pod durumunun Running olup olmadığını kontrol edin. Değilse Pod sorunlarını giderme konusuna bakın.

    2. Nodes > Nodes sayfasında pod’un barındırıldığı düğümü bulun ve ECS örnek kimliğine tıklayın. ECS konsolunda, Security Group öğesine tıklayın.

    3. Güvenlik grubu kurallarını inceleyin ve TCP bağlantı noktası 10250 üzerinden gelen VPC erişimine izin verildiğinden emin olun. İzin verilmediyse bir güvenlik grubu kuralı ekleyin.

    Hesap, işlem için gerekli küme RBAC izinlerine sahip değil: ForbiddenQueryClusterNamespace veya APISERVER.403

    Belirti

    Konsola erişirken "The current account has not been granted the required cluster RBAC permissions for this operation" hata iletisiyle birlikte ForbiddenQueryClusterNamespace veya APISERVER.403 hata kodu görüntülenir. Ad alanlarını sorgularken bir Error iletişim kutusunda "The current account has not been granted the required cluster RBAC permissions for this operation. Please contact the primary account or a permissions administrator for authorization" uyarısı gösterilir. İngilizce hata Forbidden query namespaces olup hata kodu ForbiddenQueryClusterNamespace şeklindedir.

    Neden

    Hesabınızda gerekli küme RBAC izinleri eksiktir.

    Çözüm

    1. Bir Alibaba Cloud hesabı veya yönetici olarak ACK konsolunda oturum açın. Sol gezinme bölmesinde Authorizations seçeneğini belirleyin.

    2. RAM Users sekmesinde etkilenen kullanıcıyı bulun ve kullanıcı adının yanındaki Modify Permissions öğesine tıklayın.

    3. Add Permissions öğesine tıklayın, kümeyi, ad alanını ve izinleri seçin, ardından Submit öğesine tıklayın.

    Hesap, işlem için gerekli RAM izinlerine sahip değil StatusForbidden

    Belirti

    Konsola erişirken "The current account is not granted the required RAM permissions for this operation" hatasıyla birlikte StatusForbidden hata kodu görüntülenir. ACK konsolunda bir Error iletişim kutusunda "The current account is not granted the required RAM permissions for this operation. Please contact the master account or a RAM administrator for authorization." uyarısı gösterilir. Hata iletisi RAM policy Forbidden for action cs:DescribeKubernetesVersionMetadata olup hata kodu StatusForbidden şeklindedir.

    Neden

    Hesabınızda gerekli RAM izinleri eksiktir.

    Çözüm

    1. Bir Alibaba Cloud hesabı veya RAM izinlerine sahip bir hesap olarak RAM Access Control üzerinde oturum açın.

    2. RAM Access Control üzerinde Create Authorization öğesine tıklayın ve hata sayfasındaki CS bilgilerine dayanarak cs:DescribeKubernetesVersionMetadata gibi gerekli izni ekleyin. Daha fazla bilgi için RAM kullanarak kümeler ve cloud kaynakları için izin verme konusuna bakın.