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
ACK konsolu sayfasında oturum açın.
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.
Sol gezinme bölmesinde Clusters seçeneğine tıklayın.
Clusters sayfasında küme adına veya Actions sütunundaki Details bağlantısına tıklayın.
Connection Information sekmesine tıklayın. kubeconfig içeriğini kopyalayın ve yerel makinenizde
./kubeconfigadıyla kaydedin.-
İ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
$APISERVERdeğişkenine atar. Sonraki tüm cURL komutlarında bu kimlik bilgileri ve$APISERVERdeğişkeni kullanılır.
-kbayrağı TLS sunucu doğrulamasını atlar. Üretim ortamlarında sunucu kimliğini doğrulamak ve ortadaki adam saldırılarını önlemek için-kyerine--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.