Argo CD Environments و Rollback

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

ستتعلم كيف تنظم GitOps repo لعدة بيئات، وكيف تنفذ rollback عن طريق Git أو Argo CD history.

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

كل بيئة يجب أن يكون لها مسار واضح في Git. التغيير ينتقل من dev إلى staging ثم prod بمراجعة، وليس بنسخ أوامر يدوية.

هيكلة repo

gitops/
  apps/web/
    Chart.yaml
    values.yaml
  environments/dev/web/values.yaml
  environments/staging/web/values.yaml
  environments/prod/web/values.yaml

ApplicationSet مختصر

apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
  name: web-environments
  namespace: argocd
spec:
  generators:
    - list:
        elements:
          - env: dev
          - env: staging
          - env: prod
  template:
    metadata:
      name: "web-{{env}}"
    spec:
      project: default
      source:
        repoURL: https://github.com/example/gitops.git
        targetRevision: main
        path: apps/web
        helm:
          valueFiles:
            - "../../environments/{{env}}/web/values.yaml"
      destination:
        server: https://kubernetes.default.svc
        namespace: "web-{{env}}"
      syncPolicy:
        syncOptions:
          - CreateNamespace=true

Rollback workflow

flowchart LR
  A[Alert بعد release] --> B[تحديد commit]
  B --> C[Revert commit أو tag سابق]
  C --> D[Argo Sync]
  D --> E[Verify metrics]
  E --> F[Postmortem]

أوامر مهمة

argocd app list
argocd app get web-prod
argocd app diff web-prod
argocd app history web-prod
argocd app rollback web-prod <history-id>

Lab: تصميم بيئات Argo CD

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

الهدف: كتابة structure لثلاث بيئات وتحديد طريقة rollback.

Prerequisites

فهم Helm و Argo CD Application.

Steps

أنشئ folders للبيئات الثلاث.
اجعل replicaCount مختلفا بين dev و prod.
أنشئ Application أو ApplicationSet.
وثق rollback:

git revert <bad-commit>
git push
argocd app sync web-prod

Expected output

Sync Status: Synced
Health Status: Healthy

Cleanup

احذف Applications التجريبية من Argo CD إذا أنشأتها على cluster محلي.

أخطاء شائعة

الخطأ	العلاج
prod يختلف كثيرا عن staging	اجعل الاختلاف في values فقط قدر الإمكان
rollback من cluster بدون Git	وثق التغيير في Git فورا
auto sync على prod بلا مراجعة	استخدم approvals أو sync windows حسب حاجة الفريق