> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# kubectl للمبتدئين: الأوامر التي تستخدمها كل يوم
- URL: https://arabroot.io/articles/اوامر-kubectl-اليومية-للمبتدئين/
- Published: 2026-11-18T19:43:28.000Z
- Updated: 2026-11-18T20:42:41.000Z
- Description: الأوامر التي تكتبها كل يوم على عنقود Kubernetes بالترتيب الذي تحتاجها فيه، مع إعادة إنتاج CrashLoopBackOff وImagePullBackOff وإصلاحهما على عنقود حقيقي.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الحاويات Containers وتنسيقها مع Kubernetes, DevOps وCI/CD, Docker والحاويات, الاستضافة الذاتية

في أول أسبوع مع Kubernetes سوف تكتب الأمر `kubectl get pods` مئات المرات، ثم يأتي يوم تكتبه فيرد عليك بسطر واحد: `No resources found in default namespace`، وأنت متأكد أن تطبيقك Application يعمل. وفي يوم آخر ترى ال Pod بالحالة Status `CrashLoopBackOff` فتكتب `kubectl logs` فتجد السجل Log فارغاً، أو تحدث ال Image بوسم Tag فيه خطأ مطبعي فيبقى نصف التطبيق على النسخة Version القديمة ونصفه لا يعمل. وأغلب هذه المواقف لا تحتاج أمراً جديداً، وإنما تحتاج أن تعرف ماذا يفعل الأمر الذي تكتبه كل يوم، وأين يبحث، وما الذي لا يقوله لك.

وفي [مصطلحات Kubernetes بالرسم](https://arabroot.io/articles/%D9%85%D8%B5%D8%B7%D9%84%D8%AD%D8%A7%D8%AA-kubernetes-%D8%A8%D8%A7%D9%84%D8%B1%D8%B3%D9%85/) شرحنا الكائنات Objects نفسها، وفي مقال Kubernetes من الداخل بنينا عنقوداً Cluster من ثلاث عقد Nodes بأداة kind ورأينا كيف يتعامل ال API Server مع كل طلب Request. وهذا المقال يعمل على العنقود نفسه، فيمر على الأوامر التي تحتاجها كل يوم بالترتيب الذي تستخدمها فيه، ثم يعيد إنتاج أشهر عطلين يواجههما المبتدئ، وهما CrashLoopBackOff وImagePullBackOff، ويصلحهما خطوة خطوة، والمخرجات Outputs كلها من التجربة.

وسوف نناقش في هذا المقال ما يلي:

- ملف الإعداد kubeconfig والسياقات Contexts وال Namespaces، وكيف تعرف على أي عنقود تعمل قبل أن تكتب أمراً.
- القراءة: `get` بصيغ العرض Output Formats المختلفة، و`describe` والأحداث Events، والأمر `explain`.
- الوصول إلى التطبيق: `logs` و`exec` و`port-forward` و`debug`.
- التغيير: `apply` و`diff` و`rollout` و`scale`، والفرق الذي يظهر بين الملف والعنقود.
- العلامات Labels والمحددات Selectors، واستهلاك الموارد بالأمر `top`.
- تشخيص الأعطال Troubleshooting: إعادة إنتاج CrashLoopBackOff وImagePullBackOff وإصلاحهما.

## ماذا يفعل kubectl فعلاً؟

kubectl برنامج عميل Client فقط، فهو لا يشغل Containers ولا يتصل بالعقد، وإنما يحول كل أمر تكتبه إلى طلب HTTPS إلى ال API Server ثم يطبع الرد بشكل مقروء. وهذا يفسر أشياء كثيرة ستراها: الأمر `kubectl apply` ينجح فور أن يحفظ ال API Server ما أرسلته، وليس عندما يعمل التطبيق، والأمر `kubectl logs` يطلب من ال API Server أن يجلب السجل من ال kubelet على العقدة، فإذا كانت العقدة متوقفة فلن تحصل على السجل. ولذلك تحتاج بعد كل تغيير أمراً ثانياً يخبرك بالنتيجة، مثل `kubectl rollout status`، وسوف نستخدمه كثيراً.

وهناك طريقتان لاستخدام kubectl في التغيير، وسوف تراهما في كل شرح. الطريقة المباشرة Imperative أن تكتب ما تريد فعله في الأمر نفسه: `kubectl create deployment` و`kubectl scale` و`kubectl set image`، وهي سريعة ومناسبة للتجربة والطوارئ. والطريقة التصريحية Declarative أن تكتب ما تريد أن يكون في ملف، ثم ترسل الملف ب `kubectl apply`، فيحسب kubectl والعنقود الفرق ويطبقانه. وهذا المقال يستخدم الطريقتين، ولكن تذكر من الآن القاعدة التي سنصل إليها بالتجربة في قسم التراجع: كل تغيير مباشر يجعل العنقود مختلفاً عن ملفاتك، حتى تصححها.

وقبل أن تبدأ اجعل الكتابة أسهل، فأغلب من يعمل مع Kubernetes كل يوم يعرف اختصاراً Alias من حرف واحد مثل `alias k=kubectl`، ويفعل الإكمال التلقائي Completion بالأمر `kubectl completion bash` أو `kubectl completion zsh` في ملف إعداد الطرفية Shell، فيكمل له أسماء ال Pods وال Namespaces بالمفتاح Tab بدل نسخها. وهذا ليس ترفاً، فأسماء ال Pods فيها حروف عشوائية، والخطأ في حرف واحد يعني أمراً على Pod آخر أو رسالة `NotFound`.

والإصدار Version مهم، لأن kubectl يدعم فرقاً بإصدار واحد عن ال API Server صعوداً ونزولاً بحسب [سياسة اختلاف الإصدارات Version Skew Policy](https://kubernetes.io/releases/version-skew-policy/?ref=arabroot.io)، والنسخة التي استخدمناها v1.36.1 مع عنقود v1.36.4:

```bash
kubectl version
```

```text
Client Version: v1.36.1
Kustomize Version: v5.8.1
Server Version: v1.36.4
```

## على أي عنقود Cluster تعمل الآن؟ kubeconfig والسياقات Contexts

kubectl يقرأ عنوان Address العنقود وشهادة الدخول Certificate من ملف واحد اسمه kubeconfig، وهو افتراضياً `~/.kube/config`، أو الملف الذي يشير إليه متغير البيئة Environment Variable `KUBECONFIG`، وفي التجربة جعلناه ملفاً خاصاً بالعنقود حتى لا نخلطه بغيره. والملف فيه ثلاث قوائم: العناقيد Clusters، والمستخدمون Users، والسياقات Contexts، والسياق هو اسم يجمع عنقوداً ومستخدماً وNamespace افتراضياً:

```bash
kubectl config get-contexts
kubectl config view --minify
```

```text
CURRENT   NAME      CLUSTER   AUTHINFO   NAMESPACE
*         kind-k1   kind-k1   kind-k1

apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: DATA+OMITTED
    server: https://127.0.0.1:49342
  name: kind-k1
contexts:
- context:
    cluster: kind-k1
    user: kind-k1
  name: kind-k1
current-context: kind-k1
kind: Config
users:
- name: kind-k1
  user:
    client-certificate-data: DATA+OMITTED
    client-key-data: DATA+OMITTED
```

في المخرج أعلاه لاحظ التالي:

- النجمة في العمود `CURRENT` هي السياق الحالي Current Context، وكل أمر لا تذكر فيه `--context` يذهب إليه، وعمود `NAMESPACE` فارغ، أي أن ال Namespace الافتراضي هو `default`.
- الخيار `--minify` يعرض السياق الحالي فقط، وkubectl يخفي الشهادات بالكلمة `DATA+OMITTED`. ولكن الملف نفسه فيه المفتاح الخاص Private Key كاملاً، وهو يعطي صلاحية Permission المدير على العنقود كله، فعامله معاملة كلمة المرور ولا ترسله في محادثة أو تضعه في مستودع Git.

والآن ننشئ Namespace للتجربة اسمه `demo`، وسياقاً ثانياً على العنقود نفسه يجعله الافتراضي، حتى لا نكتب `-n demo` في كل أمر:

```bash
kubectl create namespace demo
kubectl config set-context demo --cluster=kind-k1 --user=kind-k1 --namespace=demo
kubectl config use-context demo
kubectl config get-contexts
kubectl get pods
```

```text
namespace/demo created
Context "demo" created.
Switched to context "demo".
CURRENT   NAME      CLUSTER   AUTHINFO   NAMESPACE
*         demo      kind-k1   kind-k1    demo
          kind-k1   kind-k1   kind-k1
No resources found in demo namespace.
```

![ملف k1.kubeconfig فيه ثلاث قوائم: clusters فيها kind-k1 إلى 127.0.0.1:49342، وusers فيها kind-k1 بشهادة، وcontexts فيها kind-k1 وdemo، والسياقان على نفس العنقود والمستخدم، والفرق أن demo يجعل ال Namespace الافتراضي demo وهو السياق الحالي، ونفس الأمر kubectl get pods يعرض ال Pods في demo، ومع --context kind-k1 يرد No resources found in default namespace](https://arabroot.io/content/images/2026/11/kubectl-basics-01-kubeconfig.webp)

السياق يجمع العنقود والمستخدم وال Namespace، ونفس الأمر يعطي نتيجتين بحسب السياق

وهذا هو أول خطأ يقع فيه كل من يعمل على أكثر من عنقود: يكتب أمراً وهو يظن أنه على عنقود التجربة، وهو على عنقود الإنتاج Production. والحل ليس أن تنتبه أكثر، وإنما أن تجعل السياق ظاهراً دائماً، فاعرضه في سطر الأوامر Prompt كما شرحنا في [تخصيص سطر الأوامر مع Starship](https://arabroot.io/articles/%D8%B3%D8%B7%D8%B1-%D8%A7%D9%84%D8%A7%D9%88%D8%A7%D9%85%D8%B1-prompt-%D9%85%D8%B9-starship-%D9%88-oh-my-posh-%D9%88-oh-my-zsh/)، واكتب `--context` صراحة في السكربتات Scripts، واجعل لعنقود الإنتاج ملف kubeconfig منفصلاً لا تحمله إلا عندما تحتاجه.

والعكس أيضاً يحدث، وهو أن تبحث عن شيء موجود في Namespace آخر. فهنا نسأل بالسياق القديم الذي يستخدم `default`، ثم نذكر ال Namespace صراحة:

```bash
kubectl --context kind-k1 get pods
kubectl get pods -n demo --context kind-k1 -l app=crashy
```

```text
No resources found in default namespace.
NAME                      READY   STATUS    RESTARTS   AGE
crashy-6968d5bd47-kkxxk   1/1     Running   0          5m
```

فالرسالة `No resources found` لا تعني أن تطبيقك غير موجود، وإنما أنه غير موجود في هذا ال Namespace، واقرأ آخر كلمة فيها دائماً. وإذا لم تعرف أين هو فالخيار `-A` واختصاره من `--all-namespaces` يبحث في كل ال Namespaces.

## أنواع الكائنات Objects واختصاراتها: api-resources

كل نوع من الكائنات له اسم كامل واسم مختصر Short Name، والأمر `api-resources` يعرضها كلها من العنقود نفسه، ومعها المجموعة API Group والإصدار، وهل الكائن داخل Namespace أم على مستوى العنقود كله:

```bash
kubectl api-resources | grep -E '^(pods|services|deployments|replicasets|namespaces|configmaps|persistentvolumeclaims|nodes|events) '
```

```text
configmaps                          cm           v1                                true         ConfigMap
events                              ev           v1                                true         Event
namespaces                          ns           v1                                false        Namespace
nodes                               no           v1                                false        Node
persistentvolumeclaims              pvc          v1                                true         PersistentVolumeClaim
pods                                po           v1                                true         Pod
services                            svc          v1                                true         Service
deployments                         deploy       apps/v1                           true         Deployment
replicasets                         rs           apps/v1                           true         ReplicaSet
events                              ev           events.k8s.io/v1                  true         Event
```

في المخرج أعلاه لاحظ التالي:

- العمود الثاني هو الاختصار الذي تستخدمه في الأوامر، فالأمر `kubectl get deploy,rs,svc` يساوي الأسماء الكاملة، وهذا ما سنستخدمه في بقية المقال.
- العمود الرابع يقول هل النوع داخل Namespace، فال Nodes وال Namespaces نفسها قيمتها `false`، ولذلك لا يؤثر الخيار `-n` عليها، والأمر `kubectl get nodes -n demo` يعرض كل العقد.
- النوع `events` يظهر مرتين، مرة في المجموعة الأساسية `v1` ومرة في `events.k8s.io/v1` الأحدث، وهو نفس الكائن بواجهتين، وهذا سبب الفرق بين `kubectl get events` و`kubectl events` الذي سيأتي.

وإذا ثبت أداة تضيف أنواعاً جديدة، مثل المشغل Operator في [CloudNativePG](https://arabroot.io/articles/postgresql-%D8%B9%D9%84%D9%89-kubernetes-%D9%85%D8%B9-cloudnativepg/)، فسوف تظهر أنواعها هنا أيضاً، ويعمل معها `get` و`describe` و`explain` بنفس الطريقة، فهذه الأوامر لا تعرف الأنواع مسبقاً وإنما تسأل ال API Server عنها.

## ابدأ ملف YAML من kubectl نفسه

كتابة ملف Deployment من الذاكرة تنتهي غالباً بخطأ في المسافات أو في اسم حقل، والأسهل أن تجعل kubectl يكتب لك البداية بالخيار `--dry-run=client -o yaml`، فيطبع الكائن الذي كان سيرسله دون أن يرسله:

```bash
kubectl create deployment hello --image=nginx:1.29.8-alpine --replicas=2 --port=80 --dry-run=client -o yaml > hello.yaml
```

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: hello
  name: hello
spec:
  replicas: 2
  selector:
    matchLabels:
      app: hello
  strategy: {}
  template:
    metadata:
      labels:
        app: hello
    spec:
      containers:
      - image: nginx:1.29.8-alpine
        name: nginx
        ports:
        - containerPort: 80
        resources: {}
status: {}
```

ولا تستخدم الملف كما هو، فالحقول الفارغة `strategy: {}` و`resources: {}` و`status: {}` لا تفيد، و`status` بالذات يكتبه العنقود وليس أنت. وإذا لم تعرف ماذا يقبل حقل ما فالأمر `explain` يقرأ الوصف من ال API Server نفسه، فهو مطابق لإصدار عنقودك دائماً، وهذا أفضل من صفحة وثائق لإصدار آخر:

```bash
kubectl explain deployment.spec.strategy
```

```text
GROUP:      apps
KIND:       Deployment
VERSION:    v1

FIELD: strategy <DeploymentStrategy>

DESCRIPTION:
    The deployment strategy to use to replace existing pods with new ones.
    DeploymentStrategy describes how to replace existing pods with new ones.

FIELDS:
  rollingUpdate	<RollingUpdateDeployment>
    Rolling update config params. Present only if DeploymentStrategyType =
    RollingUpdate.

  type	<string>
  enum: Recreate, RollingUpdate
    Type of deployment. Can be "Recreate" or "RollingUpdate". Default is
    RollingUpdate.
```

وبعد التنظيف أضفنا Label ثانياً اسمه `tier`، وحدوداً للموارد Resources، وService أمام ال Pods، فأصبح الملف كما يلي:

```yaml
# Started from: kubectl create deployment hello ... --dry-run=client -o yaml
# then cleaned up: empty fields removed, labels, resources and a Service added.
apiVersion: apps/v1
kind: Deployment
metadata:
  name: hello
  labels:
    app: hello
    tier: frontend
spec:
  replicas: 2
  selector:
    matchLabels:
      app: hello
  template:
    metadata:
      labels:
        app: hello
        tier: frontend
    spec:
      containers:
        - name: nginx
          image: nginx:1.29.8-alpine
          ports:
            - containerPort: 80
          resources:
            requests:
              cpu: 50m
              memory: 32Mi
            limits:
              memory: 64Mi
---
apiVersion: v1
kind: Service
metadata:
  name: hello
spec:
  selector:
    app: hello
  ports:
    - port: 80
      targetPort: 80
```

```bash
kubectl apply -f hello.yaml
kubectl rollout status deploy/hello --timeout=120s
```

```text
deployment.apps/hello created
service/hello created
deployment "hello" successfully rolled out
```

## القراءة بالأمر get: كائن Object واحد وعدة طرق لعرضه

الأمر `get` يقرأ الكائنات ويعرضها جدولاً مختصراً، والخيار `-o` يغير طريقة العرض Output Format دون أن يغير ما يقرؤه، فكل العروض التالية جاءت من نفس الطلب إلى ال API Server:

```bash
kubectl get pods
kubectl get pods -o wide
kubectl get pods --show-labels
```

```text
NAME                     READY   STATUS    RESTARTS   AGE
hello-5895659ccd-5gsc6   1/1     Running   0          21s
hello-5895659ccd-sqfgc   1/1     Running   0          21s

NAME                     READY   STATUS    RESTARTS   AGE   IP            NODE         NOMINATED NODE   READINESS GATES
hello-5895659ccd-5gsc6   1/1     Running   0          23s   10.244.1.16   k1-worker    <none>           <none>
hello-5895659ccd-sqfgc   1/1     Running   0          23s   10.244.2.2    k1-worker2   <none>           <none>

NAME                     READY   STATUS    RESTARTS   AGE   LABELS
hello-5895659ccd-5gsc6   1/1     Running   0          24s   app=hello,pod-template-hash=5895659ccd,tier=frontend
hello-5895659ccd-sqfgc   1/1     Running   0          24s   app=hello,pod-template-hash=5895659ccd,tier=frontend
```

في المخرج أعلاه لاحظ التالي:

- اسم كل Pod فيه ثلاثة أجزاء: اسم ال Deployment، ثم بصمة ال Template، ثم خمسة حروف عشوائية، والبصمة `5895659ccd` تظهر أيضاً كقيمة لل Label المسمى `pod-template-hash`، وهو ما يميز Pods كل نسخة من الملف عن الأخرى أثناء التحديث Update.
- العمود `READY` يقول `1/1`، أي Container واحد من واحد جاهز، وهذا يختلف عن `STATUS`، فقد يكون ال Pod بحالة `Running` وجاهزيته `0/1` لأن فحص الجاهزية Readiness Probe لم ينجح بعد.
- الخيار `-o wide` يضيف عنوان ال Pod والعقدة، وهو أول ما تحتاجه عندما تشك أن المشكلة في عقدة واحدة.

وتستطيع أن تطلب أكثر من نوع في أمر واحد، ولكن انتبه لما يحدث مع ال Selector:

```bash
kubectl get deploy,rs,svc,pods -l app=hello
```

```text
NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/hello   2/2     2            2           27s

NAME                               DESIRED   CURRENT   READY   AGE
replicaset.apps/hello-5895659ccd   2         2         2       26s

NAME                         READY   STATUS    RESTARTS   AGE
pod/hello-5895659ccd-5gsc6   1/1     Running   0          26s
pod/hello-5895659ccd-sqfgc   1/1     Running   0          26s
```

ال Service غير موجود في المخرج رغم أنه موجود في العنقود، والسبب أن الخيار `-l app=hello` يبحث عن الكائنات التي تحمل هذا ال Label، وال Service في ملفنا ليس عليه Labels أصلاً، وإنما فيه Selector بنفس القيمة، والاثنان شيئان مختلفان: ال Label اسم على الكائن نفسه، وال Selector سؤال يطرحه الكائن عن غيره. لذلك ضع Labels على كل كائن في ملفاتك، وليس على ال Pods فقط، حتى يعمل البحث والحذف بال Label كما تتوقع.

### لماذا لا يعرض get all كل شيء؟

الأمر `kubectl get all` يبدو كأنه يعرض كل ما في ال Namespace، وهذا ما ظهر في ال Namespace المسمى `demo` بعد تجارب هذا المقال:

```bash
kubectl get all -n demo
```

```text
NAME                          READY   STATUS    RESTARTS   AGE
pod/crashy-6968d5bd47-kkxxk   1/1     Running   0          4m19s
pod/hello-5895659ccd-2qng5    1/1     Running   0          18m
pod/hello-5895659ccd-98tcj    1/1     Running   0          17m
pod/hello-5895659ccd-rpzmv    1/1     Running   0          17m
pod/hello-5895659ccd-xns99    1/1     Running   0          70s

NAME            TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)   AGE
service/hello   ClusterIP   10.96.127.172   <none>        80/TCP    25m

NAME                     READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/crashy   1/1     1            1           9m35s
deployment.apps/hello    4/4     4            4           25m

NAME                                DESIRED   CURRENT   READY   AGE
replicaset.apps/crashy-6968d5bd47   1         1         1       4m20s
replicaset.apps/crashy-8478b79f97   0         0         0       9m35s
replicaset.apps/hello-5895659ccd    4         4         4       25m
replicaset.apps/hello-6795db798f    0         0         0       20m
replicaset.apps/hello-6f45595854    0         0         0       3m43s
```

وال ConfigMap المسمى `crashy-config` الذي أنشأناه في قسم CrashLoopBackOff غير موجود في المخرج، وكذلك ال Secrets وال PersistentVolumeClaims وال Ingresses، لأن `all` مجموعة ثابتة من الأنواع الشائعة فقط، وليست كل شيء. فلا تعتمد عليه لتعرف ما سيحذف مع ال Namespace، واطلب الأنواع بالاسم: `kubectl get cm,secret,pvc -n demo`. ولاحظ أيضاً ال ReplicaSets القديمة بعدد صفر، فكل واحدة منها مراجعة يمكن الرجوع إليها، ويحتفظ ال Deployment بعشر منها افتراضياً بحسب الحقل `revisionHistoryLimit`.

### jsonpath وcustom-columns للسكربتات Scripts

عندما تحتاج حقلاً واحداً في سكربت فلا تقطع الجدول العادي بأدوات مثل `awk`، لأن الأعمدة تتغير بين الإصدارات وبين الخيارات، وإنما اطلب الحقل بالاسم من الكائن نفسه:

```bash
kubectl get pods -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.status.podIP}{"\t"}{.spec.nodeName}{"\n"}{end}'
kubectl get pods -o custom-columns=NAME:.metadata.name,IMAGE:.spec.containers[0].image,NODE:.spec.nodeName,START:.status.startTime
```

```text
hello-5895659ccd-5gsc6	10.244.1.16	k1-worker
hello-5895659ccd-sqfgc	10.244.2.2	k1-worker2

NAME                     IMAGE                 NODE         START
hello-5895659ccd-5gsc6   nginx:1.29.8-alpine   k1-worker    2026-11-18T18:26:31Z
hello-5895659ccd-sqfgc   nginx:1.29.8-alpine   k1-worker2   2026-11-18T18:26:30Z
```

وكيف تعرف اسم الحقل؟ اعرض الكائن كاملاً بالخيار `-o yaml` مرة واحدة، وابحث فيه عن القيمة التي تريدها، ثم اكتب مسارها. وهذا جزء الحالة `status` من أحد ال Pods، وهو الجزء الذي يكتبه العنقود ولا تكتبه أنت:

```bash
kubectl get pod hello-5895659ccd-5gsc6 -o yaml | sed -n '/^status:/,$p' | head -24
```

```text
status:
  allocatedResources:
    cpu: 50m
    memory: 32Mi
  conditions:
  - lastProbeTime: null
    lastTransitionTime: "2026-11-18T18:26:36Z"
    observedGeneration: 1
    status: "True"
    type: PodReadyToStartContainers
  - lastProbeTime: null
    lastTransitionTime: "2026-11-18T18:26:31Z"
    observedGeneration: 1
    status: "True"
    type: Initialized
  - lastProbeTime: null
    lastTransitionTime: "2026-11-18T18:26:39Z"
    observedGeneration: 1
    status: "True"
    type: Ready
  - lastProbeTime: null
    lastTransitionTime: "2026-11-18T18:26:39Z"
    observedGeneration: 1
    status: "True"
    type: ContainersReady
```

والأوقات هنا تحكي ما حدث لل Pod بالترتيب: جدولته في 18:26:30، ثم التهيئة Initialized في 18:26:31، ثم جاهزية الشبكة في 18:26:36، ثم أصبح جاهزاً Ready في 18:26:39، أي تسع ثوان من الجدولة إلى استقبال الطلبات. والقواعد الكاملة لكتابة المسارات في [صفحة JSONPath في kubectl](https://kubernetes.io/docs/reference/kubectl/jsonpath/?ref=arabroot.io).

![Pod واحد hello-5895659ccd-5gsc6 كما في ال API Server تتفرع منه خمسة عروض: الافتراضي بأعمدة مختصرة للنظرة السريعة، و-o wide بال IP والعقدة، و-o yaml بالكائن كاملاً spec مع status، و-o jsonpath لحقول محددة للسكربتات، وcustom-columns لجدول تختار أعمدته، ومعها خيارات -l و-L و--sort-by و-w](https://arabroot.io/content/images/2026/11/kubectl-basics-02-get-views.webp)

كل العروض تقرأ نفس الكائن، والفرق فيما يطبعه kubectl

## describe والأحداث Events: ماذا حدث لهذا الكائن؟

الأمر `describe` يجمع في صفحة واحدة الكائن نفسه مع ما يتعلق به، وأهم ما فيه آخر قسم، وهو الأحداث Events التي كتبتها الأجزاء المختلفة عن هذا الكائن:

```bash
kubectl describe pod hello-5895659ccd-5gsc6
```

```text
Name:             hello-5895659ccd-5gsc6
Namespace:        demo
Node:             k1-worker/172.24.0.4
Labels:           app=hello
                  pod-template-hash=5895659ccd
                  tier=frontend
Status:           Running
IP:               10.244.1.16
Controlled By:  ReplicaSet/hello-5895659ccd
Containers:
  nginx:
    Image:          nginx:1.29.8-alpine
    Image ID:       docker.io/library/nginx@sha256:5616878291a2eed594aee8db4dade5878cf7edcb475e59193904b198d9b830de
    State:          Running
      Started:      Wed, 18 Nov 2026 21:26:39 +0300
    Ready:          True
    Restart Count:  0
    Limits:
      memory:  64Mi
    Requests:
      cpu:        50m
      memory:     32Mi
QoS Class:                   Burstable
Tolerations:                 node.kubernetes.io/not-ready:NoExecute op=Exists for 300s
                             node.kubernetes.io/unreachable:NoExecute op=Exists for 300s
Events:
  Type    Reason     Age   From               Message
  ----    ------     ----  ----               -------
  Normal  Scheduled  69s   default-scheduler  Successfully assigned demo/hello-5895659ccd-5gsc6 to k1-worker
  Normal  Pulled     64s   kubelet            spec.containers{nginx}: Container image "nginx:1.29.8-alpine" already present on machine and can be accessed by the pod
  Normal  Created    63s   kubelet            spec.containers{nginx}: Container created
  Normal  Started    61s   kubelet            spec.containers{nginx}: Container started
```

واختصرنا من المخرج بعض الأسطر، وفيما بقي لاحظ التالي:

- `Controlled By` يقول من يملك هذا ال Pod، وهو ال ReplicaSet، فإذا حذفته سوف ينشئ ال ReplicaSet بديلاً، وإذا أردت أن يختفي فاحذف المالك أو غير عدد النسخ.
- `Image ID` هو البصمة Digest التي سحبها ال kubelet فعلاً، وهي التي تحدد ما يعمل، وليس الوسم، كما شرحنا في [ما هي ال Containers](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%8A-%D8%A7%D9%84-containers-%D9%88%D8%A7%D9%84%D9%81%D8%B1%D9%82-%D8%A8%D9%8A%D9%86%D9%87%D8%A7-%D9%88%D8%A8%D9%8A%D9%86-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9-%D8%A7%D9%84%D8%A7%D9%81%D8%AA%D8%B1%D8%A7%D8%B6%D9%8A%D8%A9/).
- `QoS Class: Burstable` لأن الطلب أقل من الحد، وهذه الفئة تحدد من يخرج أولاً عندما تمتلئ ذاكرة العقدة، ونعود إليها في مقال حدود الموارد.
- عمود `From` في الأحداث يقول من كتب كل حدث: المجدول `default-scheduler` كتب الجدولة، وال `kubelet` كتب الباقي، فإذا توقفت الأحداث عند Scheduled فالمشكلة على العقدة، وإذا لم يوجد Scheduled أصلاً فالمشكلة في الجدولة.

والأحداث تحفظ ساعة واحدة افتراضياً ثم تحذف، فإذا جئت تبحث في عطل حدث أمس فلن تجد شيئاً هنا، ولذلك تحتاج نظام سجلات يجمعها كما في [سجل التدقيق Audit Trail](https://arabroot.io/articles/%D8%B3%D8%AC%D9%84-%D8%A7%D9%84%D8%AA%D8%AF%D9%82%D9%8A%D9%82-audit-trail-%D9%85%D9%86-%D9%81%D8%B9%D9%84-%D9%85%D8%A7%D8%B0%D8%A7-%D9%88%D9%85%D8%AA%D9%89/#kubernetes). ولعرض أحداث ال Namespace كلها مرتبة بالوقت استخدم `kubectl events`، فهو أوضح من `kubectl get events` القديم الذي قد يعرض الأحداث دون ترتيب صحيح.

## السجلات Logs والدخول: logs وexec وport-forward

### kubectl logs

السجل Log الذي تقرؤه هو ما كتبه ال Container على المخرج القياسي stdout والخطأ القياسي stderr، تماماً كما في `docker logs` الذي شرحناه في [أوامر Docker الأساسية](https://arabroot.io/articles/%D8%A7%D9%88%D8%A7%D9%85%D8%B1-docker-%D8%A7%D9%84%D8%A7%D8%B3%D8%A7%D8%B3%D9%8A%D8%A9-%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D9%88%D8%A7%D9%84%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%A7%D9%8A%D9%82%D8%A7%D9%81/)، فإذا كان تطبيقك يكتب سجله في ملف داخل ال Container فلن تراه هنا. والفرق أن ال Pods كثيرة وأسماؤها تتغير، فتحتاج طرقاً تختار بها:

```bash
kubectl logs hello-5895659ccd-5gsc6 --tail=3
kubectl logs -l app=hello --prefix --tail=2
kubectl logs deploy/hello --since=5m | tail -2
```

```text
2026/11/18 18:26:41 [notice] 1#1: start worker process 39
2026/11/18 18:26:41 [notice] 1#1: start worker process 40
2026/11/18 18:26:41 [notice] 1#1: start worker process 41

[pod/hello-5895659ccd-5gsc6/nginx] 2026/11/18 18:26:41 [notice] 1#1: start worker process 40
[pod/hello-5895659ccd-5gsc6/nginx] 2026/11/18 18:26:41 [notice] 1#1: start worker process 41
[pod/hello-5895659ccd-sqfgc/nginx] 127.0.0.1 - - [18/Nov/2026:18:28:25 +0000] "GET /missing HTTP/1.1" 404 153 "-" "curl/8.12.1" "-"
[pod/hello-5895659ccd-sqfgc/nginx] 2026/11/18 18:28:25 [error] 37#37: *2 open() "/usr/share/nginx/html/missing" failed (2: No such file or directory), client: 127.0.0.1, server: localhost, request: "GET /missing HTTP/1.1", host: "127.0.0.1:9573"

Found 2 pods, using pod/hello-5895659ccd-sqfgc
127.0.0.1 - - [18/Nov/2026:18:28:25 +0000] "GET /missing HTTP/1.1" 404 153 "-" "curl/8.12.1" "-"
```

في المخرج أعلاه لاحظ التالي:

- الخيار `-l app=hello` يجمع سجلات كل ال Pods التي تطابق ال Selector، و`--prefix` يضيف أمام كل سطر اسم ال Pod وال Container، ودونه لن تعرف أي سطر من أي نسخة.
- الأمر `logs deploy/hello` يختار Pod واحداً فقط ويقول ذلك في السطر `Found 2 pods, using pod/…`، فإذا كان الطلب الذي تبحث عنه وصل إلى النسخة الأخرى فلن تجده، وهذا خطأ شائع عند البحث عن طلب فشل.
- الطلب إلى `/missing` ظهر في سجل ال Pod الثاني فقط، لأن ال Service وزع الاتصال Connection على نسخة واحدة، وعنوان العميل `127.0.0.1` لأن الطلب جاء عبر port-forward كما سيأتي.

### kubectl exec

الأمر `exec` يشغل برنامجاً داخل Container يعمل، وهو أسرع طريقة لتعرف ماذا يرى التطبيق من الداخل: هل يجد ال Service بالاسم؟ ما المتغيرات Environment Variables التي وصلته؟ وما الإصدار الذي يعمل فعلاً؟

```bash
kubectl exec hello-5895659ccd-5gsc6 -- nginx -v
kubectl exec hello-5895659ccd-5gsc6 -- sh -c 'hostname; head -2 /etc/os-release; wget -qO- http://hello | grep -o "<title>.*</title>"'
kubectl exec hello-5895659ccd-5gsc6 -- env | grep -E 'HELLO_SERVICE|KUBERNETES_SERVICE_HOST'
```

```text
nginx version: nginx/1.29.8

hello-5895659ccd-5gsc6
NAME="Alpine Linux"
ID=alpine
<title>Welcome to nginx!</title>

HELLO_SERVICE_HOST=10.96.127.172
HELLO_SERVICE_PORT=80
KUBERNETES_SERVICE_HOST=10.96.0.1
```

والعلامة `--` تفصل خيارات kubectl عن الأمر الذي يشغله، فكل ما بعدها يذهب إلى ال Container كما هو. ولاحظ المتغيرات في آخر المخرج، فال kubelet يضيف لكل Pod متغيرين لكل Service كان موجوداً في ال Namespace عند إنشاء ال Pod، وهذه طريقة قديمة لاكتشاف الخدمات Service Discovery، ولا تعتمد عليها، والسبب أن ال Service الذي ينشأ بعد ال Pod لا يظهر في متغيراته، أما الاسم `hello` عبر DNS فيعمل دائماً.

### kubectl port-forward

ال Service من النوع ClusterIP لا يصل إليه أحد من خارج العنقود، والأمر `port-forward` يفتح منفذاً Port على جهازك وينقل كل اتصال عليه إلى ال Service أو إلى Pod، عبر ال API Server وال kubelet:

```bash
kubectl port-forward svc/hello 9573:80 &
curl -s http://127.0.0.1:9573/ | grep -o '<title>.*</title>'
curl -sI http://127.0.0.1:9573/ | head -3
```

```text
Forwarding from 127.0.0.1:9573 -> 80
Forwarding from [::1]:9573 -> 80
Handling connection for 9573
<title>Welcome to nginx!</title>
Handling connection for 9573
HTTP/1.1 200 OK
Server: nginx/1.29.8
Date: Wed, 18 Nov 2026 18:30:41 GMT
```

والمنفذ مفتوح على `127.0.0.1` فقط، أي على جهازك وحده، وهذا هو الصحيح، فلا تضف `--address 0.0.0.0` إلا إذا كنت تعرف من يستطيع الوصول إلى جهازك. ولاحظ أن port-forward إلى Service لا يوزع الطلبات على ال Pods كما يفعل ال Service الحقيقي، وإنما يختار Pod واحداً عند البدء ويبقى عليه، فإذا توقف ذلك ال Pod توقف الأمر كله برسالة `lost connection to pod`، وسوف نرى هذا في مقال نقل تطبيق Compose. فهو أداة للتطوير والتشخيص، وليس طريقة لنشر تطبيق للمستخدمين، وذلك عمل Ingress أو Gateway.

### kubectl debug: أدوات لا توجد في ال Image

كثير من ال Images الصغيرة لا تحتوي على shell ولا على أدوات مثل `ps` و`wget`، وهذا جيد للأمان كما شرحنا في [تقليل حجم Docker Images وتأمينها](https://arabroot.io/articles/%D8%AA%D9%82%D9%84%D9%8A%D9%84-%D8%AD%D8%AC%D9%85-docker-images-%D9%88%D8%AA%D8%A7%D9%85%D9%8A%D9%86%D9%87%D8%A7/)، ولكنه يجعل `exec` بلا فائدة. والأمر `debug` يضيف إلى ال Pod الذي يعمل Container مؤقتاً Ephemeral Container من Image أخرى فيها الأدوات، ومع الخيار `--target` يرى عمليات ال Container الأصلي:

```bash
kubectl debug hello-5895659ccd-2qng5 --image=busybox:1.37 --target=nginx --container=k1-dbg -- sh -c 'ps; wget -qO- http://127.0.0.1/ | head -4'
kubectl logs hello-5895659ccd-2qng5 -c k1-dbg
```

```text
Targeting container "nginx". If you don't see processes from this container it may be because the container runtime doesn't support this feature.

PID   USER     TIME  COMMAND
    1 root      0:00 nginx: master process nginx -g daemon off;
   34 101       0:00 nginx: worker process
   35 101       0:00 nginx: worker process
   36 101       0:00 nginx: worker process
   37 101       0:00 nginx: worker process
   38 101       0:00 nginx: worker process
   39 101       0:00 nginx: worker process
   40 101       0:00 nginx: worker process
   41 101       0:00 nginx: worker process
   42 root      0:00 sh -c ps; wget -qO- http://127.0.0.1/ | head -4
   53 root      0:00 ps
<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
```

وال Container المؤقت يرى nginx بالرقم 1 لأنه يشترك معه في مساحة أسماء العمليات PID Namespace التي شرحناها في [ما هي ال Containers](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%8A-%D8%A7%D9%84-containers-%D9%88%D8%A7%D9%84%D9%81%D8%B1%D9%82-%D8%A8%D9%8A%D9%86%D9%87%D8%A7-%D9%88%D8%A8%D9%8A%D9%86-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9-%D8%A7%D9%84%D8%A7%D9%81%D8%AA%D8%B1%D8%A7%D8%B6%D9%8A%D8%A9/)، ويصل إليه على `127.0.0.1` لأنهما في نفس شبكة ال Pod. ولاحظ أيضاً عدد عمليات العامل worker process، فهي ثمانية، لأن nginx يضبط عددها تلقائياً بعدد معالجات الجهاز CPUs، وهو يرى المعالجات الثمانية كلها رغم أن ال Pod طلب 50m فقط، أي جزءاً من عشرين من معالج، فالطلب Request لا يخفي المعالجات عن التطبيق. ولا يحذف ال Container المؤقت بعد انتهائه، وإنما يبقى في وصف ال Pod حتى يحذف ال Pod نفسه:

```bash
kubectl get pod hello-5895659ccd-2qng5 -o jsonpath='{.spec.ephemeralContainers[*].name}'; echo
```

```text
k1-dbg
```

## التغيير Change: apply وdiff وrollout

الطريقة التي ننصح بها لكل تغيير هي أن تعدل الملف ثم ترسله ب `kubectl apply`، والسبب أن الملف يبقى في Git ويصبح هو مصدر الحقيقة، كما شرحنا في [GitOps ببساطة](https://arabroot.io/articles/%D8%A7%D9%84%D8%A8%D9%8A%D8%A6%D8%A7%D8%AA-%D9%88%D9%85%D8%B9%D8%A7%D9%8A%D9%86%D8%A9-%D8%A7%D9%84%D9%85%D9%8A%D8%B2%D8%A7%D8%AA-%D9%88-gitops-%D9%84%D9%84%D9%81%D8%B1%D9%82/#gitops). وقبل أن ترسل اسأل العنقود ماذا سيتغير بالأمر `kubectl diff`، فهو يرسل الملف إلى ال API Server في وضع تجربة Dry Run ويقارن النتيجة بما يعمل الآن. فهنا غيرنا وسم nginx في الملف من 1.29.8 إلى 1.31.6:

```bash
sed -i 's#image: nginx:1.29.8-alpine#image: nginx:1.31.6-alpine#' hello.yaml
kubectl diff -f hello.yaml
```

```text
@@ -6,7 +6,7 @@
     kubectl.kubernetes.io/last-applied-configuration: |
       {"apiVersion":"apps/v1","kind":"Deployment",…}
   creationTimestamp: "2026-11-18T18:26:29Z"
-  generation: 1
+  generation: 2
   labels:
     app: hello
     tier: frontend
@@ -33,7 +33,7 @@
         tier: frontend
     spec:
       containers:
-      - image: nginx:1.29.8-alpine
+      - image: nginx:1.31.6-alpine
         imagePullPolicy: IfNotPresent
         name: nginx
         ports:
```

واختصرنا السطر الطويل الذي يحفظ آخر ملف أرسلته، وفي الباقي سطران تغيرا: الوسم كما توقعنا، والحقل `generation` الذي يزيده ال API Server عند كل تغيير في المواصفات spec. والأمر `diff` يخرج بالرمز 1 عندما يجد فرقاً وبالرمز 0 عندما لا يجد، وهذا مفيد في خطوط النشر Pipelines، فبعد أن أرسلنا الملف خرج `diff` بالرمز 0\. ثم أرسلنا الملف وتابعنا التحديث:

```bash
kubectl apply -f hello.yaml
kubectl annotate deployment/hello kubernetes.io/change-cause='nginx 1.29.8 to 1.31.6'
kubectl rollout status deploy/hello
kubectl rollout history deploy/hello
kubectl get rs -l app=hello
```

```text
deployment.apps/hello configured
service/hello unchanged
deployment.apps/hello annotated
Waiting for deployment "hello" rollout to finish: 1 out of 2 new replicas have been updated...
Waiting for deployment "hello" rollout to finish: 1 old replicas are pending termination...
deployment "hello" successfully rolled out
deployment.apps/hello
REVISION  CHANGE-CAUSE
1         <none>
2         nginx 1.29.8 to 1.31.6

NAME               DESIRED   CURRENT   READY   AGE
hello-5895659ccd   0         0         0       6m46s
hello-6795db798f   2         2         2       2m10s
```

في المخرج أعلاه لاحظ التالي:

- التحديث التدريجي Rolling Update أنشأ ReplicaSet جديداً ونقل إليه ال Pods واحداً واحداً، وأبقى القديم بعدد صفر، فهو الذي يرجع إليه التراجع Rollback.
- عمود `CHANGE-CAUSE` يقرأ التعليق Annotation المسمى `kubernetes.io/change-cause`، فإذا لم تكتبه بقي `<none>` ولن تعرف بعد شهر لماذا حدثت كل مراجعة، والأفضل أن تجعل خط النشر يكتبه مع رقم ال Commit.

### التراجع rollout undo والانحراف Drift بين الملف والعنقود

لنفرض أن النسخة الجديدة فيها مشكلة وتريد الرجوع فوراً، فالأمر `rollout undo` يعيد ال Template السابق:

```bash
kubectl rollout undo deploy/hello
kubectl rollout status deploy/hello
kubectl get deploy hello -o jsonpath='{.spec.template.spec.containers[0].image}'; echo
kubectl rollout history deploy/hello
```

```text
Warning: resource deployments/hello was previously managed with 'kubectl apply'. Rolling back will not update the kubectl.kubernetes.io/last-applied-configuration annotation, which may cause unexpected behavior on future 'kubectl apply' operations. Consider using 'kubectl apply' with your previous configuration file instead.
deployment.apps/hello rolled back
deployment "hello" successfully rolled out
nginx:1.29.8-alpine
deployment.apps/hello
REVISION  CHANGE-CAUSE
2         nginx 1.29.8 to 1.31.6
3         <none>
```

نجح التراجع، والمراجعة 1 اختفت من القائمة وأصبحت 3، لأن التراجع لا يعيد رقماً قديماً وإنما ينشئ مراجعة جديدة بنفس ال Template. ولكن اقرأ التحذير في أول المخرج بعناية، فهو أهم سطر فيه: العنقود الآن يشغل 1.29.8، والملف عندك وفي Git ما زال يقول 1.31.6\. ثم زدنا عدد النسخ بالأمر `scale`، وهو تغيير آخر لا يعرفه الملف:

```bash
kubectl scale deploy/hello --replicas=4
kubectl diff -f hello.yaml | grep -E '^[-+] '
```

```text
deployment.apps/hello scaled
-  generation: 5
+  generation: 6
-  replicas: 4
+  replicas: 2
-      - image: nginx:1.29.8-alpine
+      - image: nginx:1.31.6-alpine
```

وهذا ما يسمى الانحراف Drift: أول شخص يكتب `kubectl apply -f hello.yaml` لأي سبب سوف يعيد النسخة التي تراجعنا عنها، ويخفض النسخ من أربع إلى اثنتين، دون أن يقصد. لذلك استخدم `undo` و`scale` في الطوارئ فقط، ثم صحح الملف فوراً ليطابق العنقود، واجعل `kubectl diff` خطوة ثابتة قبل كل `apply`، فهو الذي كشف الفرق هنا قبل أن يحدث.

![ثلاثة ReplicaSets من التجربة: 5895659ccd بالوسم nginx:1.29.8-alpine وهو المراجعات 1 ثم 3 ثم 5، و6795db798f بالوسم 1.31.6 وهو المراجعة 2 من apply، و6f45595854 بالوسم الخاطئ 1.29.88 وهو المراجعة 4، والخطوات: apply ثم rollout undo ثم set image بوسم خاطئ ثم set image يعود الأول، وفي الأسفل الملف hello.yaml يقول 1.31.6 و2 نسخ والعنقود يشغل 1.29.8 و4 نسخ](https://arabroot.io/content/images/2026/11/kubectl-basics-05-rollout.webp)

كل Template جديد ReplicaSet جديد، والتراجع والتغيير المباشر يتركان الملف مختلفاً عن العنقود

### kubectl wait في السكربتات

عندما يحتاج سكربت أن ينتظر حالة معينة قبل الخطوة التالية فلا تكتب حلقة فيها `sleep` و`grep`، وإنما استخدم `kubectl wait`، فهو يراقب الكائن عبر ال API Server ويخرج فور تحقق الشرط، أو بخطأ عند انتهاء المهلة Timeout:

```bash
kubectl wait --for=condition=Available deploy/hello --timeout=30s
```

```text
deployment.apps/hello condition met
```

والشرط `Available` من حالة ال Deployment، ويمكنك أن تنتظر `condition=Ready` على Pod، أو `--for=delete` حتى يختفي كائن، أو حقلاً بعينه بالصيغة `--for=jsonpath=…`. والفرق بينه وبين `rollout status` أن الثاني يتابع تحديثاً جارياً حتى ينتهي، أما `wait` فيسأل عن حالة، فاستخدم الأول بعد كل `apply` والثاني قبل خطوة تحتاج شيئاً جاهزاً، مثل اختبار يتصل بقاعدة بيانات Database بدأت للتو.

## العلامات Labels والمحددات Selectors في الأوامر اليومية

ال Labels أزواج من مفتاح وقيمة تضعها على الكائنات، والمحدد Selector سؤال عنها، وكل ما يربط الكائنات ببعض في Kubernetes يعمل بها، كما في [صفحة ال Labels وال Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/?ref=arabroot.io). وفي الأوامر اليومية تستخدمها لتختار ما تريد بدل الأسماء العشوائية:

```bash
kubectl get pods -l 'app in (hello,crashy)' -L app,tier
kubectl get pods -l 'app!=hello'
kubectl get pods -l tier=frontend,app=hello -o name
```

```text
NAME                      READY   STATUS    RESTARTS   AGE     APP      TIER
crashy-6968d5bd47-kkxxk   1/1     Running   0          3m50s   crashy
hello-5895659ccd-2qng5    1/1     Running   0          17m     hello    frontend
hello-5895659ccd-98tcj    1/1     Running   0          16m     hello    frontend
hello-5895659ccd-rpzmv    1/1     Running   0          17m     hello    frontend
hello-5895659ccd-xns99    1/1     Running   0          41s     hello    frontend

NAME                      READY   STATUS    RESTARTS   AGE
crashy-6968d5bd47-kkxxk   1/1     Running   0          3m53s

pod/hello-5895659ccd-2qng5
pod/hello-5895659ccd-98tcj
pod/hello-5895659ccd-rpzmv
pod/hello-5895659ccd-xns99
```

في الأوامر أعلاه لاحظ التالي:

- الصيغة `in (…)` تختار من مجموعة قيم، والفاصلة بين شرطين تعني «و» وليس «أو»، فالأمر الأخير يختار ما عليه `tier=frontend` و`app=hello` معاً.
- الخيار `-L` يعرض قيمة Label كعمود، وهو أوضح من `--show-labels` عندما تهمك قيمة واحدة.
- الخيار `-o name` يطبع الأسماء بصيغة `pod/…` التي يقبلها أي أمر آخر، فيمكنك أن تمررها إلى `kubectl delete` أو `kubectl logs` في سكربت.

وتغيير Label على Pod يعمل له يغير من يراه، فهنا غيرنا `tier` على Pod واحد، ثم أعدناه:

```bash
kubectl label pod hello-5895659ccd-2qng5 tier=canary --overwrite
kubectl get pods -l app=hello -L tier
kubectl label pod hello-5895659ccd-2qng5 tier=frontend --overwrite
```

```text
pod/hello-5895659ccd-2qng5 labeled
NAME                     READY   STATUS    RESTARTS   AGE   TIER
hello-5895659ccd-2qng5   1/1     Running   0          18m   canary
hello-5895659ccd-98tcj   1/1     Running   0          17m   frontend
hello-5895659ccd-rpzmv   1/1     Running   0          17m   frontend
hello-5895659ccd-xns99   1/1     Running   0          67s   frontend
pod/hello-5895659ccd-2qng5 labeled
```

هنا لم يحدث شيء آخر، فال Pods ما زالت أربعة، والسبب أن Selector ال Deployment هو `app=hello` فقط، والتغيير كان في `tier`. ولو غيرنا `app` لخرج ال Pod من حساب ال ReplicaSet ومن ال Service، ولجاء بديله، كما رأينا في مقال Kubernetes من الداخل. فاعرف أي Labels يستخدمها ال Selector في كل كائن قبل أن تغير أياً منها، وأسرع طريقة لذلك:

```bash
kubectl get svc hello -o wide
kubectl get endpointslices -l kubernetes.io/service-name=hello
```

```text
NAME    TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)   AGE   SELECTOR
hello   ClusterIP   10.96.127.172   <none>        80/TCP    25m   app=hello

NAME          ADDRESSTYPE   PORTS   ENDPOINTS                                        AGE
hello-chzts   IPv4          80      10.244.2.4,10.244.1.18,10.244.1.19 + 1 more...   25m
```

وال EndpointSlice هو القائمة الحقيقية لل Pods التي يصلها ال Service الآن، فإذا كان ال Service لا يوصل إلى تطبيقك فهذا أول ما تنظر إليه: إذا كانت القائمة فارغة فال Selector لا يطابق أي Pod جاهز، والخطأ غالباً حرف في Label أو فحص جاهزية لا ينجح.

## استهلاك الموارد Resources: kubectl top

الأمر `top` لا يقيس شيئاً بنفسه، وإنما يقرأ من واجهة المقاييس Metrics API التي يقدمها برنامج منفصل اسمه [metrics-server](https://github.com/kubernetes-sigs/metrics-server?ref=arabroot.io)، ولا يأتي مع kind ولا مع أغلب العناقيد التي تثبتها بنفسك:

```bash
kubectl top nodes
```

```text
error: Metrics API not available
```

فثبتناه من ملف الإصدار الرسمي 0.9.1، ثم أضفنا الخيار `--kubelet-insecure-tls`، والسبب أن شهادات ال kubelet في kind موقعة ذاتياً Self-signed ولا تحتوي على عناوين العقد، فيرفض metrics-server الاتصال بها دون هذا الخيار. ولا تستخدم هذا الخيار في عنقود حقيقي، وإنما اجعل ال kubelet يطلب شهادات موقعة من العنقود كما تشرح وثائق metrics-server:

```bash
kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/download/v0.9.1/components.yaml
kubectl -n kube-system patch deployment metrics-server --type=json \
  -p='[{"op":"add","path":"/spec/template/spec/containers/0/args/-","value":"--kubelet-insecure-tls"}]'
kubectl -n kube-system rollout status deploy/metrics-server
kubectl top nodes
kubectl top pods
kubectl top pods -A --sort-by=memory | head -6
```

```text
deployment.apps/metrics-server patched
deployment "metrics-server" successfully rolled out

NAME               CPU(cores)   CPU(%)   MEMORY(bytes)   MEMORY(%)
k1-control-plane   353m         4%       923Mi           2%
k1-worker          163m         2%       400Mi           1%
k1-worker2         156m         1%       252Mi           0%

NAME                     CPU(cores)   MEMORY(bytes)
hello-5895659ccd-2qng5   0m           8Mi
hello-5895659ccd-98tcj   0m           7Mi
hello-5895659ccd-lmmzx   0m           7Mi
hello-5895659ccd-rpzmv   0m           8Mi

NAMESPACE            NAME                                       CPU(cores)   MEMORY(bytes)
kube-system          kube-apiserver-k1-control-plane            89m          279Mi
kube-system          etcd-k1-control-plane                      34m          62Mi
kube-system          kube-controller-manager-k1-control-plane   23m          51Mi
kube-system          kube-proxy-99cz7                           2m           29Mi
kube-system          kindnet-f7lzb                              3m           24Mi            
```

وقارن هذه الأرقام بما في الملف: كل Pod من hello يستخدم 7 إلى 8 ميجابايت، وطلبنا له 32 ميجابايت وحددنا 64، فالطلب أعلى من الحاجة بأربع مرات، وفي عنقود من مئات ال Pods يعني هذا عقداً محجوزة لا تعمل. ولا تبن قرارك على قراءة واحدة، فالأرقام لحظية ومتوسطها على دقيقة تقريباً، وال metrics-server لا يحفظ تاريخاً، فللقياس على أيام تحتاج Prometheus. والنسبة المئوية في `top nodes` هنا صغيرة لأن كل عقدة في kind تعلن الجهاز كله، وهذا ما لن تراه في عنقود حقيقي.

## إعادة إنتاج CrashLoopBackOff وإصلاحه

CrashLoopBackOff ليس سبب المشكلة، وإنما وصف لما يفعله ال kubelet معها: ال Container يتوقف، فيعيد تشغيله، فيتوقف، فينتظر مدة أطول قبل المحاولة التالية. ولكي نراه كتبنا تطبيقاً صغيراً يبحث عن ملف إعداد غير موجود فيخرج بالرمز 1، كما يفعل أي تطبيق حقيقي نسي أحدهم أن يعطيه إعداده:

```yaml
# An app that cannot find its config file and exits with code 1, like a real misconfigured service.
apiVersion: apps/v1
kind: Deployment
metadata:
  name: crashy
spec:
  replicas: 1
  selector:
    matchLabels:
      app: crashy
  template:
    metadata:
      labels:
        app: crashy
    spec:
      containers:
        - name: app
          image: busybox:1.37
          command: ["sh", "-c"]
          args:
            - |
              echo "starting, reading $CONFIG_FILE"
              if [ ! -f "$CONFIG_FILE" ]; then echo "fatal: $CONFIG_FILE not found" >&2; exit 1; fi
              echo "config ok"; exec sleep 3600
          env:
            - name: CONFIG_FILE
              value: /etc/app/config.yaml
```

```bash
kubectl apply -f crashy.yaml
kubectl get pods -l app=crashy -w
```

```text
21:42:35 crashy-8478b79f97-9rkhq   1/1   Running             0     6s
21:42:36 crashy-8478b79f97-9rkhq   0/1   Error               0     8s
21:42:37 crashy-8478b79f97-9rkhq   1/1   Running             1 (3s ago)   9s
21:42:39 crashy-8478b79f97-9rkhq   0/1   Error               1 (4s ago)   10s
21:42:40 crashy-8478b79f97-9rkhq   0/1   CrashLoopBackOff    1 (2s ago)   11s
21:42:52 crashy-8478b79f97-9rkhq   1/1   Running             2 (15s ago)   24s
21:42:54 crashy-8478b79f97-9rkhq   0/1   Error               2 (16s ago)   25s
21:43:14 crashy-8478b79f97-9rkhq   0/1   CrashLoopBackOff    2 (22s ago)   46s
21:43:16 crashy-8478b79f97-9rkhq   1/1   Running             3 (24s ago)   48s
21:43:19 crashy-8478b79f97-9rkhq   0/1   Error               3 (26s ago)   50s
21:44:03 crashy-8478b79f97-9rkhq   0/1   CrashLoopBackOff    3 (47s ago)   94s
21:44:05 crashy-8478b79f97-9rkhq   1/1   Running             4 (50s ago)   97s
21:44:08 crashy-8478b79f97-9rkhq   0/1   Error               4 (52s ago)   99s
21:45:28 crashy-8478b79f97-9rkhq   0/1   CrashLoopBackOff    4 (83s ago)   2m59s
21:45:29 crashy-8478b79f97-9rkhq   1/1   Running             5 (85s ago)   3m1s
21:45:30 crashy-8478b79f97-9rkhq   0/1   Error               5 (86s ago)   3m2s
```

في المخرج أعلاه لاحظ التالي:

- ال Pod يظهر `Running` و`1/1` لثانية أو ثانيتين قبل كل توقف، فإذا نظرت إليه في تلك اللحظة ظننت أنه يعمل، ولذلك انظر دائماً إلى عمود `RESTARTS` وليس إلى `STATUS` وحده.
- المسافة بين التوقف والمحاولة التالية كانت ثانية ثم 13 ثم 22 ثم 46 ثم 81 ثانية، أي أنها تتضاعف تقريباً. وتقول [صفحة دورة حياة ال Pod](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/?ref=arabroot.io#container-restarts) إن الانتظار يتضاعف حتى خمس دقائق، ويعود إلى البداية إذا عمل ال Container عشر دقائق دون توقف.
- الحالة تتنقل بين `Error` و`CrashLoopBackOff` و`Running`، والحالة الأولى هي سبب التوقف من آخر تشغيل، والثانية تعني «أنا أنتظر»، فلا تبحث عن معنى خاص لكل واحدة.

![خط زمني لأول 150 ثانية من التجربة: أعمدة حمراء قصيرة لكل تشغيل انتهى بالخطأ Exit Code 1 بسبب fatal: /etc/app/config.yaml not found، وبينها فترات انتظار رمادية تزيد: ثانية ثم 13 ثم 22 ثم 46، والمحاولة السادسة بعد 81 ثانية، والحد الأعلى 5 دقائق](https://arabroot.io/content/images/2026/11/kubectl-basics-04-crashloop.webp)

الانتظار بين المحاولات يتضاعف، والتطبيق يعمل ثانية واحدة في كل مرة

والآن نبحث عن السبب، وأول خطأ يقع فيه الناس هنا هو قراءة سجل التشغيل الحالي، وهو غالباً فارغ أو في بدايته، لأن ال Container الحالي إما ينتظر أو بدأ للتو. والسجل الذي فيه السبب هو سجل المحاولة السابقة التي توقفت، والخيار `--previous` يجلبه:

```bash
kubectl logs pod/crashy-8478b79f97-9rkhq --previous
kubectl logs pod/crashy-8478b79f97-9rkhq --timestamps
kubectl describe pod/crashy-8478b79f97-9rkhq | sed -n '/State:/,/Restart Count/p'
```

```text
fatal: /etc/app/config.yaml not found
starting, reading /etc/app/config.yaml

2026-11-18T18:45:29.131105519Z fatal: /etc/app/config.yaml not found
2026-11-18T18:45:29.131166946Z starting, reading /etc/app/config.yaml

    State:          Waiting
      Reason:       CrashLoopBackOff
    Last State:     Terminated
      Reason:       Error
      Exit Code:    1
      Started:      Wed, 18 Nov 2026 21:45:29 +0300
      Finished:     Wed, 18 Nov 2026 21:45:29 +0300
    Ready:          False
    Restart Count:  5
```

في المخرج أعلاه لاحظ التالي:

- السبب واضح في سطر واحد: الملف `/etc/app/config.yaml` غير موجود، والرمز `Exit Code: 1` يعني أن التطبيق نفسه قرر الخروج، وهذا يختلف عن 137 الذي يعني أن أحداً قتله بالإشارة Signal المسماة SIGKILL، مثل نفاد الذاكرة، كما شرحنا رموز الخروج Exit Codes في [أوامر Docker الأساسية](https://arabroot.io/articles/%D8%A7%D9%88%D8%A7%D9%85%D8%B1-docker-%D8%A7%D9%84%D8%A7%D8%B3%D8%A7%D8%B3%D9%8A%D8%A9-%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D9%88%D8%A7%D9%84%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%A7%D9%8A%D9%82%D8%A7%D9%81/).
- السطران في السجل بترتيب معكوس، فسطر الخطأ ظهر قبل سطر البداية رغم أن التطبيق كتب البداية أولاً، والسبب أن الأول على stderr والثاني على stdout، ويجمعهما containerd من قناتين، والأوقات مع `--timestamps` تختلف بستين ميكروثانية فقط. فلا تعتمد على ترتيب الأسطر بين القناتين، واجعل تطبيقك يكتب سجله كله على قناة واحدة مع وقت لكل سطر.
- `Started` و`Finished` في نفس الثانية، أي أن التطبيق لا يعمل أصلاً، فلا فائدة من زيادة مهلة الفحوص أو انتظار أطول.

والإصلاح أن نعطي التطبيق ملفه، فننشئ ConfigMap فيه الملف ونركبه في المجلد Directory الذي يتوقعه التطبيق، والتفاصيل الكاملة لل ConfigMaps لها مقال مستقل في هذه المرحلة:

```yaml
# Mount the ConfigMap where the app expects its file.
spec:
  template:
    spec:
      containers:
        - name: app
          volumeMounts:
            - name: config
              mountPath: /etc/app
      volumes:
        - name: config
          configMap:
            name: crashy-config
```

```bash
kubectl create configmap crashy-config --from-literal=config.yaml='level: info'
kubectl patch deployment crashy --patch-file crashy-fixed-patch.yaml
kubectl rollout status deploy/crashy --timeout=120s
kubectl get pods -l app=crashy
kubectl logs deploy/crashy
```

```text
configmap/crashy-config created
deployment.apps/crashy patched
deployment "crashy" successfully rolled out
NAME                      READY   STATUS    RESTARTS        AGE
crashy-6968d5bd47-kkxxk   1/1     Running   0               18s
crashy-8478b79f97-9rkhq   0/1     Error     5 (2m32s ago)   5m33s
Found 2 pods, using pod/crashy-6968d5bd47-kkxxk
starting, reading /etc/app/config.yaml
config ok
```

وال Pod القديم ظهر للحظة بحالة `Error` قبل أن يحذف، والجديد يعمل دون إعادة تشغيل. واستخدمنا `patch` هنا لنبين أنه موجود، ولكن الصحيح في مشروع حقيقي أن تضيف هذه الأسطر إلى ملف ال Deployment نفسه ثم `apply`، للسبب الذي رأيناه في قسم التراجع.

## إعادة إنتاج ImagePullBackOff وإصلاحه

العطل الثاني يحدث قبل أن يبدأ التطبيق أصلاً: ال kubelet لا يستطيع سحب ال Image. ولكي نراه غيرنا وسم nginx بخطأ مطبعي يحدث كل يوم، فكتبنا `1.29.88` بدل `1.29.8`:

```bash
kubectl set image deployment/hello nginx=nginx:1.29.88-alpine
kubectl get pods -l app=hello -w
```

```text
deployment.apps/hello image updated
21:48:21 hello-5895659ccd-lmmzx   1/1   Terminating         0     13m
21:48:21 hello-6f45595854-w7nm9   0/1   ContainerCreating   0     1s
21:48:22 hello-6f45595854-wgtrw   0/1   Pending             0     0s
21:48:30 hello-6f45595854-w7nm9   0/1   ErrImagePull        0     10s
21:48:32 hello-6f45595854-wgtrw   0/1   ErrImagePull        0     10s
21:48:44 hello-6f45595854-wgtrw   0/1   ImagePullBackOff    0     22s
21:48:45 hello-6f45595854-w7nm9   0/1   ImagePullBackOff    0     25s
21:48:57 hello-6f45595854-w7nm9   0/1   ErrImagePull        0     37s
21:49:13 hello-6f45595854-w7nm9   0/1   ImagePullBackOff    0     53s
21:49:27 hello-6f45595854-w7nm9   0/1   ErrImagePull        0     67s
```

```bash
kubectl get pods -l app=hello
kubectl rollout status deploy/hello --timeout=10s
kubectl describe pod hello-6f45595854-w7nm9 | sed -n '/Events:/,$p'
```

```text
NAME                     READY   STATUS         RESTARTS   AGE
hello-5895659ccd-2qng5   1/1     Running        0          15m
hello-5895659ccd-98tcj   1/1     Running        0          14m
hello-5895659ccd-rpzmv   1/1     Running        0          15m
hello-6f45595854-w7nm9   0/1     ErrImagePull   0          76s
hello-6f45595854-wgtrw   0/1     ErrImagePull   0          75s

Waiting for deployment "hello" rollout to finish: 2 out of 4 new replicas have been updated...
error: timed out waiting for the condition

Events:
  Type     Reason     Age                From               Message
  ----     ------     ----               ----               -------
  Normal   Scheduled  91s                default-scheduler  Successfully assigned demo/hello-6f45595854-w7nm9 to k1-worker2
  Normal   Pulling    40s (x3 over 86s)  kubelet            spec.containers{nginx}: Pulling image "nginx:1.29.88-alpine"
  Warning  Failed     37s (x3 over 83s)  kubelet            spec.containers{nginx}: Failed to pull image "nginx:1.29.88-alpine": rpc error: code = NotFound desc = failed to pull and unpack image "docker.io/library/nginx:1.29.88-alpine": failed to resolve reference "docker.io/library/nginx:1.29.88-alpine": docker.io/library/nginx:1.29.88-alpine: not found
  Warning  Failed     37s (x3 over 83s)  kubelet            spec.containers{nginx}: Error: ErrImagePull
  Normal   BackOff    1s (x5 over 83s)   kubelet            spec.containers{nginx}: Back-off pulling image "nginx:1.29.88-alpine"
  Warning  Failed     1s (x5 over 83s)   kubelet            spec.containers{nginx}: Error: ImagePullBackOff
```

في المخرج أعلاه لاحظ التالي:

- `ErrImagePull` هي المحاولة التي فشلت الآن، و`ImagePullBackOff` هي الانتظار قبل المحاولة التالية، والفكرة نفسها في CrashLoopBackOff ولكن على مرحلة السحب.
- السبب الحقيقي في سطر `Failed to pull image`: `not found` تعني أن الاسم أو الوسم غير موجود في السجل Registry. ولو كانت الرسالة `pull access denied` أو `unauthorized` لكان السبب صلاحية دخول إلى سجل خاص، ولو كانت `i/o timeout` لكان السبب شبكة العقدة، فكل نوع له إصلاح مختلف، ولذلك اقرأ الرسالة كاملة.
- ثلاث نسخ من القديمة ما زالت تعمل، والتحديث التدريجي توقف بعد أن أنشأ نسختين جديدتين لا تعملان، والسبب أن ال Deployment لا يحذف نسخة قديمة إلا عندما تصبح نسخة جديدة جاهزة، فالتطبيق ما زال يخدم المستخدمين بثلاث نسخ من أربع. وهذه حماية مهمة، ولكنها لا تعمل إلا إذا كان لتطبيقك فحص جاهزية صحيح.
- الأمر `rollout status` مع `--timeout` خرج بخطأ، وهذا ما تريده في خط النشر: أن يفشل الخط ويتوقف، بدل أن يقول «تم النشر» والتحديث عالق.

والإصلاح أن نعيد الوسم الصحيح:

```bash
kubectl set image deployment/hello nginx=nginx:1.29.8-alpine
kubectl rollout status deploy/hello --timeout=120s
kubectl get pods -l app=hello
kubectl rollout history deploy/hello
```

```text
deployment.apps/hello image updated
Waiting for deployment "hello" rollout to finish: 3 of 4 updated replicas are available...
deployment "hello" successfully rolled out
NAME                     READY   STATUS    RESTARTS   AGE
hello-5895659ccd-2qng5   1/1     Running   0          17m
hello-5895659ccd-98tcj   1/1     Running   0          16m
hello-5895659ccd-rpzmv   1/1     Running   0          16m
hello-5895659ccd-xns99   1/1     Running   0          8s
deployment.apps/hello
REVISION  CHANGE-CAUSE
2         nginx 1.29.8 to 1.31.6
4         <none>
5         <none>
```

ولاحظ شيئاً جميلاً هنا: ثلاثة من ال Pods عمرها 16 دقيقة وأكثر، ولم يعد تشغيلها، وواحد فقط جديد. والسبب أن ال Template بعد الإصلاح أصبح مطابقاً تماماً لل ReplicaSet الأول `5895659ccd`، فلم ينشئ ال Deployment ReplicaSet جديداً، وإنما رفع عدد القديم من ثلاثة إلى أربعة وحذف ال Pods المعطلة، وأخذ ال ReplicaSet الأول رقم المراجعة الجديد 5.

وهناك حالة ثالثة لا تظهر فيها أي كلمة حمراء، وهي ال Pod الذي حالته `Running` وجاهزيته `0/1` لدقائق. والتطبيق هنا يعمل، ولكن فحص الجاهزية Readiness Probe يفشل، فلا يدخل ال Pod إلى ال Service ولا يصله أي طلب، وإذا كان التحديث جارياً بقي عالقاً لأن ال Deployment ينتظر نسخاً جاهزة. والسبب يكتبه ال kubelet في الأحداث بسطر يبدأ ب `Readiness probe failed` ومعه الرد الذي وصله، مثل رمز HTTP خاطئ أو اتصال مرفوض، فابدأ ب `describe` هنا أيضاً، ثم ب `exec` لتجرب الفحص نفسه من داخل ال Container. وسوف ترى هذه الحالة في مقال نقل تطبيق Compose، عندما تتوقف قاعدة البيانات ويتوقف معها ال API.

![ترتيب التشخيص في أربع خطوات: kubectl get pods لمعرفة الحالة، ثم kubectl describe لقراءة Events، ثم logs --previous لمعرفة سبب التوقف، ثم exec أو debug للنظر من الداخل، وتحتها أربع حالات: Pending سببه المجدول ويقرأ من describe، وImagePullBackOff سببه الاسم أو الوسم ويقرأ من describe، وCrashLoopBackOff سببه التطبيق ويقرأ من logs --previous، وRunning 0/1 سببه ال Probe ويقرأ من describe، ثم الإصلاح في الملف ثم kubectl diff ثم apply ثم kubectl rollout status](https://arabroot.io/content/images/2026/11/kubectl-basics-03-debug-order.webp)

ترتيب التشخيص: كل حالة لها مكان تقرأ فيه السبب قبل أن تخمن

## الحذف Delete: ماذا يحذف وماذا يبقى؟

الحذف هو الأمر الوحيد في هذا المقال الذي لا رجوع عنه، فلا توجد سلة محذوفات في Kubernetes، ولذلك جرب الأمر أولاً بالخيار `--dry-run=server`، فيرسل ال API Server الطلب على كل مراحل التحقق ولا ينفذه، ثم احذف بنفس الملف الذي أنشأت به:

```bash
kubectl delete -n demo -f crashy.yaml --dry-run=server
kubectl delete -n demo -f crashy.yaml
kubectl get pods -n demo -l app=crashy
kubectl get configmap -n demo
```

```text
deployment.apps "crashy" deleted from demo namespace (server dry run)
deployment.apps "crashy" deleted from demo namespace
NAME                      READY   STATUS        RESTARTS      AGE
crashy-6968d5bd47-kkxxk   1/1     Terminating   1 (40m ago)   100m
NAME               DATA   AGE
crashy-config      1      100m
kube-root-ca.crt   1      124m
```

في المخرج أعلاه لاحظ التالي:

- حذف ال Deployment حذف معه ال ReplicaSets وال Pods التي يملكها، فهذا عمل جامع المهملات Garbage Collector الذي يتبع حقل المالك `ownerReferences`، ولذلك لا تحذف ال Pods بيدك إذا أردت أن يختفي التطبيق، فسيعيدها مالكها.
- ال Pod بقي `Terminating` بعد الأمر، لأن ال kubelet يرسل SIGTERM ثم ينتظر 30 ثانية افتراضياً قبل SIGKILL، والبرنامج في هذا ال Pod هو `sleep` الذي لا يتعامل مع الإشارة، فينتظر المدة كاملة. وتطبيقك الحقيقي يجب أن يتوقف بنفسه عند SIGTERM، كما شرحنا في [الإيقاف النظيف Graceful Shutdown](https://arabroot.io/articles/%D9%82%D8%A7%D8%A6%D9%85%D8%A9-%D8%AA%D8%AD%D9%82%D9%82-%D8%A7%D9%84%D9%85%D8%B7%D9%88%D8%B1-%D9%82%D8%A8%D9%84-%D9%86%D8%B4%D8%B1-%D8%AA%D8%B7%D8%A8%D9%8A%D9%82%D9%87/#graceful-shutdown).
- ال ConfigMap المسمى `crashy-config` بقي، لأننا أنشأناه بأمر مباشر وليس في الملف، فالحذف ب `-f` يحذف ما في الملف فقط. وهذه حجة أخرى لأن يكون كل شيء في ملفات: ما لا يوجد في ملف ينسى في العنقود. أما `kube-root-ca.crt` فينشئه العنقود في كل Namespace، وفيه شهادة ال API Server لل Pods التي تتحدث معه.

وأخطر أمر حذف هو `kubectl delete namespace`، لأنه يحذف كل ما في ال Namespace دون أن يسأل، ومعه الأقراص الدائمة إذا كانت سياسة الاسترجاع Reclaim Policy في موفر التخزين Storage Provisioner هي الحذف، وهي الافتراضية في أغلب الموفرين. ولا تستخدم الخيار `--force --grace-period=0` لتسريع حذف Pod عالق إلا إذا كنت متأكداً أن عقدته متوقفة فعلاً، لأنه يحذف الكائن من ال API Server وال Container قد يكون ما زال يعمل على العقدة.

## الأوامر اليومية Cheat Sheet في جدول واحد

| ما تريده                    | الأمر                                         | انتبه إلى                              |
| --------------------------- | --------------------------------------------- | -------------------------------------- |
| على أي عنقود أنا؟           | kubectl config get-contexts                   | النجمة وعمود NAMESPACE                 |
| تبديل السياق                | kubectl config use-context NAME               | يبقى حتى تغيره، في كل نوافذ الطرفية    |
| كل ما في Namespace          | kubectl get all -n NS                         | لا يعرض ConfigMaps وSecrets وPVCs      |
| أين يعمل كل Pod؟            | kubectl get pods -o wide                      | العقدة والعنوان                        |
| لماذا هذه الحالة؟           | kubectl describe pod NAME                     | قسم Events في الأسفل                   |
| سبب التوقف                  | kubectl logs NAME --previous                  | دون \--previous تقرأ التشغيل الحالي    |
| سجلات كل النسخ              | kubectl logs -l app=X --prefix                | deploy/X يختار Pod واحداً              |
| أمر داخل ال Container       | kubectl exec NAME -- CMD                      | يحتاج الأداة داخل ال Image             |
| أداة غير موجودة في ال Image | kubectl debug NAME --image=busybox --target=C | ال Container المؤقت يبقى في ال Pod     |
| الوصول من جهازك             | kubectl port-forward svc/X 9573:80            | Pod واحد، ويتوقف إذا توقف              |
| ماذا سيتغير؟                | kubectl diff -f FILE                          | الرمز 1 يعني يوجد فرق                  |
| تطبيق التغيير               | kubectl apply -f FILE ثم rollout status       | النجاح يعني الحفظ وليس التشغيل         |
| التراجع                     | kubectl rollout undo deploy/X                 | صحح الملف بعده                         |
| شرح حقل                     | kubectl explain KIND.FIELD                    | مطابق لإصدار عنقودك                    |
| الاستهلاك الآن              | kubectl top pods                              | يحتاج metrics-server، ولا يحفظ تاريخاً |

## أخطاء شائعة Common Mistakes

- **العمل على السياق الخطأ:** أمر حذف على عنقود الإنتاج وأنت تظنه التجربة، والحل أن يظهر السياق في سطر الأوامر وأن يكون للإنتاج ملف منفصل.
- **قراءة `No resources found` كأن التطبيق غير موجود:** آخر كلمة في الرسالة هي ال Namespace الذي بحث فيه.
- **`kubectl logs` دون `--previous` في CrashLoopBackOff:** السجل الحالي فارغ غالباً، والسبب في المحاولة السابقة.
- **`logs deploy/X` للبحث عن طلب معين:** يقرأ من Pod واحد، والطلب قد يكون في غيره.
- **اعتبار `apply` الناجح نشراً ناجحاً:** تابعه دائماً ب `rollout status --timeout`.
- **`rollout undo` و`scale` دون تصحيح الملف:** أول `apply` بعدها يعيد ما تراجعت عنه.
- **Labels على ال Pods فقط:** البحث والحذف ب `-l` يتجاهل ال Services والكائنات الأخرى.
- **تقطيع مخرج `get` ب `awk` في السكربتات:** استخدم `-o jsonpath` أو `-o name`.
- **ملف kubeconfig في محادثة أو مستودع:** فيه مفتاح خاص يعطي صلاحية المدير.
- **port-forward كطريقة نشر:** يتوقف مع ال Pod ومع جهازك، وهو للتشخيص فقط.
- **الخيار `--kubelet-insecure-tls` في عنقود حقيقي:** هو لعنقود التجربة فقط.

## قائمة تحقق Checklist قبل كل تغيير

1. `kubectl config current-context`: هل هذا العنقود الذي أقصده؟
2. الملف في Git، وال Labels على كل كائن فيه.
3. `kubectl diff -f`: هل الفرق هو ما أتوقعه فقط؟ وهل فيه شيء لم أغيره، مثل عدد النسخ؟
4. `kubectl apply -f` ثم `kubectl rollout status --timeout=…`.
5. إذا فشل: `get` ثم `describe` ثم `logs --previous` بهذا الترتيب.
6. بعد أي `undo` أو `scale` أو `set image` مباشر: صحح الملف ليطابق العنقود.

## حذف المختبر Cleanup

كل ما أنشأناه في هذا المقال موجود في ال Namespace المسمى `demo`، فحذفه يحذفها كلها، ثم نعيد السياق الأصلي ونحذف السياق الذي أنشأناه:

```bash
kubectl delete namespace demo
kubectl config use-context kind-k1
kubectl config delete-context demo
kubectl delete -f https://github.com/kubernetes-sigs/metrics-server/releases/download/v0.9.1/components.yaml
```

وإذا انتهيت من العنقود كله فالأمر `kind delete cluster --name k1` يحذفه، ولكن سوف نحتاجه في المقال التالي.

## الخلاصة Summary

وصلنا لنهاية الموضوع، وأهم ما فيه:

- kubectl عميل يرسل طلبات إلى ال API Server، والسياق في kubeconfig يحدد العنقود والمستخدم وال Namespace، و`No resources found` تعني غالباً أنك في Namespace آخر.
- `get` بصيغه للنظر، و`describe` للأحداث، و`logs --previous` لسبب التوقف، و`exec` و`debug` للنظر من الداخل، و`port-forward` للوصول من جهازك وحده.
- `diff` قبل `apply` و`rollout status` بعده، و`undo` و`scale` يتركان الملف مختلفاً عن العنقود، وقد رأينا ذلك في `diff` مباشرة.
- CrashLoopBackOff سببه في سجل المحاولة السابقة ورمز الخروج، وانتظاره يتضاعف حتى خمس دقائق، وImagePullBackOff سببه في رسالة السحب في الأحداث، والتحديث التدريجي أبقى النسخ القديمة تعمل حتى أصلحنا الوسم.

والخطوة التالية في هذه المرحلة أن نأخذ تطبيقاً حقيقياً من أربع خدمات يعمل على Docker Compose وننقله إلى هذا العنقود:

[![](https://arabroot.io/content/images/2026/11/compose-to-k8s-cover-cover.webp)دليلنقل تطبيق Docker Compose إلى Kubernetes خطوة بخطوةننقل تطبيقاً من أربع خدمات من Docker Compose إلى Kubernetes، ونرى ما أخطأ فيه kompose وما تعلمناه من كل عطل حتى عمل التطبيق.](https://arabroot.io/articles/%D9%86%D9%82%D9%84-%D8%AA%D8%B7%D8%A8%D9%8A%D9%82-docker-compose-%D8%A7%D9%84%D9%89-kubernetes/)[![](https://arabroot.io/content/images/2026/11/k8s-architecture-cover-cover.webp)دليلKubernetes من الداخل: Control Plane وetcd والعقد Nodesعنقود حقيقي من ثلاث عقد نفتحه من الداخل، فنقرأ etcd ونشاهد حلقة التحكم والمجدول، ثم نوقف عقدة ونقيس كم احتاج العنقود ليلاحظ وماذا تعطل في الطريق.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-kubernetes-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%A7%D8%AE%D9%84-control-plane-%D9%88-etcd/)[![](https://arabroot.io/content/images/2026/10/k8s-terms-cover-cover-1.webp)دليلمصطلحات Kubernetes مشروحة بالترتيب، من Pod إلى Ingressشرح مصطلحات Kubernetes بالترتيب الذي يبني بعضها على بعض، مع رسم لكل مفهوم وملفات YAML حقيقية.](https://arabroot.io/articles/%D9%85%D8%B5%D8%B7%D9%84%D8%AD%D8%A7%D8%AA-kubernetes-%D8%A8%D8%A7%D9%84%D8%B1%D8%B3%D9%85/)[![](https://arabroot.io/content/images/2026/11/compose-best-practices-cover-cover.webp)دليلأفضل الممارسات Best Practices في ملفات Docker Composeكيف تكتب ملف Compose يبدأ خدماته بالترتيب الصحيح ويحمي كلمات المرور ويضبط الذاكرة ويفصل التطوير عن الإنتاج، مع تجربة أظهرت أين يخدعك كل إعداد افتراضي.](https://arabroot.io/articles/%D8%A7%D9%81%D8%B6%D9%84-%D8%A7%D9%84%D9%85%D9%85%D8%A7%D8%B1%D8%B3%D8%A7%D8%AA-%D9%81%D9%8A-%D9%85%D9%84%D9%81%D8%A7%D8%AA-docker-compose/)[![](https://arabroot.io/content/images/2026/11/docker-commands-cover-cover.webp)دليلأوامر Docker الأساسية: التشغيل والسجلات والإيقافنشغل خدمة صغيرة ونتابعها بأوامر Docker اليومية، ثم نفهم لماذا ينتظر docker stop ثم يقتل، وماذا تعني رموز الخروج 0 و1 و127 و137 و143.](https://arabroot.io/articles/%D8%A7%D9%88%D8%A7%D9%85%D8%B1-docker-%D8%A7%D9%84%D8%A7%D8%B3%D8%A7%D8%B3%D9%8A%D8%A9-%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D9%88%D8%A7%D9%84%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%A7%D9%8A%D9%82%D8%A7%D9%81/)

## سجل التحديثات Changelog

- 18 نوفمبر 2026: كتابة المقال، وتنفيذ التجربة بالأداة kubectl v1.36.1 على عنقود kind 0.33.0 بالإصدار Kubernetes 1.36.4، مع metrics-server 0.9.1 وال Images nginx:1.29.8-alpine وnginx:1.31.6-alpine وbusybox:1.37.