Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Call the Kubernetes API with client certificates

Son Güncelleme:Oct 06, 2026

Kubernetes API; GET, POST, PUT, PATCH ve DELETE işlemlerini destekleyen RESTful, kaynak tabanlı bir HTTP arayüzüdür. Bu API'yi kullanarak küme kaynaklarını kubectl olmadan programatik olarak sorgulayabilir ve yönetebilirsiniz. İstemci sertifikalarıyla kimlik doğrulaması yapın ve pod ile dağıtım (Deployment) kaynaklarını yönetmek için cURL üzerinden API'yi çağırın.

Ön koşullar

Başlamadan önce aşağıdakilerin hazır olduğundan emin olun:

  • Bir ACK kümesi

  • ACK konsoluna erişim izni

  • Yerel makinenize yüklenmiş cURL

kubeconfig dosyasından kimlik bilgilerini çıkarma

  1. ACK konsolu sayfasında oturum açın.

  2. Go to RAM console seçeneğine tıklayarak Resource Access Management Quick Authorization sayfasına gidin. Ardından Confirm Authorization Policy butonuna tıklayın. Yetkilendirme tamamlandıktan sonra ACK konsolunu yenileyin.

  3. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  4. Clusters sayfasında küme adına veya Actions sütunundaki Details bağlantısına tıklayın.

  5. Connection Information sekmesine tıklayın. kubeconfig içeriğini kopyalayın ve yerel makinenizde ./kubeconfig adıyla kaydedin.

  6. İstemci sertifikasını, özel anahtarı ve API sunucusu adresini kubeconfig dosyasından çıkarın:

    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}'`

    Bu komutlar sertifika verilerinin kodunu çözer ve API sunucusu URL'sini $APISERVER değişkenine atar. Sonraki tüm cURL komutlarında bu kimlik bilgileri ve $APISERVER değişkeni kullanılır.

-k bayrağı TLS sunucu doğrulamasını atlar. Üretim ortamlarında sunucu kimliğini doğrulamak ve ortadaki adam saldırılarını önlemek için -k yerine --cacert <path-to-ca.pem> parametresini kullanın.

Pod'ları yönetme

Tüm pod API çağrıları $APISERVER/api/v1/namespaces/<namespace>/pods yolunu kullanır.

İşlem HTTP yöntemi Yol
Tüm ad alanlarını listeleme GET /api/v1/namespaces
Tüm pod'ları listeleme GET /api/v1/namespaces/default/pods
Pod oluşturma POST /api/v1/namespaces/default/pods
Pod durumunu alma GET /api/v1/namespaces/default/pods/nginx
Pod günlüklerini alma GET /api/v1/namespaces/default/pods/nginx/log
Pod ölçümlerini alma GET /apis/metrics.k8s.io/v1beta1/namespaces/default/pods/nginx
Pod silme DELETE /api/v1/namespaces/default/pods/nginx

Kümedeki tüm ad alanlarını listeleyin:

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/api/v1/namespaces

Varsayılan ad alanındaki tüm pod'ları listeleyin:

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/api/v1/namespaces/default/pods

JSON manifestinden bir pod oluşturun:

cat nginx-pod.json
{
    "apiVersion": "v1",
    "kind": "Pod",
    "metadata": {
        "name": "nginx",
        "namespace": "default"
    },
    "spec": {
        "containers": [
            {
                "name": "nginx",
                "image": "nginx:alpine",
                "ports": [
                    {
                        "containerPort": 80
                    }
                ]
            }
        ]
    }
}

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/api/v1/namespaces/default/pods \
  -X POST --header 'content-type: application/json' -d@nginx-pod.json

YAML manifestinden bir pod oluşturun:

cat nginx-pod.yaml
apiVersion: v1
kind: Pod
metadata:
  name: nginx
  namespace: default
spec:
  containers:
  - name: nginx
    image: nginx:alpine
    ports:
    - containerPort: 80

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/api/v1/namespaces/default/pods \
  -X POST --header 'content-type: application/yaml' --data-binary @nginx-pod.yaml

Pod durumunu alın:

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/api/v1/namespaces/default/pods/nginx

Pod günlüklerini alın:

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/api/v1/namespaces/default/pods/nginx/log

Metrics Server API aracılığıyla pod ölçümlerini alın:

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/apis/metrics.k8s.io/v1beta1/namespaces/default/pods/nginx

Bir pod'u silin:

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/api/v1/namespaces/default/pods/nginx -X DELETE

Dağıtımları yönetme

Tüm dağıtım (Deployment) API çağrıları $APISERVER/apis/apps/v1/namespaces/<namespace>/deployments yolunu kullanır.

Bir dağıtım oluşturun:

cat nginx-deploy.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deploy
  labels:
    app: nginx
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:alpine
        ports:
        - containerPort: 80
        resources:
          requests:
            cpu: "2"
            memory: "4Gi"

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/apis/apps/v1/namespaces/default/deployments \
  -X POST --header 'content-type: application/yaml' --data-binary @nginx-deploy.yaml

Varsayılan ad alanındaki tüm dağıtımları listeleyin:

curl --cert ./client-cert.pem --key ./client-key.pem -k $APISERVER/apis/apps/v1/namespaces/default/deployments

Bir dağıtımı ölçeklendirin:

curl --cert ./client-cert.pem --key ./client-key.pem -k \
  $APISERVER/apis/apps/v1/namespaces/default/deployments/nginx-deploy \
  -X PATCH -H 'Content-Type: application/strategic-merge-patch+json' \
  -d '{"spec": {"replicas": 4}}'

Konteyner görüntüsünü güncelleyin:

curl --cert ./client-cert.pem --key ./client-key.pem -k \
  $APISERVER/apis/apps/v1/namespaces/default/deployments/nginx-deploy \
  -X PATCH -H 'Content-Type: application/strategic-merge-patch+json' \
  -d '{"spec": {"template": {"spec": {"containers": [{"name": "nginx","image": "nginx:1.7.9"}]}}}}'

Sonraki adımlar

cURL dışında programatik erişim sağlamak için resmi bir Kubernetes istemci kitaplığı kullanın:

Dil İstemci kitaplığı Örnekler
Go client-go Göz atın
Python client-python Göz atın
Java client-java Göz atın

Desteklenen dillerin tam listesini görmek için Kubernetes client libraries belgesine bakabilirsiniz.

Alternatif erişim yöntemlerini incelemek için Access clusters using the Kubernetes API konusunu inceleyin.