Workload, Configurazione e Storage

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
spec:
  replicas: 6
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 2        # Max pod in PIÙ rispetto a replicas durante l'update
      maxUnavailable: 1  # Max pod NON READY durante l'update
  # → aggiorna 2 alla volta: +2 nuovi, -1 vecchi, finché tutti sono aggiornati
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
      - name: app
        image: myapp:v2
        readinessProbe:
          httpGet:
            path: /ready
            port: 8080
          # CRITICO: senza readiness probe, kubernetes non aspetta che il nuovo
          # pod sia pronto prima di eliminare il vecchio → possibile downtime

spec:
  minReadySeconds: 10   # Il Pod deve essere Ready CONTINUAMENTE per 10s prima che il rollout avanzi
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 1
      maxUnavailable: 0

strategy:
  type: Recreate
  # Elimina TUTTI i Pod vecchi prima di crearne di nuovi → downtime garantito

# DaemonSet — garantisce un Pod su ogni nodo
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: log-collector
spec:
  selector:
    matchLabels:
      app: log-collector
  template:
    metadata:
      labels:
        app: log-collector
    spec:
      tolerations:
      - key: node-role.kubernetes.io/control-plane
        operator: Exists
        effect: NoSchedule  # Schedula anche sul control plane
      containers:
      - name: fluentbit
        image: fluent/fluent-bit:2.2
        volumeMounts:
        - name: varlog
          mountPath: /var/log
          readOnly: true
      volumes:
      - name: varlog
        hostPath:
          path: /var/log

---
# Job — completamento one-shot
apiVersion: batch/v1
kind: Job
metadata:
  name: db-migration
spec:
  completions: 1
  parallelism: 1
  backoffLimit: 3    # Riprova max 3 volte
  template:
    spec:
      restartPolicy: OnFailure  # Job devono essere OnFailure o Never (non Always)
      containers:
      - name: migrate
        image: myapp-migrations:1.5.0
        envFrom:
        - secretRef:
            name: db-credentials

---
# CronJob — esecuzione periodica
apiVersion: batch/v1
kind: CronJob
metadata:
  name: nightly-backup
spec:
  schedule: "0 2 * * *"     # Ogni notte alle 2:00 UTC
  concurrencyPolicy: Forbid  # Non avviare se il precedente è ancora in corso
  successfulJobsHistoryLimit: 3
  failedJobsHistoryLimit: 1
  jobTemplate:
    spec:
      template:
        spec:
          restartPolicy: OnFailure
          containers:
          - name: backup
            image: myapp-backup:latest

apiVersion: policy/v1
kind: PodDisruptionBudget
metadata:
  name: myapp-pdb
spec:
  minAvailable: 2        # almeno 2 Pod devono restare attivi
  # oppure:
  # maxUnavailable: 1    # al massimo 1 Pod può essere non disponibile
  selector:
    matchLabels:
      app: myapp

# HTTP GET — più comune per web service
livenessProbe:
  httpGet:
    path: /healthz
    port: 8080
    httpHeaders:
    - name: X-Probe
      value: kubelet

# TCP socket — per servizi non-HTTP (database, cache)
readinessProbe:
  tcpSocket:
    port: 5432

# Exec — esegue un comando nel container (exit 0 = successo)
readinessProbe:
  exec:
    command: ["pg_isready", "-U", "postgres"]

# gRPC — richiede che l'app implementi il grpc health protocol
livenessProbe:
  grpc:
    port: 9000
    service: myservice   # opzionale: nome del servizio gRPC da testare

livenessProbe:
  httpGet: { path: /healthz, port: 8080 }
  initialDelaySeconds: 10   # Attesa PRIMA del primo check (dopo la startupProbe, se presente)
  periodSeconds: 10         # Intervallo tra i check
  timeoutSeconds: 2         # Timeout singolo check
  failureThreshold: 3       # N fallimenti consecutivi → azione (restart/remove)
  successThreshold: 1       # N successi consecutivi per tornare healthy (liveness: deve essere 1)

containers:
- name: slow-jvm-app
  image: myapp:v1
  ports:
  - containerPort: 8080
  # Startup: dà tempo all'app di avviarsi (fino a 5 min: 30 x 10s)
  # Durante questo periodo, readiness e liveness NON vengono eseguite.
  startupProbe:
    httpGet: { path: /healthz, port: 8080 }
    failureThreshold: 30
    periodSeconds: 10
  # Readiness: controlla se l'app può ricevere traffico.
  # Fallimento → il Pod esce dal Service, ma non viene riavviato.
  readinessProbe:
    httpGet: { path: /ready, port: 8080 }
    periodSeconds: 5
    failureThreshold: 3
  # Liveness: ultima risorsa — uccide il container se bloccato.
  # Endpoint separato: /ready può dipendere dal DB, /healthz solo dal processo.
  livenessProbe:
    httpGet: { path: /healthz, port: 8080 }
    periodSeconds: 20
    failureThreshold: 3
    initialDelaySeconds: 0   # Non serve: la startupProbe già ha dato tempo

spec:
  containers:
  - name: app
    image: myapp:v1

    # ── VARIABILI D'AMBIENTE ──────────────────────────────────────────────
    # Singola chiave come env var
    env:
    - name: DB_PASSWORD
      valueFrom:
        secretKeyRef:
          name: db-credentials
          key: DB_PASSWORD
    - name: LOG_LEVEL
      valueFrom:
        configMapKeyRef:
          name: app-config
          key: LOG_LEVEL

    # Tutte le chiavi del ConfigMap/Secret come env vars (nome chiave = nome var)
    envFrom:
    - configMapRef:
        name: app-config
    - secretRef:
        name: db-credentials

    # ── VOLUME MOUNT ──────────────────────────────────────────────────────
    # Il file di configurazione appare come file sul filesystem
    # VANTAGGIO: aggiornabile senza riavviare il Pod (hot reload se l'app supporta SIGHUP)
    # TEMPISTICA: il kubelet sincronizza la ConfigMap ogni ~1 minuto (--sync-frequency default).
    # La modifica diventa visibile nel volume in 60-90 secondi dall'aggiornamento della ConfigMap.
    # Le variabili d'ambiente (env/envFrom) NON si aggiornano — richiedono riavvio del Pod.
    volumeMounts:
    - name: nginx-config
      mountPath: /etc/nginx/conf.d/
      readOnly: true
    - name: tls-certs
      mountPath: /etc/ssl/private/
      readOnly: true

  volumes:
  - name: nginx-config
    configMap:
      name: nginx-config        # Ogni chiave → un file
      defaultMode: 0444         # read-only
  - name: tls-certs
    secret:
      secretName: myapp-tls
      defaultMode: 0400         # owner read-only (certificati privati)

# StorageClass per EBS su AWS
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: fast-ssd
provisioner: ebs.csi.aws.com
parameters:
  type: gp3
  iops: "3000"
reclaimPolicy: Delete    # Elimina il PV quando il PVC viene cancellato
volumeBindingMode: WaitForFirstConsumer  # Aspetta che il Pod sia schedulato
allowVolumeExpansion: true

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: postgres-data
spec:
  accessModes:
    - ReadWriteOnce    # Un solo nodo può montare in R/W
  storageClassName: fast-ssd
  resources:
    requests:
      storage: 50Gi

volumes:
- name: cache
  emptyDir:
    sizeLimit: 500Mi      # Limite opzionale (evita di riempire il disco del nodo)
- name: ram-cache
  emptyDir:
    medium: Memory         # Backed by RAM (tmpfs) — molto veloce, conta nel memory limit

apiVersion: v1
kind: ResourceQuota
metadata:
  name: team-a-quota
  namespace: team-a
spec:
  hard:
    requests.cpu: "10"          # Max 10 CPU totali richieste
    requests.memory: 20Gi       # Max 20Gi RAM totali richieste
    limits.cpu: "20"
    limits.memory: 40Gi
    pods: "50"                  # Max 50 Pod nel namespace
    persistentvolumeclaims: "10"
    services.loadbalancers: "2"

apiVersion: v1
kind: LimitRange
metadata:
  name: default-limits
  namespace: team-a
spec:
  limits:
  - type: Container
    default:              # Limiti applicati se il container non li specifica
      cpu: 500m
      memory: 256Mi
    defaultRequest:       # Request applicate se il container non le specifica
      cpu: 100m
      memory: 128Mi
    min:                  # Minimo consentito
      cpu: 50m
      memory: 64Mi
    max:                  # Massimo consentito
      cpu: "2"
      memory: 2Gi

apiVersion: v1
kind: Service
metadata:
  name: postgres
spec:
  clusterIP: None    # Headless Service — crea DNS per ogni Pod individualmente
  selector:
    app: postgres
  ports:
  - port: 5432
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: postgres
spec:
  serviceName: postgres    # Riferimento al Headless Service
  replicas: 3
  selector:
    matchLabels:
      app: postgres
  template:
    metadata:
      labels:
        app: postgres
    spec:
      containers:
      - name: postgres
        image: postgres:16
        ports:
        - containerPort: 5432
        env:
        - name: POSTGRES_PASSWORD
          valueFrom:
            secretKeyRef:
              name: pg-secret
              key: password
        - name: PGDATA
          value: /var/lib/postgresql/data/pgdata
        volumeMounts:
        - name: data
          mountPath: /var/lib/postgresql/data
        readinessProbe:
          exec:
            command: ["pg_isready", "-U", "postgres"]
          initialDelaySeconds: 5
          periodSeconds: 5
        resources:
          requests:
            memory: "256Mi"
            cpu: "250m"
          limits:
            memory: "512Mi"
            cpu: "1000m"
  # volumeClaimTemplates: genera un PVC per ogni replica
  # → data-postgres-0, data-postgres-1, data-postgres-2
  volumeClaimTemplates:
  - metadata:
      name: data
    spec:
      accessModes: ["ReadWriteOnce"]
      storageClassName: fast-ssd
      resources:
        requests:
          storage: 20Gi

spec:
  updateStrategy:
    type: OnDelete   # Aggiorna solo quando il Pod viene eliminato manualmente
    # type: RollingUpdate  # Default — aggiorna automaticamente dal Pod N a 0

apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: myapp-hpa
  namespace: production
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: myapp
  minReplicas: 2
  maxReplicas: 20
  metrics:
  # Scala su CPU (metrica più comune)
  - type: Resource
    resource:
      name: cpu
      target:
        type: Utilization
        averageUtilization: 60   # Scala quando CPU media > 60%
  # Scala su memoria
  - type: Resource
    resource:
      name: memory
      target:
        type: AverageValue
        averageValue: 200Mi
  behavior:
    scaleUp:
      stabilizationWindowSeconds: 30    # Aspetta 30s prima di scalare su
      policies:
      - type: Percent
        value: 100                       # Può raddoppiare in una volta
        periodSeconds: 15
    scaleDown:
      stabilizationWindowSeconds: 300   # Aspetta 5 min prima di scalare giù
      policies:
      - type: Pods
        value: 1                         # Rimuove al max 1 Pod alla volta
        periodSeconds: 60