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/                                     <- Ο ΚΩΔΙΚΑΣ (ΠΑΡΑΡΤΗΜΑ A) — ΝΑ ΜΗΝ ΤΡΟΠΟΠΟΙΗΘΕΙ
│   ├── portail/
│   │   ├── app.py
│   │   ├── requirements.txt
│   │   └── Dockerfile
│   └── api/
│       ├── app.py
│       ├── requirements.txt
│       └── Dockerfile
│
├── chart/                                    <- ΤΟ CHART ΠΡΟΣ ΣΥΜΠΛΗΡΩΣΗ
│   ├── Chart.yaml                            <- σκελετός (ΠΑΡΑΡΤΗΜΑ B)
│   ├── values.yaml                           <- προεπιλεγμένες τιμές (ΠΑΡΑΡΤΗΜΑ B)
│   │
│   ├── environments/                         <- ΣΕΙΡΑ ΣΑΣ
│   │   ├── values-dev.yaml                   <- σκελετός TODO (ΠΑΡΑΡΤΗΜΑ B)
│   │   ├── values-staging.yaml               <- σκελετός TODO (ΠΑΡΑΡΤΗΜΑ B)
│   │   └── values-prod.yaml                  <- σκελετός TODO (ΠΑΡΑΡΤΗΜΑ B)
│   │
│   ├── templates/                            <- ΣΕΙΡΑ ΣΑΣ
│   │   ├── _helpers.tpl                      <- σκελετός TODO (ΠΑΡΑΡΤΗΜΑ B)
│   │   ├── portail-deployment.yaml           <- σκελετός TODO (ΠΑΡΑΡΤΗΜΑ B)
│   │   ├── portail-service.yaml              <- σκελετός TODO (ΠΑΡΑΡΤΗΜΑ B)
│   │   ├── api-deployment.yaml               <- σκελετός TODO (ΠΑΡΑΡΤΗΜΑ B)
│   │   └── api-service.yaml                  <- σκελετός TODO (ΠΑΡΑΡΤΗΜΑ B)
│   │
│   └── casses/                               <- ΠΑΡΕΧΟΝΤΑΙ αλλά ΕΛΑΤΤΩΜΑΤΙΚΑ (ΠΑΡΑΡΤΗΜΑ C)
│       ├── casse-1-configmap.yaml
│       ├── casse-2-worker-deployment.yaml
│       └── casse-3-cache-deployment.yaml
│
├── outils/
│   └── valider.ps1                           <- ΠΑΡΕΧΕΤΑΙ (ΠΑΡΑΡΤΗΜΑ D)
│
└── 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"      # πρέπει να εμφανίζει τις 2 εικόνες

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 — μπλε πανό, 1 αντίγραφο
start http://localhost:30131       # STAGING — πορτοκαλί πανό, 2 αντίγραφα
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                                                             # όλες οι releases
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():
    """Route utile pour la validation automatique."""
    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" -}}
# ? συμπληρώστε τις 7 ετικέτες που ζητούνται στην Αποστολή 3
app.kubernetes.io/name: TODO
app.kubernetes.io/instance: TODO
# ... συνεχίστε ...
{{- end -}}


{{/*
Selector labels : ΣΤΑΘΕΡΟ υποσύνολο των ετικετών.
Βάλτε εδώ ΜΟΝΟ ετικέτες που δεν θα αλλάξουν ΠΟΤΕ για μια παρουσία.
*/}}
{{- define "hedge.selectorLabels" -}}
# ? μόνο οι 3 ΑΥΣΤΗΡΑ αμετάβλητες ετικέτες
{{- end -}}

# ? Deployment του portail. Χρησιμοποιήστε :
#   - .Values.portail.replicas
#   - .Values.portail.image.{repository,tag,pullPolicy}
#   - .Values.portail.service.targetPort
#   - .Values.environment
#   - .Values.banniere.{couleur,message}
#   - .Chart.AppVersion (για APP_VERSION)
#   - Το ΟΝΟΜΑ του Service 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

# ? Service για το portail. Τύπος 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, αλλά :
#   - composant = "api"
#   - μεταβλητές περιβάλλοντος : ENVIRONMENT και APP_VERSION μόνο
#   - θύρα κοντέινερ = .Values.api.service.targetPort (8000)
apiVersion: apps/v1
kind: Deployment
metadata:
  name: TODO
spec:
  # ... (παρόμοια δομή με το portail) ...

# ? Service ClusterIP για την api. Μία μόνο θύρα. Χωρίς nodePort.
apiVersion: v1
kind: Service
metadata:
  name: TODO
spec:
  type: TODO
  selector:
    TODO
  ports:
    - port: TODO
      targetPort: TODO

# ? Περιβάλλον DEV : 1 αντίγραφο, μπλε πανό #2563eb, NodePort 30130.
environment: TODO

banniere:
  message: TODO
  couleur: TODO

portail:
  replicas: TODO
  service:
    nodePort: TODO

api:
  replicas: TODO

# ? Περιβάλλον STAGING : 2 αντίγραφα, πορτοκαλί πανό #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