mon-chart/
├── Chart.yaml            # بيانات وصفية (اسم، إصدار)
├── values.yaml           # قيم افتراضية
└── templates/            # قوالب YAML
    ├── deployment.yaml
    ├── service.yaml
    └── _helpers.tpl      # دوال قالب مشتركة (بادئة _)

helm lint ./chart                                              # التحقق من الصياغة
helm template <release> ./chart -f values-<env>.yaml           # عرض جاف (بلا نشر)
helm install <release> ./chart -f values-<env>.yaml -n <ns>    # نشر حقيقي
helm upgrade <release> ./chart -f values-<env>.yaml -n <ns>    # تعديل تزايدي
helm rollback <release> <revision> -n <ns>                     # رجوع للخلف

spec.selector: Invalid value: ...: field is immutable

projet13-kubernetes-helm-tp/
├── 00-ENONCE.md                              <- هذا المستند
│
├── apps/                                     <- الشفرة (الملحق أ) — لا تُعدَّل
│   ├── portail/
│   │   ├── app.py
│   │   ├── requirements.txt
│   │   └── Dockerfile
│   └── api/
│       ├── app.py
│       ├── requirements.txt
│       └── Dockerfile
│
├── chart/                                    <- الـ CHART المطلوب إكماله
│   ├── Chart.yaml                            <- هيكل (الملحق ب)
│   ├── values.yaml                           <- قيم افتراضية (الملحق ب)
│   │
│   ├── environments/                         <- دورك أنت
│   │   ├── values-dev.yaml                   <- هيكل TODO (الملحق ب)
│   │   ├── values-staging.yaml               <- هيكل TODO (الملحق ب)
│   │   └── values-prod.yaml                  <- هيكل TODO (الملحق ب)
│   │
│   ├── templates/                            <- دورك أنت
│   │   ├── _helpers.tpl                      <- هيكل TODO (الملحق ب)
│   │   ├── portail-deployment.yaml           <- هيكل TODO (الملحق ب)
│   │   ├── portail-service.yaml              <- هيكل TODO (الملحق ب)
│   │   ├── api-deployment.yaml               <- هيكل TODO (الملحق ب)
│   │   └── api-service.yaml                  <- هيكل TODO (الملحق ب)
│   │
│   └── casses/                               <- مقدَّمة لكنها معيبة (الملحق ج)
│       ├── casse-1-configmap.yaml
│       ├── casse-2-worker-deployment.yaml
│       └── casse-3-cache-deployment.yaml
│
├── outils/
│   └── valider.ps1                           <- مقدَّم (الملحق د)
│
└── RAPPORT.md                                <- تكتبه أنت

docker build -t hedge-portail:1.0 .\apps\portail
docker build -t hedge-api:1.0     .\apps\api

docker images | Select-String "^hedge"      # يجب أن يعرض الصورتين

helm lint .\chart
# يجب أن يعرض: 1 chart(s) linted, 0 chart(s) failed

helm template check .\chart -f .\chart\environments\values-dev.yaml
# يجب أن يعرض 2 Deployments + 2 Services، كلها مسبوقة بـ "check-"

{{ include "hedge.labels" (dict "root" . "composant" "portail") | nindent 4 }}

helm install hedge-dev     .\chart -f .\chart\environments\values-dev.yaml     -n hedge-dev     --create-namespace
helm install hedge-staging .\chart -f .\chart\environments\values-staging.yaml -n hedge-staging --create-namespace
helm install hedge-prod    .\chart -f .\chart\environments\values-prod.yaml    -n hedge-prod    --create-namespace

kubectl wait --for=condition=ready pod --all -n hedge-dev     --timeout=120s
kubectl wait --for=condition=ready pod --all -n hedge-staging --timeout=120s
kubectl wait --for=condition=ready pod --all -n hedge-prod    --timeout=120s

start http://localhost:30130       # DEV — شريط أزرق، نسخة واحدة
start http://localhost:30131       # STAGING — شريط برتقالي، نسختان
start http://localhost:30132       # PROD — شريط أخضر، 3 نسخ

# عرض جاف لقالب واحد (لا ينشر شيئاً)
helm template hedge-dev .\chart -f .\chart\environments\values-dev.yaml `
  --show-only templates/casse-3-cache-deployment.yaml --debug

.\outils\valider.ps1

[OK]    Mission 1 - Chart valide.............. 10/10
[OK]    Mission 2 - Templating de base........ 20/20
[ECHEC] Mission 3 - Helpers et labels.........  0/15   -> helper hedge.selectorLabels manquant
[OK]    Mission 4 - Trois environnements...... 20/20
[ECHEC] Mission 5 - Upgrade + rollback........  0/10   -> aucun rollback detecte dans l'historique
[OK]    Mission 6 - Reparations (3 pannes).... 14/20   -> casse-3 : typo .Values.portal toujours present

SCORE AUTOMATIQUE : 64 / 95

# تحليل (بلا نشر)
helm lint .\chart                                                        # صياغة + أفضل ممارسات
helm template <release> .\chart -f <values.yaml>                         # عرض كامل
helm template <release> .\chart -f <values.yaml> --show-only templates/<fichier>   # عرض موجَّه
helm template <release> .\chart -f <values.yaml> --debug                 # مع آثار
helm show values .\chart                                                 # قيم افتراضية

# النشر
helm install <release> .\chart -f <values.yaml> -n <ns> --create-namespace
helm upgrade <release> .\chart -f <values.yaml> -n <ns>
helm upgrade <release> .\chart -f <values.yaml> --set portail.replicas=5 -n <ns>
helm rollback <release> <revision> -n <ns>
helm uninstall <release> -n <ns>

# المراقبة
helm list -A                                                             # كل الإصدارات
helm status <release> -n <ns>
helm history <release> -n <ns>
helm get values <release> -n <ns>                                        # القيم النشطة
helm get manifest <release> -n <ns>                                      # البيانات المطبَّقة

"""Portail — tableau de bord multi-environnement.

Ce Pod affiche l'environnement dans lequel il tourne (DEV / STAGING / PROD),
la version applicative, le nombre de replicas, et l'etat du backend.

Toutes les valeurs affichees viennent de VARIABLES D'ENVIRONNEMENT injectees
par Helm depuis values-<env>.yaml. Le meme code s'adapte a chaque
environnement sans aucune modification.
"""

import os
import socket
import time
import urllib.error
import urllib.request

from flask import Flask, jsonify, request

app = Flask(__name__)
DEMARRAGE = time.time()


def cfg():
    return {
        "env": os.environ.get("ENVIRONMENT", "inconnu"),
        "version": os.environ.get("APP_VERSION", "0.0.0"),
        "theme": os.environ.get("THEME_COLOR", "#64748b"),
        "message": os.environ.get("BANNIERE_MESSAGE", "Deploye avec Helm"),
        "backend_url": os.environ.get("BACKEND_URL", "http://api"),
        "replicas_info": os.environ.get("REPLICAS_INFO", "?"),
        "pod": socket.gethostname(),
        "uptime": int(time.time() - DEMARRAGE),
    }


def tester_backend(url):
    try:
        with urllib.request.urlopen(url + "/ping", timeout=1.5) as reponse:
            corps = reponse.read(200).decode("utf-8", "ignore")
        return "ok", corps.strip()
    except urllib.error.HTTPError as err:
        return "http", "HTTP %s" % err.code
    except Exception as err:
        return "ko", type(err).__name__


@app.route("/health")
def health():
    return "OK", 200


@app.route("/api-json")
def api_json():
    """مسار مفيد للتحقق التلقائي."""
    c = cfg()
    etat, detail = tester_backend(c["backend_url"])
    return jsonify(pod=c["pod"], env=c["env"], version=c["version"],
                   backend=etat, backend_detail=detail, uptime=c["uptime"])


@app.route("/")
def accueil():
    c = cfg()
    etat, detail = tester_backend(c["backend_url"])
    # ... (قالب HTML كامل في الملف — غير مكرر هنا ليبقى مقروءاً)

flask==3.0.3

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY app.py .
CMD ["python", "app.py"]

"""API — backend simple pour l'exemple Helm."""

import os
import socket
import time

from flask import Flask, jsonify

app = Flask(__name__)
DEMARRAGE = time.time()

ENV = os.environ.get("ENVIRONMENT", "inconnu")
VERSION = os.environ.get("APP_VERSION", "0.0.0")


@app.route("/")
@app.route("/ping")
def ping():
    return jsonify(service="api", env=ENV, version=VERSION,
                   pod=socket.gethostname(),
                   uptime=int(time.time() - DEMARRAGE))


@app.route("/health")
def health():
    return "OK", 200


if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8000)

flask==3.0.3

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY app.py .
CMD ["python", "app.py"]

# ? املأ الحقول الإلزامية لـ Chart Helm.
# ? يجب أن تساوي apiVersion القيمة v2 (v1 مهجورة منذ Helm 3).
# ? type هو "application" (مقابل "library").

apiVersion: TODO
name: hedge
description: TODO
type: TODO
version: 0.1.0
appVersion: "1.0.0"

# values.yaml — قيم افتراضية لـ chart hedge.
# توفّر كل بيئة ملفاً values-<env>.yaml يتجاوز
# هذه القيم فوقها. أبقِ هذا الملف محايداً (لا قيمة خاصة
# ببيئة).

environment: default

banniere:
  message: "Chart Helm — application multi-environnement"
  couleur: "#64748b"

portail:
  image:
    repository: hedge-portail
    tag: "1.0"
    pullPolicy: IfNotPresent
  replicas: 1
  service:
    type: NodePort
    port: 80
    targetPort: 5000
    nodePort: 30130

api:
  image:
    repository: hedge-api
    tag: "1.0"
    pullPolicy: IfNotPresent
  replicas: 1
  service:
    type: ClusterIP
    port: 80
    targetPort: 8000

{{/*
اسم كامل لمورد: "<release>-<composant>".
الاستخدام: {{ include "hedge.fullname" (dict "root" . "composant" "portail") }}
*/}}
{{- define "hedge.fullname" -}}
{{- printf "TODO" .root.Release.Name .composant | trunc 63 | trimSuffix "-" -}}
{{- end -}}


{{/*
وسوم مشتركة لكل الموارد.
الاستخدام: {{ include "hedge.labels" (dict "root" . "composant" "portail") | nindent 4 }}
*/}}
{{- define "hedge.labels" -}}
# ? املأ الوسوم السبعة المطلوبة في المهمة 3
app.kubernetes.io/name: TODO
app.kubernetes.io/instance: TODO
# ... تابع ...
{{- end -}}


{{/*
وسوم المُنتقي: مجموعة فرعية مستقرة من الوسوم.
ضع هنا فقط وسوماً لن تتغيّر أبداً لنسخة.
*/}}
{{- define "hedge.selectorLabels" -}}
# ? الوسوم الثلاثة غير القابلة للتغيير حصراً
{{- end -}}

# ? Deployment البوابة. استخدم:
#   - .Values.portail.replicas
#   - .Values.portail.image.{repository,tag,pullPolicy}
#   - .Values.portail.service.targetPort
#   - .Values.environment
#   - .Values.banniere.{couleur,message}
#   - .Chart.AppVersion (لـ APP_VERSION)
#   - اسم خدمة api المبني بـ .Release.Name (لـ BACKEND_URL)
apiVersion: apps/v1
kind: Deployment
metadata:
  name: TODO
  labels:
    TODO
spec:
  replicas: TODO
  selector:
    matchLabels:
      TODO
  template:
    metadata:
      labels:
        TODO
    spec:
      containers:
        - name: portail
          image: TODO
          imagePullPolicy: TODO
          ports:
            - containerPort: TODO
          env:
            - name: ENVIRONMENT
              value: TODO
            # ? أضف APP_VERSION، THEME_COLOR، BANNIERE_MESSAGE،
            #   BACKEND_URL، REPLICAS_INFO
          readinessProbe:
            httpGet:
              path: /health
              port: TODO
            initialDelaySeconds: 3
            periodSeconds: 5

# ? خدمة للبوابة. نوع NodePort. استخدم الشرط
#   {{- if eq .Values.portail.service.type "NodePort" }} ... {{- end }}
#   لتضمين "nodePort" فقط إن كان النوع فعلاً NodePort.
apiVersion: v1
kind: Service
metadata:
  name: TODO
  labels:
    TODO
spec:
  type: TODO
  selector:
    TODO
  ports:
    - port: TODO
      targetPort: TODO
      # ? nodePort فقط إن كان type == NodePort

# ? الهيكل نفسه لـ portail-deployment.yaml، لكن:
#   - المكوّن = "api"
#   - متغيرات البيئة: ENVIRONMENT و APP_VERSION فقط
#   - منفذ الحاوية = .Values.api.service.targetPort (8000)
apiVersion: apps/v1
kind: Deployment
metadata:
  name: TODO
spec:
  # ... (هيكل مشابه للبوابة) ...

# ? خدمة ClusterIP لـ api. منفذ واحد. بلا nodePort.
apiVersion: v1
kind: Service
metadata:
  name: TODO
spec:
  type: TODO
  selector:
    TODO
  ports:
    - port: TODO
      targetPort: TODO

# ? بيئة DEV: نسخة واحدة، شريط أزرق #2563eb، NodePort 30130.
environment: TODO

banniere:
  message: TODO
  couleur: TODO

portail:
  replicas: TODO
  service:
    nodePort: TODO

api:
  replicas: TODO

# ? بيئة STAGING: نسختان، شريط برتقالي #ea580c، NodePort 30131.
environment: TODO
# ... أكمل على نموذج values-dev.yaml ...

# ? بيئة PROD: 3 نسخ، شريط أخضر #16a34a، NodePort 30132.
environment: TODO
# ...

# العطل 1
# العَرَض: انشر hedge-dev، ثم حاول نشر hedge-staging
# في النطاق نفسه. يفشل التثبيت الثاني بـ:
#   ConfigMap "hedge-config" ... exists and cannot be imported ...
apiVersion: v1
kind: ConfigMap
metadata:
  name: hedge-config
  labels:
    {{- include "hedge.labels" (dict "root" . "composant" "config") | nindent 4 }}
data:
  timezone: "America/Toronto"
  langue: "fr-CA"

# العطل 2
# العَرَض: يعمل "helm install". يفشل "helm upgrade" مع
# --set environment=recette بـ:
#   spec.selector: Invalid value: ...: field is immutable
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "hedge.fullname" (dict "root" . "composant" "worker") }}
spec:
  replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/name: {{ .Chart.Name }}
      app.kubernetes.io/instance: {{ .Release.Name }}
      app.kubernetes.io/component: worker
      hedge/environment: {{ .Values.environment | quote }}
  template:
    metadata:
      labels:
        {{- include "hedge.labels" (dict "root" . "composant" "worker") | nindent 8 }}
    spec:
      containers:
        - name: worker
          image: "{{ .Values.api.image.repository }}:{{ .Values.api.image.tag }}"

# العطل 3
# العَرَض: يفشل "helm install" بـ:
#   Error: template ...at <.Values.portal.replicas>:
#   nil pointer evaluating interface {}.replicas
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "hedge.fullname" (dict "root" . "composant" "cache") }}
spec:
  replicas: {{ .Values.portal.replicas }}
  selector:
    matchLabels:
      {{- include "hedge.selectorLabels" (dict "root" . "composant" "cache") | nindent 6 }}
  template:
    metadata:
      labels:
        {{- include "hedge.selectorLabels" (dict "root" . "composant" "cache") | nindent 8 }}
    spec:
      containers:
        - name: cache
          image: "{{ .Values.api.image.repository }}:{{ .Values.api.image.tag }}"

.\outils\valider.ps1