CI/CD و Argo CD

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

ستفهم الفرق بين CI و CD و GitOps، وكيف تنشئ Argo CD Application يراقب repo ويطبق manifests على cluster.

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

CI يبني image ويشغل tests. GitOps يجعل Git هو مصدر الحقيقة للـ manifests. Argo CD يراقب Git ويجعل cluster يطابق ما في Git.

التدفق الصحيح

flowchart LR
  Dev[Developer] --> AppRepo[App Repo]
  AppRepo --> CI[CI Pipeline]
  CI --> Registry[Container Registry]
  CI --> ConfigRepo[GitOps Repo]
  ConfigRepo --> Argo[Argo CD]
  Argo --> Cluster[Kubernetes Cluster]

Argo CD Application

application.yaml:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: web-dev
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/kubernetes-course-gitops.git
    targetRevision: main
    path: environments/dev/web
  destination:
    server: https://kubernetes.default.svc
    namespace: web-dev
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

شرح سريع:

الحقل	المعنى
`repoURL`	repo الذي يحتوي manifests أو Helm chart
`path`	المسار داخل repo للبيئة المطلوبة
`destination.namespace`	أين يطبق Argo الموارد
`prune`	حذف الموارد التي حذفت من Git
`selfHeal`	إعادة cluster إلى Git لو حصل drift

هيكلة GitOps repo

kubernetes-course-gitops/
  apps/
    web/
      Chart.yaml
      values.yaml
      templates/
  environments/
    dev/
      web/
        values.yaml
    staging/
      web/
        values.yaml
    prod/
      web/
        values.yaml

أوامر مهمة

kubectl apply -f application.yaml
argocd app get web-dev
argocd app sync web-dev
argocd app history web-dev
argocd app rollback web-dev <history-id>

Expected output:

Name:               argocd/web-dev
Health Status:      Healthy
Sync Status:        Synced to main

بيئات dev و staging و prod

البيئة	السياسة المقترحة
dev	sync تلقائي، موارد صغيرة، image tag سريع
staging	sync بعد مراجعة، يشبه prod
prod	sync مضبوط، approvals، rollback plan

أخطاء شائعة

المشكلة	التشخيص	الحل
App `OutOfSync`	`argocd app diff web-dev`	راجع الفرق وطبق sync أو عدل Git
App `Degraded`	`argocd app get web-dev`	افحص resource المكسور في Kubernetes
Argo لا يستطيع إنشاء namespace	events داخل app	أضف `CreateNamespace=true` أو أنشئ namespace
CI يعدل cluster مباشرة	مراجعة pipeline	اجعل CI يحدث Git فقط

Lab: GitOps Application أولى

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

الهدف: إنشاء Argo CD Application تربط repo ببيئة dev ومراجعة sync status.

Prerequisites

Argo CD مثبت على cluster.
Repo يحتوي manifests أو Helm chart.

Steps

عدل repoURL و path في application.yaml.
طبق Application:

kubectl apply -f application.yaml

افحص الحالة:

argocd app get web-dev
argocd app sync web-dev

غير عدد replicas من Git، ثم راقب Argo:

argocd app diff web-dev
argocd app sync web-dev

Expected output

Sync Status: Synced
Health Status: Healthy

Cleanup

kubectl delete -f application.yaml

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

Project 6 سيطلب منك تشغيل مشروعك عبر Argo CD، مع مسارات منفصلة للبيئات وخطة rollback موثقة.