update doc

helm/certificates/ops/docs/README.md

@@ -0,0 +1,65 @@
+# Certificats Let's Encrypt pour le cluster OPS
+
+Ce chart gère les certificats Let's Encrypt générés par cert-manager dans le cluster OPS.
+
+## Structure
+
+- `Chart.yaml` : Définition du chart Helm
+- `templates/` : Dossiers organisés par application (uniquement des fichiers YAML)
+  - `homarr/` : Certificats pour l'application Homarr
+  - `[autre-app]/` : Certificats pour d'autres applications
+- `docs/` : Documentation par application
+  - `homarr/README.md` : Documentation pour les certificats Homarr
+
+**⚠️ IMPORTANT** : Seuls les fichiers YAML doivent être dans `templates/`. Les fichiers de documentation doivent être dans `docs/`.
+
+## Ajout d'un nouveau certificat
+
+### Pour une application existante
+
+Ajoutez un fichier dans le dossier de l'application (ex: `templates/homarr/`) :
+
+```yaml
+apiVersion: cert-manager.io/v1
+kind: Certificate
+metadata:
+  name: <app>-<env>-tls
+  namespace: <app>-<env>  # Le namespace où sera utilisé le secret TLS
+spec:
+  secretName: <app>-<env>-tls
+  issuerRef:
+    name: letsencrypt-prod  # ou letsencrypt-staging pour les tests
+    kind: ClusterIssuer
+  dnsNames:
+    - <domain>
+```
+
+### Pour une nouvelle application
+
+1. Créez un nouveau dossier dans `templates/` : `templates/<app>/`
+2. Créez le fichier Certificate dans ce dossier (uniquement des fichiers YAML)
+3. Optionnellement, créez un `README.md` dans `docs/<app>/` pour documenter les certificats de cette application
+
+## Déploiement
+
+Les certificats sont déployés automatiquement via l'ApplicationSet `certificates-apps` dans ArgoCD.
+
+## Vérification
+
+```bash
+# Vérifier les certificats
+kubectl get certificates -A
+
+# Vérifier un certificat spécifique
+kubectl describe certificate homarr-dev-tls -n homarr-dev
+
+# Vérifier le secret TLS créé
+kubectl get secret homarr-dev-tls -n homarr-dev
+```
+
+## Notes importantes
+
+- Les certificats sont créés dans le cluster OPS où cert-manager est installé
+- Le namespace du Certificate doit correspondre au namespace où le secret TLS sera utilisé
+- Pour utiliser le certificat dans d'autres clusters (DEV, RCT, PRD), le secret TLS doit être synchronisé depuis OPS
+