api7-demo/web/docs/argocd-values-guide.md

# ArgoCD Values Update Guide

Questo documento descrive le modifiche da applicare al `values.yaml` in ArgoCD.

## 📋 Modifiche Principali

### 1. Service Discovery - DISABILITATO

**Prima:**
```yaml
api7:
  serviceDiscovery:
    enabled: true
```

**Dopo:**
```yaml
api7:
  serviceDiscovery:
    enabled: false  # Disabled until Service Registry is configured in API7 Dashboard
    namespace: ""
```

**Motivo:** Service discovery richiede la configurazione di un Service Registry nel Dashboard API7 Enterprise. Finché non viene configurato, ADC sync fallisce con errore `service registry not found`.

---

### 2. Existing Secret - CONFIGURATO

**Prima:**
```yaml
api7:
  gateway:
    existingSecret: ""
```

**Dopo:**
```yaml
api7:
  gateway:
    # Use existing secret for production (recommended)
    # The secret api7-credentials already exists with the correct admin key
    existingSecret: "api7-credentials"
    existingSecretKeys:
      adminUrl: admin-url
      adminKey: admin-key
      group: gateway-group
```

**Motivo:** Il Secret `api7-credentials` esiste già nel namespace `api7ee` con la chiave admin corretta. Usarlo evita di creare un nuovo Secret vuoto.

---

### 3. Gateway Namespace - AGGIUNTO

**Prima:**
```yaml
api7:
  gateway:
    gatewayService: gateway-0-1759393614-gateway
```

**Dopo:**
```yaml
api7:
  gateway:
    gatewayService: gateway-0-1759393614-gateway
    gatewayNamespace: api7ee
```

---

### 4. ADC Resources - CONFIGURATE

```yaml
api7:
  adc:
    resources:
      limits:
        cpu: 500m
        memory: 256Mi
      requests:
        cpu: 100m
        memory: 128Mi
```

---

### 5. Ingress Configuration - AGGIORNATA

**Prima:**
```yaml
ingress:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
  hosts:
    - host: commandware.it
      paths:
        - path: /
          gateway:
            serviceName: gateway-0-1759393614-gateway
            port: 80
        - path: /api
          gateway:
            serviceName: gateway-0-1759393614-gateway
            port: 80
  tls:
    - secretName: api7ee-demo-tls
```

**Dopo:**
```yaml
ingress:
  className: nginx
  annotations:
    cert-manager.io/cluster-issuer: cloudflare-acme-prod
  hosts:
    - host: commandware.it
      paths:
        - path: /
          pathType: Prefix
          gateway:
            serviceName: gateway-0-1759393614-gateway
            port: 80
            namespace: api7ee
  tls:
    - secretName: api7ee-tls
      hosts:
        - commandware.it
```

**Modifiche:**
- Rimossa annotation `nginx.ingress.kubernetes.io/rewrite-target: /`
- Aggiunta annotation `cert-manager.io/cluster-issuer`
- Un solo path `/` invece di due path separati (`/` e `/api`)
- Aggiunto `namespace: api7ee` al gateway
- Cambiato `secretName` da `api7ee-demo-tls` a `api7ee-tls`

---

### 6. TLS Configuration - COMPLETATA

```yaml
api7:
  tls:
    enabled: true
    certManager:
      enabled: true
      issuer: cloudflare-acme-prod
      issuerKind: ClusterIssuer
    privateKey:
      rotationPolicy: Always
      algorithm: RSA
      size: 2048
    duration: 2160h  # 90 days
    renewBefore: 720h  # 30 days before expiry
```

---

## 🔄 Come Applicare le Modifiche

### Opzione 1: Interfaccia Web ArgoCD

1. Accedi ad ArgoCD Dashboard
2. Seleziona l'applicazione `api7ee-demo`
3. Clicca su "APP DETAILS" → "PARAMETERS"
4. Modifica i valori come sopra indicato
5. Clicca "SAVE"
6. Clicca "SYNC" per applicare le modifiche

### Opzione 2: Via CLI

```bash
# Edit application
kubectl edit application -n argocd api7ee-demo

# O usa ArgoCD CLI
argocd app set api7ee-demo --values /path/to/updated-values.yaml
argocd app sync api7ee-demo
```

### Opzione 3: Usa il values.yaml aggiornato

Il file `values.yaml` nella root del progetto è già stato aggiornato con tutte le modifiche.
Puoi copiarlo direttamente nella configurazione ArgoCD.

---

## ✅ Verifica Post-Sync

Dopo la sincronizzazione, verifica che tutto funzioni:

### 1. Check ConfigMap
```bash
kubectl get configmap -n api7ee api7ee-demo-api7ee-demo-k8s-adc-config \
  -o jsonpath='{.data.adc-config\.yaml}' | grep "discovery_type"
```
**Risultato atteso:** Nessun output (service discovery disabilitato)

### 2. Check Secret
```bash
kubectl get secret -n api7ee api7ee-demo-api7ee-demo-k8s-api7-admin \
  -o jsonpath='{.data.admin-key}' | base64 -d | wc -c
```
**Risultato atteso:** `88` (chiave presente)

### 3. Check ADC Sync Job
```bash
kubectl logs -n api7ee job/api7ee-demo-api7ee-demo-k8s-adc-sync --tail=20
```
**Risultato atteso:**
```
[ADC] › ✔  success   Sync configuration
[ADC] › ★  star      All is well, see you next time!
```

### 4. Test Routing
```bash
# Test web
curl -I https://commandware.it/

# Test API
curl -I https://commandware.it/api/health
```
**Risultato atteso:** HTTP 200 o 405 (metodi funzionanti)

---

## 📝 Note Importanti

### Service Discovery
Per riabilitare service discovery in futuro:

1. **Configura Service Registry nel Dashboard API7:**
   - Accedi al Dashboard: `https://api7ee3-0-1759339083-dashboard:7443`
   - Vai a: Gateway Groups → Service Registries
   - Aggiungi: Kubernetes Service Registry
   - Configura: API Server URL e Token

2. **Abilita nel values.yaml:**
   ```yaml
   api7:
     serviceDiscovery:
       enabled: true
   ```

3. **Sync ArgoCD**

### Secret Management
Il Secret `api7-credentials` contiene:
- `admin-url`: URL del Dashboard API7
- `admin-key`: Chiave di autenticazione (88 caratteri)
- `gateway-group`: Nome del gateway group (`default`)

Per ruotare le credenziali:
```bash
kubectl patch secret -n api7ee api7-credentials \
  -p '{"data":{"admin-key":"<new-base64-encoded-key>"}}'
```

---

## 🔗 Riferimenti

- [Service Discovery Guide](web/docs/service-discovery.md)
- [Secret Management Guide](web/docs/secret-management.md)
- [Ingress & Routing Guide](web/docs/ingress-routing.md)
- [API7 Enterprise Docs](https://docs.api7.ai/enterprise/)

---

**Data aggiornamento:** 2025-10-09
**Versione Chart:** api7ee-demo-k8s-0.1.0