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/) :

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

Créez un nouveau dossier dans templates/ : templates/<app>/
Créez le fichier Certificate dans ce dossier (uniquement des fichiers YAML)
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

# 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

2.1 KiB Raw Blame History