kubectl و YAML

الهدف من الدرس

ستتعلم أوامر kubectl الأساسية، بنية ملفات YAML، وكيف تنتقل من أمر سريع إلى manifest قابل للحفظ في Git.

الفكرة ببساطة

kubectl هو العميل الذي يتحدث مع Kubernetes API Server. أما YAML فهو وصف الحالة المطلوبة: ما الموارد التي تريدها؟ بأي أسماء؟ بأي إعدادات؟

الفكرة ببساطة

لا تحفظ معرفتك في terminal history. في Production الحالة المطلوبة يجب أن تكون في ملفات YAML داخل Git، ثم تطبقها بأداة واضحة مثل kubectl, Helm, Kustomize, أو Argo CD.

دورة العمل اليومية

flowchart LR
  W[اكتب YAML] --> A[kubectl apply]
  A --> API[API Server]
  API --> C[Controllers]
  C --> S[Actual State]
  S --> G[kubectl get/describe/logs]
  G --> W

أوامر قراءة الحالة

kubectl get nodes
kubectl get namespaces
kubectl get pods -A
kubectl get pod hello-pod -o wide
kubectl describe pod hello-pod
kubectl logs hello-pod
kubectl events --sort-by=.metadata.creationTimestamp

Expected output:

NAME                 STATUS   ROLES           AGE   VERSION
kind-control-plane   Ready    control-plane   10m   v1.34.0

بنية YAML

أي object في Kubernetes غالبا يبدأ بهذه الأجزاء:

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
  namespace: default
  labels:
    app: demo
data:
  APP_MODE: "dev"
  LOG_LEVEL: "debug"

الحقل	وظيفته
apiVersion	إصدار API لهذا المورد
kind	نوع المورد
metadata	الاسم، namespace، labels، annotations
spec أو data	الحالة المطلوبة أو البيانات حسب نوع المورد

تطبيق وتعديل وحذف

kubectl apply -f configmap.yaml
kubectl get configmap app-config -o yaml
kubectl diff -f configmap.yaml
kubectl delete -f configmap.yaml

استخدم kubectl diff قبل التعديل عندما تريد معرفة ما الذي سيتغير.

أوامر مفيدة بدون حفظ

إنشاء YAML مبدئي بدون تطبيق:

kubectl create deployment web --image=nginx:1.27 --dry-run=client -o yaml > deployment.yaml
kubectl create service clusterip web --tcp=80:80 --dry-run=client -o yaml > service.yaml

شرح سريع:

الخيار	المعنى
--dry-run=client	لا يرسل المورد إلى cluster
-o yaml	اطبع الناتج بصيغة YAML
>	احفظ الناتج في ملف

Namespaces و Contexts

kubectl config get-contexts
kubectl config current-context
kubectl config set-context --current --namespace=default
kubectl get pods --namespace kube-system

لا تعمل على namespace خطأ. قبل أي أمر حساس، نفذ:

kubectl config current-context
kubectl config view --minify --output 'jsonpath={..namespace}'

أخطاء شائعة

الخطأ	السبب	الحل
error: no context exists	kubeconfig غير مضبوط	راجع kubectl config get-contexts
the server doesn't have a resource type	kind أو apiVersion خطأ	استخدم kubectl api-resources
forbidden	صلاحيات RBAC غير كافية	افحص kubectl auth can-i
YAML لا يطبق	indentation أو field خطأ	استخدم kubectl apply --dry-run=server -f file.yaml

Lab: من أمر سريع إلى YAML قابل للحفظ

المستوى: مبتدئ الوقت: 35 دقيقة الأدوات: kubectl

الهدف: توليد Deployment و Service بصيغة YAML، مراجعة الفرق، ثم تطبيقهما.

Prerequisites

• Cluster محلي يعمل.
• صلاحية إنشاء Deployment و Service في namespace الحالي.

Steps

1. ولد Deployment:

kubectl create deployment web --image=nginx:1.27 --dry-run=client -o yaml > deployment.yaml

2. ولد Service:

kubectl create service clusterip web --tcp=80:80 --dry-run=client -o yaml > service.yaml

3. راجع الملفات، ثم طبقها:

kubectl diff -f deployment.yaml
kubectl apply -f deployment.yaml
kubectl apply -f service.yaml

4. افحص الموارد:

kubectl get deploy,svc,pods -l app=web

Expected output

deployment.apps/web created
service/web created
NAME                  READY   UP-TO-DATE   AVAILABLE
deployment.apps/web   1/1     1            1

Cleanup

kubectl delete -f service.yaml
kubectl delete -f deployment.yaml

الربط بالمشروع النهائي

كل مشروع ستبنيه سيبدأ بملفات YAML واضحة، ثم سيتطور إلى Helm و GitOps. إتقان kubectl و YAML هو أساس كل شيء بعد ذلك.

اختبر فهمك

متى تستخدم `kubectl create --dry-run=client -o yaml`؟

إظهار الإجابة

عندما تريد توليد ملف YAML كبداية، ثم تعدله وتحفظه في Git بدلا من إنشاء المورد مباشرة بأمر مؤقت.