update sync tls
This commit is contained in:
268
helm/tls-sync-wildcard/ops/VÉRIFICATION.md
Normal file
268
helm/tls-sync-wildcard/ops/VÉRIFICATION.md
Normal file
@@ -0,0 +1,268 @@
|
||||
# Guide de Vérification - TLS Sync Wildcard
|
||||
|
||||
Ce guide vous explique comment vérifier que le CronJob de synchronisation des certificats wildcard fonctionne correctement.
|
||||
|
||||
## 1. Vérifier que le CronJob est déployé
|
||||
|
||||
```bash
|
||||
# Vérifier que le CronJob existe
|
||||
kubectl get cronjob -n certificates-ops tls-sync-wildcard --context=cluster-ops
|
||||
|
||||
# Voir les détails du CronJob
|
||||
kubectl describe cronjob -n certificates-ops tls-sync-wildcard --context=cluster-ops
|
||||
|
||||
# Vérifier le schedule configuré
|
||||
kubectl get cronjob -n certificates-ops tls-sync-wildcard --context=cluster-ops -o jsonpath='{.spec.schedule}' && echo
|
||||
```
|
||||
|
||||
**Résultat attendu** : Le CronJob doit être présent avec un schedule (par exemple `0 * * * *` pour toutes les heures).
|
||||
|
||||
## 2. Vérifier que les Jobs sont créés
|
||||
|
||||
```bash
|
||||
# Lister tous les Jobs créés par le CronJob
|
||||
kubectl get jobs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops
|
||||
|
||||
# Voir les Jobs récents (dernières 24h)
|
||||
kubectl get jobs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops --sort-by=.metadata.creationTimestamp | tail -5
|
||||
|
||||
# Vérifier le statut du dernier Job
|
||||
kubectl get jobs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops -o wide | head -2
|
||||
```
|
||||
|
||||
**Résultat attendu** : Vous devriez voir des Jobs avec le statut `Complete` ou `Running`.
|
||||
|
||||
## 3. Voir les logs des Jobs
|
||||
|
||||
```bash
|
||||
# Voir les logs du dernier Job
|
||||
kubectl logs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops --tail=100
|
||||
|
||||
# Voir les logs d'un Job spécifique
|
||||
JOB_NAME=$(kubectl get jobs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops --sort-by=.metadata.creationTimestamp -o jsonpath='{.items[-1].metadata.name}')
|
||||
kubectl logs -n certificates-ops job/$JOB_NAME --context=cluster-ops
|
||||
|
||||
# Suivre les logs en temps réel (si un Job est en cours)
|
||||
kubectl logs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops -f
|
||||
```
|
||||
|
||||
**Résultat attendu** : Les logs doivent montrer :
|
||||
- `=== Synchronisation automatique des secrets TLS ===`
|
||||
- `📋 Traitement du certificat: wildcard-dev-tls`
|
||||
- `🌐 Certificat wildcard détecté`
|
||||
- `✅ Synchronisé avec succès dans <namespace>`
|
||||
|
||||
## 4. Vérifier que les secrets sont synchronisés
|
||||
|
||||
### Dans le cluster DEV
|
||||
|
||||
```bash
|
||||
# Vérifier que le secret existe dans headlamp-dev
|
||||
kubectl get secret wildcard-dev-tls -n headlamp-dev --context=cluster-dev
|
||||
|
||||
# Vérifier que le secret existe dans homarr-dev
|
||||
kubectl get secret wildcard-dev-tls -n homarr-dev --context=cluster-dev
|
||||
|
||||
# Vérifier que le secret existe dans longhorn-dev
|
||||
kubectl get secret wildcard-dev-tls -n longhorn-dev --context=cluster-dev
|
||||
|
||||
# Vérifier les détails d'un secret (date de création, taille, etc.)
|
||||
kubectl describe secret wildcard-dev-tls -n headlamp-dev --context=cluster-dev
|
||||
```
|
||||
|
||||
**Résultat attendu** : Les secrets doivent exister dans tous les namespaces configurés.
|
||||
|
||||
### Comparer les secrets entre namespaces
|
||||
|
||||
```bash
|
||||
# Comparer les certificats (doivent être identiques)
|
||||
kubectl get secret wildcard-dev-tls -n certificates-ops --context=cluster-ops -o jsonpath='{.data.tls\.crt}' | base64 -d | openssl x509 -noout -subject -dates
|
||||
kubectl get secret wildcard-dev-tls -n headlamp-dev --context=cluster-dev -o jsonpath='{.data.tls\.crt}' | base64 -d | openssl x509 -noout -subject -dates
|
||||
```
|
||||
|
||||
**Résultat attendu** : Les certificats doivent être identiques (même sujet, mêmes dates).
|
||||
|
||||
## 5. Déclencher manuellement une synchronisation
|
||||
|
||||
```bash
|
||||
# Créer un Job manuel à partir du CronJob
|
||||
kubectl create job --from=cronjob/tls-sync-wildcard tls-sync-wildcard-manual-$(date +%s) -n certificates-ops --context=cluster-ops
|
||||
|
||||
# Attendre quelques secondes puis voir les logs
|
||||
sleep 5
|
||||
kubectl logs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops --tail=50
|
||||
```
|
||||
|
||||
**Résultat attendu** : Un nouveau Job est créé et exécuté immédiatement.
|
||||
|
||||
## 6. Vérifier les permissions RBAC
|
||||
|
||||
```bash
|
||||
# Vérifier que le ServiceAccount existe
|
||||
kubectl get serviceaccount tls-sync-wildcard -n certificates-ops --context=cluster-ops
|
||||
|
||||
# Vérifier que le ClusterRole existe
|
||||
kubectl get clusterrole tls-sync-wildcard --context=cluster-ops
|
||||
|
||||
# Vérifier que le ClusterRoleBinding existe
|
||||
kubectl get clusterrolebinding tls-sync-wildcard --context=cluster-ops
|
||||
|
||||
# Tester les permissions du ServiceAccount
|
||||
kubectl auth can-i get secrets --namespace=certificates-ops --as=system:serviceaccount:certificates-ops:tls-sync-wildcard --context=cluster-ops
|
||||
kubectl auth can-i create secrets --namespace=headlamp-dev --as=system:serviceaccount:certificates-ops:tls-sync-wildcard --context=cluster-dev
|
||||
```
|
||||
|
||||
**Résultat attendu** : Toutes les commandes doivent retourner `yes`.
|
||||
|
||||
## 7. Vérifier le ConfigMap avec le script
|
||||
|
||||
```bash
|
||||
# Vérifier que le ConfigMap existe
|
||||
kubectl get configmap tls-sync-wildcard-script -n certificates-ops --context=cluster-ops
|
||||
|
||||
# Voir le contenu du script (premières lignes)
|
||||
kubectl get configmap tls-sync-wildcard-script -n certificates-ops --context=cluster-ops -o jsonpath='{.data.sync-all-certificates\.sh}' | head -20
|
||||
```
|
||||
|
||||
**Résultat attendu** : Le ConfigMap doit exister et contenir le script.
|
||||
|
||||
## 8. Vérifier le Secret kubeconfig
|
||||
|
||||
```bash
|
||||
# Vérifier que le Secret existe
|
||||
kubectl get secret tls-sync-kubeconfig -n certificates-ops --context=cluster-ops
|
||||
|
||||
# Vérifier que le fichier config est présent
|
||||
kubectl get secret tls-sync-kubeconfig -n certificates-ops --context=cluster-ops -o jsonpath='{.data.config}' | base64 -d | head -5
|
||||
```
|
||||
|
||||
**Résultat attendu** : Le Secret doit exister et contenir un fichier `config` valide.
|
||||
|
||||
## 9. Script de vérification complète
|
||||
|
||||
Créez un script pour vérifier tout d'un coup :
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Script de vérification complète du TLS Sync
|
||||
|
||||
echo "=== Vérification du TLS Sync Wildcard ==="
|
||||
echo ""
|
||||
|
||||
echo "1. CronJob..."
|
||||
kubectl get cronjob -n certificates-ops tls-sync-wildcard --context=cluster-ops 2>/dev/null && echo "✅ CronJob existe" || echo "❌ CronJob manquant"
|
||||
|
||||
echo ""
|
||||
echo "2. Derniers Jobs..."
|
||||
kubectl get jobs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops --sort-by=.metadata.creationTimestamp | tail -3
|
||||
|
||||
echo ""
|
||||
echo "3. Secrets dans cluster-dev..."
|
||||
for ns in headlamp-dev homarr-dev longhorn-dev; do
|
||||
if kubectl get secret wildcard-dev-tls -n "$ns" --context=cluster-dev &>/dev/null; then
|
||||
echo "✅ $ns: secret présent"
|
||||
else
|
||||
echo "❌ $ns: secret manquant"
|
||||
fi
|
||||
done
|
||||
|
||||
echo ""
|
||||
echo "4. Logs du dernier Job..."
|
||||
kubectl logs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops --tail=20 2>/dev/null | tail -5
|
||||
|
||||
echo ""
|
||||
echo "=== Vérification terminée ==="
|
||||
```
|
||||
|
||||
## 10. Dépannage des problèmes courants
|
||||
|
||||
### Le CronJob ne crée pas de Jobs
|
||||
|
||||
```bash
|
||||
# Vérifier les événements
|
||||
kubectl get events -n certificates-ops --context=cluster-ops --sort-by='.lastTimestamp' | grep tls-sync-wildcard | tail -10
|
||||
|
||||
# Vérifier le schedule
|
||||
kubectl get cronjob -n certificates-ops tls-sync-wildcard --context=cluster-ops -o yaml | grep -A 2 schedule
|
||||
```
|
||||
|
||||
### Les Jobs échouent
|
||||
|
||||
```bash
|
||||
# Voir les détails du Job en échec
|
||||
kubectl describe job -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops | tail -30
|
||||
|
||||
# Voir les logs d'erreur
|
||||
kubectl logs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops --tail=100 | grep -i error
|
||||
```
|
||||
|
||||
### Les secrets ne sont pas synchronisés
|
||||
|
||||
```bash
|
||||
# Vérifier que le certificat source existe
|
||||
kubectl get certificate wildcard-dev-tls -n certificates-ops --context=cluster-ops
|
||||
|
||||
# Vérifier que le secret source existe
|
||||
kubectl get secret wildcard-dev-tls -n certificates-ops --context=cluster-ops
|
||||
|
||||
# Vérifier les logs pour voir pourquoi la synchronisation a échoué
|
||||
kubectl logs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops --tail=200 | grep -A 10 "wildcard-dev-tls"
|
||||
```
|
||||
|
||||
### Erreur "context not found"
|
||||
|
||||
```bash
|
||||
# Vérifier que le Secret kubeconfig contient tous les contextes
|
||||
kubectl get secret tls-sync-kubeconfig -n certificates-ops --context=cluster-ops -o jsonpath='{.data.config}' | base64 -d | grep -E "contexts:|name:"
|
||||
|
||||
# Tester l'accès aux clusters depuis un pod de test
|
||||
kubectl run -it --rm test-kubeconfig --image=bitnami/kubectl:1.31 --restart=Never \
|
||||
-n certificates-ops \
|
||||
--context=cluster-ops \
|
||||
--overrides='
|
||||
{
|
||||
"spec": {
|
||||
"containers": [{
|
||||
"name": "test-kubeconfig",
|
||||
"image": "bitnami/kubectl:1.31",
|
||||
"volumeMounts": [{
|
||||
"name": "kubeconfig",
|
||||
"mountPath": "/root/.kube",
|
||||
"readOnly": true
|
||||
}]
|
||||
}],
|
||||
"volumes": [{
|
||||
"name": "kubeconfig",
|
||||
"secret": {
|
||||
"secretName": "tls-sync-kubeconfig"
|
||||
}
|
||||
}]
|
||||
}
|
||||
}' \
|
||||
-- kubectl config get-contexts
|
||||
```
|
||||
|
||||
## 11. Monitoring continu
|
||||
|
||||
Pour surveiller en continu :
|
||||
|
||||
```bash
|
||||
# Watch les Jobs
|
||||
watch -n 5 'kubectl get jobs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops'
|
||||
|
||||
# Watch les secrets dans un namespace
|
||||
watch -n 10 'kubectl get secret wildcard-dev-tls -n headlamp-dev --context=cluster-dev'
|
||||
```
|
||||
|
||||
## Résumé des commandes essentielles
|
||||
|
||||
```bash
|
||||
# Vérification rapide (tout en une fois)
|
||||
kubectl get cronjob,jobs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops && \
|
||||
kubectl logs -n certificates-ops -l app=tls-sync-wildcard --context=cluster-ops --tail=30 && \
|
||||
echo "--- Secrets dans cluster-dev ---" && \
|
||||
kubectl get secret wildcard-dev-tls -n headlamp-dev --context=cluster-dev && \
|
||||
kubectl get secret wildcard-dev-tls -n homarr-dev --context=cluster-dev && \
|
||||
kubectl get secret wildcard-dev-tls -n longhorn-dev --context=cluster-dev
|
||||
```
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Configuration pour le CronJob de synchronisation des secrets TLS wildcard
|
||||
tlsSync:
|
||||
# Schedule Cron pour la synchronisation (toutes les heures par défaut)
|
||||
schedule: "0 * * * *" # Toutes les heures
|
||||
schedule: "*/5 * * * *" # Toutes les 5 minutes
|
||||
|
||||
# Cluster source (où les certificats sont générés)
|
||||
sourceCluster: "cluster-ops"
|
||||
|
||||
Reference in New Issue
Block a user