# Deployment BLAU: la versió que està servint avui.
apiVersion: apps/v1
kind: Deployment
metadata:
  name: api-reserves-blau
  namespace: rutas-norte-pro
spec:
  selector:
    matchLabels:
      app.kubernetes.io/name: api-reserves
      rutasnorte.example/color: blau
  template:
    metadata:
      labels:
        app.kubernetes.io/name: api-reserves
        rutasnorte.example/color: blau     # ← l'etiqueta que ho decideix tot
        rutasnorte.example/versio: "2.7.0"
    spec:
      # ... idèntic al Deployment d'11-01
      containers:
        - name: api
          image: registry.rutasnorte.example/rutasnorte/api-reserves@sha256:3f9c1b7e5a04c2d8f61b93ae7c05d2419e8f6ab3c4d5e6f708192a3b4c5d6e7f
---
# Deployment VERD: la versió candidata.
apiVersion: apps/v1
kind: Deployment
metadata:
  name: api-reserves-verd
  namespace: rutas-norte-pro
spec:
  selector:
    matchLabels:
      app.kubernetes.io/name: api-reserves
      rutasnorte.example/color: verd
  template:
    metadata:
      labels:
        app.kubernetes.io/name: api-reserves
        rutasnorte.example/color: verd
        rutasnorte.example/versio: "2.8.0"
    spec:
      containers:
        - name: api
          image: registry.rutasnorte.example/rutasnorte/api-reserves@sha256:9a8b7c6d5e4f30291a8b7c6d5e4f30291a8b7c6d5e4f30291a8b7c6d5e4f3029
---
# Service PRODUCTIU: el que fa servir l'Ingress. El seu selector és l'interruptor.
apiVersion: v1
kind: Service
metadata:
  name: api-reserves
  namespace: rutas-norte-pro
spec:
  selector:
    app.kubernetes.io/name: api-reserves
    rutasnorte.example/color: blau       # ← canviar aquí = publicar
  ports:
    - { name: http, port: 80, targetPort: http }
---
# Service de PREVISUALITZACIÓ: apunta sempre a verd, sense trànsit d'usuaris.
apiVersion: v1
kind: Service
metadata:
  name: api-reserves-preview
  namespace: rutas-norte-pro
spec:
  selector:
    app.kubernetes.io/name: api-reserves
    rutasnorte.example/color: verd
  ports:
    - { name: http, port: 80, targetPort: http }
---
# Ingress de previsualització: URL interna per validar la candidata.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: api-reserves-preview
  namespace: rutas-norte-pro
  annotations:
    # Només des de la xarxa corporativa: no és una URL pública.
    nginx.ingress.kubernetes.io/whitelist-source-range: "203.0.113.0/24"
    cert-manager.io/cluster-issuer: letsencrypt-produccio
spec:
  ingressClassName: nginx
  tls:
    - hosts: ["api-preview.rutasnorte.example"]
      secretName: api-preview-tls
  rules:
    - host: api-preview.rutasnorte.example
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service: { name: api-reserves-preview, port: { name: http } }

# --- 1. Desplegar la candidata en verd (sense trànsit d'usuaris) ---
kubectl -n rutas-norte-pro set image deploy/api-reserves-verd \
  api=registry.rutasnorte.example/rutasnorte/api-reserves@sha256:9a8b7c6d...
kubectl -n rutas-norte-pro rollout status deploy/api-reserves-verd --timeout=10m
kubectl -n rutas-norte-pro scale deploy/api-reserves-verd --replicas=8

# --- 2. Validar sense trànsit real ---
# Proves de fum contra la URL de previsualització
npm run proves:fum -- --base-url https://api-preview.rutasnorte.example
# Prova de càrrega suau per descartar regressions evidents de rendiment
k6 run --vus 40 --duration 5m proves/carrega-preview.js
# Comprovació manual del flux de compra complet per part de producte

# --- 3. Commutar (això és la publicació: dura mil·lisegons) ---
kubectl -n rutas-norte-pro patch svc api-reserves \
  -p '{"spec":{"selector":{"rutasnorte.example/color":"verd"}}}'

# --- 4. Vigilar ---
watch -n5 'curl -sG http://prometheus.rutas-norte.example/api/v1/query \
  --data-urlencode "query=sum(rate(api_reserves_peticions_total{codi=~\"5..\"}[2m]))
                          / sum(rate(api_reserves_peticions_total[2m]))" | jq -r ".data.result[0].value[1]"'

# --- 5. Revertir, si cal (segons) ---
kubectl -n rutas-norte-pro patch svc api-reserves \
  -p '{"spec":{"selector":{"rutasnorte.example/color":"blau"}}}'

-- ===== Migració 1: EXPANDIR (compatible amb 2.7.0) =====
-- Afegir, mai reanomenar ni esborrar.
ALTER TABLE reserves ADD COLUMN placa integer;

-- Copiar l'històric en lots, sense bloquejar la taula.
UPDATE reserves SET placa = seient
 WHERE placa IS NULL AND id IN (SELECT id FROM reserves WHERE placa IS NULL LIMIT 5000);
-- (es repeteix fins a exhaurir; en producció, mitjançant un Job per lots)

-- Disparador que manté totes dues columnes sincronitzades mentre
-- conviuen versions que escriuen en una o en l'altra.
CREATE OR REPLACE FUNCTION sincronitzar_placa() RETURNS trigger AS $$
BEGIN
  IF NEW.placa IS NULL THEN NEW.placa := NEW.seient; END IF;
  IF NEW.seient IS NULL THEN NEW.seient := NEW.placa; END IF;
  RETURN NEW;
END; $$ LANGUAGE plpgsql;

CREATE TRIGGER trg_sincronitzar_placa
  BEFORE INSERT OR UPDATE ON reserves
  FOR EACH ROW EXECUTE FUNCTION sincronitzar_placa();

-- ===== Migració 2: CONTRAURE (només quan NINGÚ no usa 'seient') =====
-- Setmanes després, amb la versió antiga ja retirada del tot.
DROP TRIGGER trg_sincronitzar_placa ON reserves;
DROP FUNCTION sincronitzar_placa();
ALTER TABLE reserves DROP COLUMN seient;
ALTER TABLE reserves ALTER COLUMN placa SET NOT NULL;

# 19 rèpliques estables + 1 de canària ≈ 5 % del trànsit
apiVersion: apps/v1
kind: Deployment
metadata:
  name: api-reserves-canari
  namespace: rutas-norte-pro
spec:
  replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/name: api-reserves
      rutasnorte.example/pista: canari
  template:
    metadata:
      labels:
        app.kubernetes.io/name: api-reserves    # el Service selecciona per aquesta
        rutasnorte.example/pista: canari

# Ingress principal: sense canvis respecte a 11-01.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: api-reserves
  namespace: rutas-norte-pro
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt-produccio
spec:
  ingressClassName: nginx
  tls:
    - hosts: ["api.rutasnorte.example"]
      secretName: api-rutasnorte-tls
  rules:
    - host: api.rutasnorte.example
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service: { name: api-reserves-estable, port: { name: http } }
---
# Ingress CANARI: mateix host, backend diferent, amb pes.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: api-reserves-canari
  namespace: rutas-norte-pro
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt-produccio
    # Activa el mode canari per a aquest Ingress.
    nginx.ingress.kubernetes.io/canary: "true"
    # Percentatge del trànsit que va al canari.
    nginx.ingress.kubernetes.io/canary-weight: "5"
    # Capçalera d'escapament: força el canari per a proves internes,
    # independentment del pes.
    nginx.ingress.kubernetes.io/canary-by-header: "X-Rutasnorte-Canari"
    nginx.ingress.kubernetes.io/canary-by-header-value: "sempre"
    # Cookie: un cop assignat, l'usuari es queda a la seva versió.
    nginx.ingress.kubernetes.io/canary-by-cookie: "rutasnorte_canari"
spec:
  ingressClassName: nginx
  tls:
    - hosts: ["api.rutasnorte.example"]
      secretName: api-rutasnorte-tls
  rules:
    - host: api.rutasnorte.example          # ← MATEIX host que el principal
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service: { name: api-reserves-canari, port: { name: http } }

# Validació interna dirigida al canari, amb 0 % de pes
curl -H 'X-Rutasnorte-Canari: sempre' https://api.rutasnorte.example/horaris?linia=BIL-SAN

for PES in 5 10 25 50 100; do
  kubectl -n rutas-norte-pro annotate ingress api-reserves-canari \
    nginx.ingress.kubernetes.io/canary-weight="$PES" --overwrite
  echo "Pes al $PES %. Observant 10 minuts..."
  sleep 600
  # aquí algú mira Grafana i decideix si continua
done

apiVersion: argoproj.io/v1alpha1
kind: Rollout
metadata:
  name: api-reserves
  namespace: rutas-norte-pro
spec:
  # replicas ho continua governant l'HPA, que ara apunta al Rollout.
  revisionHistoryLimit: 5
  selector:
    matchLabels:
      app.kubernetes.io/name: api-reserves
  # 'template' és idèntic al del Deployment d'11-01: mateixes sondes,
  # mateix securityContext, mateixos recursos, mateix topologySpread.
  template:
    metadata:
      labels:
        app.kubernetes.io/name: api-reserves
    spec:
      serviceAccountName: api-reserves
      containers:
        - name: api
          image: registry.rutasnorte.example/rutasnorte/api-reserves@sha256:9a8b7c6d5e4f30291a8b7c6d5e4f30291a8b7c6d5e4f30291a8b7c6d5e4f3029
          # ... resta idèntica a 11-01

  strategy:
    canary:
      canaryService: api-reserves-canari      # Services que el controlador
      stableService: api-reserves-estable     # reetiqueta automàticament
      trafficRouting:
        nginx:
          stableIngress: api-reserves          # crea i gestiona l'Ingress canari
      # Anàlisi que s'executa en paral·lel a TOTA la progressió.
      analysis:
        templates:
          - templateName: analisi-api-reserves
        startingStep: 1        # comença en assolir el primer pes
        args:
          - name: servei-canari
            value: api-reserves-canari
      steps:
        - setWeight: 5
        - pause: { duration: 10m }     # 10 min amb el 5 % del trànsit
        - setWeight: 25
        - pause: { duration: 15m }
        - setWeight: 50
        - pause: { duration: 20m }
        - setWeight: 75
        - pause: { duration: 10m }
        # Sense durada: espera aprovació humana explícita abans del 100 %.
        - pause: {}
      # Finestres de seguretat
      scaleDownDelaySeconds: 600   # la versió anterior continua viva 10 min després de promocionar
      abortScaleDownDelaySeconds: 30
      maxSurge: "25%"
      maxUnavailable: 0

apiVersion: argoproj.io/v1alpha1
kind: AnalysisTemplate
metadata:
  name: analisi-api-reserves
  namespace: rutas-norte-pro
spec:
  args:
    - name: servei-canari
  metrics:

    # --- 1. Taxa d'error 5xx ---
    - name: taxa-error
      interval: 1m
      # Tolera 2 mesures dolentes aïllades; 3 de consecutives avorten.
      failureLimit: 2
      consecutiveErrorLimit: 3
      # No jutja durant els primers 2 min: els pods s'estan escalfant.
      initialDelay: 2m
      provider:
        prometheus:
          address: http://prometheus-operated.monitoratge:9090
          query: |
            sum(rate(api_reserves_peticions_total{
              service="{{args.servei-canari}}", codi=~"5.."
            }[2m]))
            /
            sum(rate(api_reserves_peticions_total{
              service="{{args.servei-canari}}"
            }[2m]))
      # Èxit si el resultat és < 0,5 %. NaN (sense trànsit) també s'accepta:
      # sense peticions no hi ha evidència de fallada.
      successCondition: result[0] < 0.005 || isNaN(result[0])

    # --- 2. Percentil 95 de latència ---
    - name: latencia-p95
      interval: 1m
      failureLimit: 2
      initialDelay: 2m
      provider:
        prometheus:
          address: http://prometheus-operated.monitoratge:9090
          query: |
            histogram_quantile(0.95,
              sum by (le) (rate(api_reserves_duracio_segons_bucket{
                service="{{args.servei-canari}}"
              }[2m]))
            )
      successCondition: result[0] < 0.35 || isNaN(result[0])   # 350 ms

    # --- 3. Comparació relativa contra la versió estable ---
    # Un llindar absolut pot passar per alt una regressió si el sistema
    # ja anava lent. Aquesta mètrica exigeix que el canari no sigui més d'un 20 %
    # pitjor que l'estable.
    - name: latencia-relativa
      interval: 2m
      failureLimit: 1
      initialDelay: 5m
      provider:
        prometheus:
          address: http://prometheus-operated.monitoratge:9090
          query: |
            (
              histogram_quantile(0.95, sum by (le) (rate(
                api_reserves_duracio_segons_bucket{service="api-reserves-canari"}[3m])))
              /
              histogram_quantile(0.95, sum by (le) (rate(
                api_reserves_duracio_segons_bucket{service="api-reserves-estable"}[3m])))
            )
      successCondition: result[0] < 1.2 || isNaN(result[0])

    # --- 4. Mètrica de negoci: la que de debò importa ---
    # Una versió pot tenir 0 errors i latència perfecta, i haver trencat
    # el botó de "confirmar reserva". Això ho detecta.
    - name: taxa-conversio
      interval: 5m
      failureLimit: 1
      initialDelay: 10m
      provider:
        prometheus:
          address: http://prometheus-operated.monitoratge:9090
          query: |
            sum(rate(api_reserves_reserves_confirmades_total{
              service="api-reserves-canari"}[5m]))
            /
            sum(rate(api_reserves_reserves_iniciades_total{
              service="api-reserves-canari"}[5m]))
      successCondition: result[0] > 0.55 || isNaN(result[0])

kubectl argo rollouts get rollout api-reserves -n rutas-norte-pro --watch

Name:            api-reserves
Namespace:       rutas-norte-pro
Status:          ✖ Degraded
Message:         RolloutAborted: metric "taxa-error" assessed Failed
Strategy:        Canary
  Step:          2/9
  SetWeight:     0
  ActualWeight:  0
Images:          api-reserves@sha256:3f9c1b7e (stable)
                 api-reserves@sha256:9a8b7c6d (canary)
Replicas:
  Desired:       8
  Current:       8
  Updated:       0
  Ready:         8
  Available:     8

NAME                                     KIND         STATUS        AGE   INFO
⟳ api-reserves                           Rollout      ✖ Degraded    41d
├──# revision:18
│  └──⧉ api-reserves-6d9f7b4c8            ReplicaSet   • ScaledDown  14m   canary
│     └──⊞ analisi-api-reserves-18        AnalysisRun  ✖ Failed      12m
│        ├──📊 taxa-error                 Measurement  ✖ Failed            0.021
│        └──📊 latencia-p95               Measurement  ✔ Successful        0.198
└──# revision:17
   └──⧉ api-reserves-7d4b8c9f5            ReplicaSet   ✔ Healthy     14d   stable

kubectl argo rollouts promote api-reserves -n rutas-norte-pro        # avançar un pas
kubectl argo rollouts promote api-reserves -n rutas-norte-pro --full # saltar al 100 %
kubectl argo rollouts abort api-reserves -n rutas-norte-pro          # avortar ja
kubectl argo rollouts undo api-reserves -n rutas-norte-pro --to-revision=17

kubectl argo rollouts dashboard -n rutas-norte-pro

# A l'Application d'Argo CD
spec:
  ignoreDifferences:
    - group: argoproj.io
      kind: Rollout
      jsonPointers:
        - /spec/replicas          # ho governa l'HPA
  syncPolicy:
    automated:
      selfHeal: true
      # El controlador de Rollouts modifica els Services durant la
      # progressió; sense això, selfHeal lluitaria contra ell.
    syncOptions:
      - RespectIgnoreDifferences=true

spec:
  scaleTargetRef:
    apiVersion: argoproj.io/v1alpha1
    kind: Rollout
    name: api-reserves

apiVersion: flagger.app/v1beta1
kind: Canary
metadata:
  name: api-reserves
  namespace: rutas-norte-pro
spec:
  targetRef:
    apiVersion: apps/v1
    kind: Deployment          # ← el Deployment original, sense tocar
    name: api-reserves
  autoscalerRef:
    apiVersion: autoscaling/v2
    kind: HorizontalPodAutoscaler
    name: api-reserves
  provider: nginx
  service:
    port: 80
    targetPort: 8080
  analysis:
    interval: 1m
    threshold: 5              # mesures fallides abans d'avortar
    maxWeight: 50
    stepWeight: 10
    metrics:
      - name: request-success-rate
        thresholdRange: { min: 99.5 }
        interval: 2m
      - name: request-duration
        thresholdRange: { max: 350 }
        interval: 2m
    webhooks:
      - name: proves-de-carrega
        type: rollout
        url: http://flagger-loadtester.plataforma/
        metadata:
          cmd: "hey -z 2m -q 10 -c 2 http://api-reserves-canary.rutas-norte-pro/horaris"

// api-reserves: la funcionalitat viatja desplegada però apagada.
app.post('/reserves', async (req, res) => {
  const usarNouMotor = await banderes.activa('motor-preus-v2', {
    usuariId: req.usuari.id,
    percentatge: 5,                      // desplegament progressiu per usuari
    llistaBlanca: ['empleats-rutasnorte']
  });

  const preu = usarNouMotor
    ? await motorPreusV2.calcular(req.body)
    : await motorPreusV1.calcular(req.body);

  // Mètrica etiquetada per bandera: permet comparar tots dos camins
  // a Grafana sense desplegar res diferent.
  metriques.preuCalculat.inc({ motor: usarNouMotor ? 'v2' : 'v1' });
  ...
});

# AnalysisTemplate específic per a aquesta publicació, amb llindars més
# estrictes de l'habitual per la proximitat de la temporada alta.
apiVersion: argoproj.io/v1alpha1
kind: AnalysisTemplate
metadata:
  name: analisi-pont-maig
  namespace: rutas-norte-pro
spec:
  metrics:
    - name: taxa-error
      interval: 30s
      failureLimit: 1            # tolerància mínima: una mesura dolenta avorta
      initialDelay: 2m
      provider:
        prometheus:
          address: http://prometheus-operated.monitoratge:9090
          query: |
            sum(rate(api_reserves_peticions_total{service="api-reserves-canari",codi=~"5.."}[2m]))
            / sum(rate(api_reserves_peticions_total{service="api-reserves-canari"}[2m]))
      successCondition: result[0] < 0.003 || isNaN(result[0])      # 0,3 %

    - name: latencia-p95
      interval: 30s
      failureLimit: 1
      initialDelay: 2m
      provider:
        prometheus:
          address: http://prometheus-operated.monitoratge:9090
          query: |
            histogram_quantile(0.95, sum by (le) (rate(
              api_reserves_duracio_segons_bucket{service="api-reserves-canari"}[2m])))
      successCondition: result[0] < 0.30 || isNaN(result[0])        # 300 ms

    - name: errors-passarela-pagaments
      interval: 1m
      failureLimit: 1
      initialDelay: 5m
      provider:
        prometheus:
          address: http://prometheus-operated.monitoratge:9090
          query: |
            sum(rate(api_reserves_pagaments_fallits_total{service="api-reserves-canari"}[5m]))
            / sum(rate(api_reserves_pagaments_intents_total{service="api-reserves-canari"}[5m]))
      successCondition: result[0] < 0.02 || isNaN(result[0])        # 2 %

    - name: conversio
      interval: 5m
      failureLimit: 1
      initialDelay: 15m
      provider:
        prometheus:
          address: http://prometheus-operated.monitoratge:9090
          query: |
            sum(rate(api_reserves_reserves_confirmades_total{service="api-reserves-canari"}[10m]))
            / sum(rate(api_reserves_reserves_iniciades_total{service="api-reserves-canari"}[10m]))
      successCondition: result[0] > 0.55 || isNaN(result[0])

metrics:
  - name: taxa-error
    interval: 10s
    failureLimit: 0
    provider:
      prometheus:
        address: http://prometheus-operated.monitoratge:9090
        query: |
          sum(rate(api_reserves_peticions_total{codi=~"5.."}[30s]))
          / sum(rate(api_reserves_peticions_total[30s]))
    successCondition: result[0] < 0.001

metrics:
  - name: taxa-error
    interval: 1m
    failureLimit: 2
    consecutiveErrorLimit: 3
    initialDelay: 2m
    provider:
      prometheus:
        address: http://prometheus-operated.monitoratge:9090
        query: |
          sum(rate(api_reserves_peticions_total{service="api-reserves-canari",codi=~"5.."}[2m]))
          / sum(rate(api_reserves_peticions_total{service="api-reserves-canari"}[2m]))
    successCondition: result[0] < 0.005 || isNaN(result[0])