Obtain a kubeconfig file and connect to a cluster by using kubectl - Container Service for Kubernetes

Önkoşullar

Başlamadan önce:

kubectl yüklüdür. kubectl version --client komutuyla doğrulayın.
ACK console erişiminiz vardır.
(RAM kullanıcıları) ACK ve küme düzeyinde izinler verilmiştir.

Bir kubeconfig türü seçin

Bir kubeconfig, küme erişim kimlik bilgilerini saklar.

Geçerlilik süresine göre:

Tür	Geçerlilik süresi	En uygun kullanım
Geçici kubeconfig	30 dakika ila 3 gün (yapılandırılabilir)	Günlük işletme ve bakım, sorun giderme, CI/CD işlem hatları
Uzun vadeli kubeconfig	3 yıl (varsayılan)	Otomatik sistemler, uzun süre çalışan izleme hizmetleri

Geçici kubeconfig'ler otomatik olarak süresi dolacağından kimlik bilgilerinin açığa çıkma riskini azaltır. Sık döndürmenin pratik olmadığı durumlarda yalnızca uzun vadeli kubeconfig kullanın.

Erişim yöntemine göre:

Tür	Gereksinim	En uygun kullanım
Dahili erişim	İstemci makinenin küme ile aynı Virtual Private Cloud (VPC) içinde olması	Daha düşük gecikme süresi, geliştirilmiş güvenlik
Genel erişim	İnternet erişimi olan herhangi bir makine; API sunucusunda bir elastik IP adresi (EIP) gerektirir	Yerel geliştirme, uzaktan işletme ve bakım

Not

EIP kullanımı ücrete tabidir. Ayrıntılar için Pay-as-you-go konusuna bakın.

Önemli

Ortak sorumluluk modeli kapsamında, kubeconfig kimlik bilgilerinizi güvence altına almak ve sürdürmek sizin sorumluluğunuzdadır. Kubeconfig'inizi düzenli olarak döndürün ve en az ayrıcalık ilkesini uygulayın.

Genel erişime sahip ACK özel kümeleri için kubeconfig'i almak amacıyla ana düğüme SSH üzerinden bağlanabilirsiniz.

Bir kubeconfig dosyası edinin ve kümeye bağlanın

ACK console üzerinde oturum açın. Sol gezinme bölmesinde Clusters öğesini tıklayın.
Clusters sayfasında hedef küme adını tıklayın veya Actions sütunundaki Details seçeneğini belirleyin.
Küme ayrıntıları sayfasında Connection Information sekmesini tıklayın. Temporary kubeconfig veya Long-term kubeconfig seçeneğini belirleyin. Geçici kubeconfig için bir geçerlilik süresi ayarlayın.
Public Access veya Internal Access sekmesini seçin, ardından Copy düğmesini tıklayın.
İçeriği istemci makinenizdeki $HOME/.kube/config dosyasına yapıştırın ve kaydedin.
Not
Dosya veya dizin yoksa oluşturun:
```
mkdir -p $HOME/.kube
touch $HOME/.kube/config
```

Bağlantıyı doğrulayın:

kubectl get namespaces

Örnek çıktı:

NAME              STATUS   AGE
default           Active   4h39m
kube-node-lease   Active   4h39m
kube-public       Active   4h39m
kube-system       Active   4h39m

Erişimi temizleyin

Bir kullanıcının artık küme erişimine ihtiyacı olmadığında kubeconfig'ini iptal edin. Sistem, bu kullanıcı için yeni kubeconfig dosyaları oluşturmaz. Birden çok kullanıcıyı tek seferde iptal etmek için ack-ram-tool aracını kullanın.

Not

Yanlışlıkla iptal edilen bir kubeconfig'i geri yüklemek için kubeconfig geri dönüşüm kutusu özelliğini kullanın.

SSS

Bir kubeconfig sertifikasıyla ilişkili kimliği nasıl bulurum?

kubeconfig ifadesini dosya yolunuzla değiştirin. kubectl varsayılan olarak $HOME/.kube/config yolunu kullanır. Farklı bir dosya belirtmek için KUBECONFIG değişkenini veya --kubeconfig bayrağını kullanın.

grep client-certificate-data kubeconfig | awk '{print $2}' | base64 -d | openssl x509 -noout -text | grep Subject:

Örnek çıktı:

        Subject: O=system:users, OU=, CN=1***-1673419473

O: Kubernetes kullanıcı grubu — bu örnekte system:users.
CN: İlişkili kullanıcı — bu örnekte 1***-1673419473, burada 1*** Alibaba Cloud kullanıcı ID'sidir.

Bir kubeconfig sertifikasının ne zaman sona ereceğini nasıl kontrol ederim?

kubeconfig ifadesini dosya yolunuzla değiştirin:

grep client-certificate-data kubeconfig | awk '{print $2}' | base64 -d | openssl x509 -noout -enddate

Örnek çıktı:

notAfter=Jan 10 06:44:34 2026 GMT

Bu örnekte sertifika 10 Ocak 2026 tarihinde sona ermektedir. Süre sonundan 180 gün önce veya herhangi bir zamanda konsol ya da API aracılığıyla yenileyebilirsiniz.

Bir kubeconfig'den istemci sertifikasını, özel anahtarı ve API sunucu adresini nasıl çıkarırım?

kubeconfig ifadesini dosya yolunuzla değiştirin:

cat ./kubeconfig | grep client-certificate-data | awk -F ' ' '{print $2}' | base64 -d > ./client-cert.pem
cat ./kubeconfig | grep client-key-data | awk -F ' ' '{print $2}' | base64 -d > ./client-key.pem
APISERVER=`cat ./kubeconfig | grep server | awk -F ' ' '{print $2}'`

Sonraki adımlar

İş yüklerini dağıtmak, kaynakları incelemek ve uygulamaları yönetmek için kubectl kullanın.