kubectl ile Kubernetes kümenize bağlanma
Kümeniz hazır olduğunda yönetmek için tek ihtiyacınız kubectl ve panelden alacağınız kubeconfig dosyası. Bu rehber dosyayı indirmeyi, üç işletim sisteminde kubectl kurulumunu ve bağlantıyı doğrulayan ilk komutları anlatır.
Son güncelleme: 1 Kasım 2026
Rehberler ve içindekiler
kubeconfig dosyasını alın
kubeconfig, kümenin adresini ve size ait istemci sertifikasını taşıyan küçük bir dosyadır. Kümenin Kubernetes API'sine yalnız bu sertifikayla bağlanılır; parola ya da anonim erişim yoktur.
- Panelde Hizmetler altında kümenizi açın.
- Kümeye bağlanma (kubeconfig) bölümünde kubeconfig al düğmesine basın; güvenlik için şifrenizi yeniden sorarız.
- Dosyayı indirin. Adı küme adınız ve sıra numarasıyla gelir, örneğin
magaza-1.kubeconfig.
Dosya bir kez gösterilir
kubectl kurulumu
kubectl, Kubernetes'in resmi komut satırı aracıdır. Kümenizin sürümüyle en fazla bir küçük sürüm farkı olan bir kubectl kullanın; en kolayı güncel kararlı sürümü kurmaktır.
Windows
PowerShell'i açın ve Windows paket yöneticisiyle kurun. Kurulumdan sonra yeni bir PowerShell penceresi açın.
PowerShell
winget install -e --id Kubernetes.kubectl
kubectl version --clientmacOS
Homebrew kuruluysa tek komut yeter. Homebrew yoksa aşağıdaki Linux yöntemini darwin/arm64 (Apple işlemci) ya da darwin/amd64 (Intel) ile kullanabilirsiniz.
Terminal
brew install kubectl
kubectl version --clientLinux
Resmi ikiliyi indirip doğrulayın ve kurun. ARM işlemcili bir makinedeyseniz adreslerde amd64 yerine arm64 yazın.
Terminal
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
echo "$(cat kubectl.sha256) kubectl" | sha256sum --check
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
kubectl version --clientkubectl'e dosyayı gösterin
İki yol var. Tek kümeniz varsa dosyayı varsayılan yere koyun; birden çok kümeyle çalışıyorsanız KUBECONFIG değişkenini kullanın, mevcut ayarlarınız ezilmez.
Varsayılan yere koymak
macOS ve Linux
mkdir -p ~/.kube
mv ~/Downloads/magaza-1.kubeconfig ~/.kube/config
chmod 600 ~/.kube/configWindows (PowerShell)
New-Item -ItemType Directory -Force "$HOME\.kube"
Move-Item "$HOME\Downloads\magaza-1.kubeconfig" "$HOME\.kube\config"Dikkat
~/.kube/config zaten varsa üzerine yazmadan önce yedekleyin ya da aşağıdaki KUBECONFIG yolunu kullanın.KUBECONFIG değişkeniyle
macOS ve Linux
export KUBECONFIG=~/.kube/magaza-1.kubeconfigWindows (PowerShell)
$env:KUBECONFIG = "$HOME\.kube\magaza-1.kubeconfig"Değişken yalnız açık terminal penceresinde geçerlidir. Kalıcı yapmak için satırı kabuk profilinize (~/.bashrc, ~/.zshrc) ya da PowerShell profilinize ekleyin. Tek komutluk deneme için --kubeconfig bayrağı da olur: kubectl --kubeconfig ./magaza-1.kubeconfig get nodes.
İlk komutlar
Bağlantıyı ve hazır gelen parçaları şu komutlarla doğrulayın:
Terminal
kubectl cluster-info
kubectl get nodes -o wide
kubectl top nodes
kubectl get ingressclass
kubectl get storageclass
kubectl get clusterissuer| Komut | Ne görmelisiniz |
|---|---|
kubectl get nodes -o wide | Tüm düğümler Ready; düğüm adları küme adınızla başlar (-y1 yönetim, -c1, -c2 çalışanlar). |
kubectl top nodes | Düğüm başına CPU ve bellek kullanımı (kaynak ölçümleri hazır). |
kubectl get ingressclass | web sınıfı, varsayılan olarak işaretli. |
kubectl get storageclass | yerel sınıfı, varsayılan kalıcı disk. |
kubectl get clusterissuer | otomatik-ssl, READY sütununda True. |
Kendi işleriniz için ayrı bir ad alanı açmak iyi bir alışkanlıktır: kubectl create namespace uygulama, sonra komutlara -n uygulama eklersiniz.
Bağlanamıyorsanız
| Belirti | Neden ve çözüm |
|---|---|
Unable to connect to the server ya da zaman aşımı | Panelde API erişimi izinli liste ya da yalnız Kurumsal VPN olabilir; şu anki IP adresinizi listeye ekleyin ya da VPN'e bağlanın. Kurumsal ağlarda 6443 portu dışa kapalı olabilir. |
error: You must be logged in to the server (Unauthorized) | Kullandığınız kubeconfig iptal edilmiş. Panelden yenisini alın. |
x509: certificate signed by unknown authority | Dosya bozulmuş ya da başka bir kümenin dosyası. Panelden indirdiğiniz dosyayı değiştirmeden kullanın. |
| Yanlış kümeye bağlanıyor | kubectl config current-context ile hangi kümede olduğunuza bakın; KUBECONFIG değişkenini kontrol edin. |
Kümeniz yoksa
Henüz bir kümeniz yoksa birkaç dakikada açabilirsiniz; kubeconfig küme hazır olur olmaz panelde alınabilir.
- Küme yönetimi ücretsiz; yalnız düğüm olarak kullanılan bulut sunucuların fiyatını ödersiniz.
- Giriş denetleyicisi (sınıf
web), otomatik SSL (otomatik-ssl), şifreli düğüm trafiği ve 12 saatte bir küme yedeği kurulumla gelir. - Tek sunucuyla başlar, büyüdükçe panelden çalışan düğüm eklersiniz.
Hazır yapılar ve canlı fiyat Kubernetes Kümesi sayfasında; kümeyi aynı sayfadaki hesaplayıcıdan oluşturursunuz.
Sık sorulan sorular
kubeconfig dosyasını ekibimle paylaşabilir miyim?
Paylaşmayın. Dosya kümede tam yönetici yetkisi verir. Panelden her kişi için ayrı kubeconfig alın; biri ayrıldığında yalnız onun dosyasını iptal edersiniz.
kubectl sürümü kümeyle aynı olmak zorunda mı?
Hayır, ama kubectl kümenin sürümünden en fazla bir küçük sürüm ileride ya da geride olmalı. Güncel kararlı kubectl çoğu durumda doğru seçimdir.
Kubernetes API'sini yalnız ofisimizden erişilir yapabilir miyim?
Evet. Panelde küme sayfasındaki API erişimi ayarından izinli adres listesi tanımlayabilir ya da erişimi yalnız Kurumsal VPN'e açabilirsiniz. Her durumda bağlantı için ayrıca istemci sertifikası gerekir.