peikarband/deploy

Deploy Directory

این دایرکتوری شامل همه فایل‌های مربوط به deployment پروژه است.

📁 ساختار

deploy/
├── helm/                    # Helm charts
│   └── peikarband/
│       ├── Chart.yaml      # Chart metadata
│       ├── values.yaml     # Default values
│       ├── values-production.yaml
│       ├── values-staging.yaml
│       └── templates/      # K8s resource templates
├── kubernetes/             # Raw K8s manifests
│   └── secrets-template.yaml
└── argocd/                 # ArgoCD GitOps
    ├── application.yaml
    ├── application-staging.yaml
    └── README.md

⚓ Helm Charts

نصب با Helm

Staging:

helm upgrade --install peikarband ./deploy/helm/peikarband \
  --namespace staging \
  --values deploy/helm/peikarband/values-staging.yaml \
  --create-namespace

Production:

helm upgrade --install peikarband ./deploy/helm/peikarband \
  --namespace production \
  --values deploy/helm/peikarband/values-production.yaml \
  --create-namespace

یا استفاده از Makefile:

make helm-upgrade NAMESPACE=production

Values Files

• values.yaml: Default values (برای development)
• values-staging.yaml: Staging overrides
• values-production.yaml: Production overrides

مهم‌ترین تنظیمات:

image:
  repository: hub.peikarband.ir/peikarband/landing
  tag: "latest"
  
resources:
  requests:
    cpu: 500m
    memory: 512Mi
  limits:
    cpu: 1000m
    memory: 1Gi

autoscaling:
  enabled: true
  minReplicas: 2
  maxReplicas: 10

☸️ Kubernetes Manifests

Secrets

Template برای secrets:

kubectl create secret generic peikarband-secrets \
  --from-file=deploy/kubernetes/secrets-template.yaml \
  --namespace production

🔄 ArgoCD GitOps

Setup ArgoCD Application

Staging:

kubectl apply -f deploy/argocd/application-staging.yaml

Production:

kubectl apply -f deploy/argocd/application.yaml

Sync Policy

• Auto-sync: Enabled برای staging
• Manual sync: Required برای production

مانیتورینگ

argocd app get peikarband
argocd app sync peikarband
argocd app logs peikarband

🎯 Deployment Flow

graph LR
    A[Code Push] --> B[CI Build]
    B --> C[Push Image]
    C --> D{Environment}
    D -->|Staging| E[ArgoCD Auto-Sync]
    D -->|Production| F[Manual ArgoCD Sync]
    E --> G[Deploy]
    F --> G

Staging Deployment

1. Push به branch main
2. CI builds & pushes image
3. ArgoCD auto-sync
4. Rolling update

Production Deployment

1. Tag release (e.g., v1.0.0)
2. CI builds & pushes image با tag
3. Update values-production.yaml با tag جدید
4. Manual ArgoCD sync یا make helm-upgrade
5. Rolling update با health checks

🔍 Troubleshooting

Check Pod Status

kubectl get pods -n production
kubectl logs -f deployment/peikarband -n production
kubectl describe pod <pod-name> -n production

Check Helm Release

helm list -n production
helm status peikarband -n production
helm history peikarband -n production

Rollback

helm rollback peikarband <revision> -n production
# یا
kubectl rollout undo deployment/peikarband -n production

📊 Monitoring & Observability

Health Checks

• Liveness: /ping endpoint
• Readiness: /health endpoint
• Startup: 60s timeout

Metrics

• Prometheus metrics exposed on /metrics
• Grafana dashboards
• Alert rules

Logs

• Centralized logging with Loki
• Log aggregation
• Search & filtering

🔐 Security

Secrets Management

• Kubernetes Secrets
• Sealed Secrets (recommended)
• External Secrets Operator

Network Policies

• Ingress rules defined
• Egress restrictions
• Service mesh (optional)

RBAC

• ServiceAccount per namespace
• Minimal permissions
• Pod Security Standards

🎯 Best Practices

1. Versioning

   • Semantic versioning
   • Tag images با versions
   • Lock Helm chart versions

2. Resources

   • Set requests & limits
   • Monitor usage
   • Right-size pods

3. Autoscaling

   • HPA based on CPU/memory
   • VPA for recommendations
   • Cluster autoscaling

4. High Availability

   • Multiple replicas (min 2)
   • Pod disruption budgets
   • Anti-affinity rules

5. Updates

   • Rolling updates
   • Health checks
   • Gradual rollout

📚 مستندات بیشتر

• Deployment Checklist
• Production Deployment Guide
• Quick Start
• Kubernetes Guide