netbird-sync¶
Contrôleur Go (namespace netbird-sync) qui crée une resource et une policy NetBird pour chaque Service d'instance, au bénéfice du groupe de l'équipe. Sans lui, un joueur ne peut atteindre aucune instance.
Symptômes¶
NetbirdSyncErrors: des réconciliations échouent (netbird_sync_reconcile_errors_totalaugmente).NetbirdSyncDeploymentDown(critique) : plus de pod.- Un joueur a une instance démarrée mais ne peut pas la joindre en VPN.
Alertes concernées¶
| Alerte | Sévérité | Durée | Résumé |
|---|---|---|---|
NetbirdSyncDeploymentDown |
critical | 5m | netbird-sync n'a plus aucun pod disponible |
NetbirdSyncErrors |
warning | 15m | netbird-sync échoue à réconcilier des instances |
Expressions PromQL
Diagnostic¶
export KUBECONFIG="$PWD/.state/kubeconfig"
kubectl -n netbird-sync get pods
kubectl -n netbird-sync logs deploy/netbird-sync --tail=100 | jq -r 'select(.level=="ERROR" or .level=="WARN") | "\(.time) \(.msg) \(.err // "")"'
# Services d'instance suivis, et finalizer
kubectl get svc -A --field-selector spec.type=LoadBalancer -o json \
| jq -r '.items[] | select(.metadata.namespace|startswith("inst-")) | "\(.metadata.namespace)/\(.metadata.name) \(.status.loadBalancer.ingress[0].ip // "pas d IP") \(.metadata.finalizers)"'
Remédiation¶
- 401/403 de l'API NetBird : le jeton (PAT de l'utilisateur de service
netbird-sync) est expiré ou révoqué. Le recréer dans le dashboard NetBird, le placer dans le secret SOPS degitops/apps/netbird-sync(NETBIRD_API_TOKEN), commiter. Voir Actions manuelles. namespace ... sans label pad.io/team: l'instance a été créée hors du scénario standard. Le namespace doit porterpad.io/team(etpad.io/challenge).- NetBird injoignable : le LXC
netbirdou l'edgeest en cause ; vérifierhttps://vpn.example.net. - Joueur sans accès malgré une policy : vérifier qu'il est bien dans le groupe
ctf-team-<id>. netbird-sync l'y rattache lui-même (membres CTFd de l'équipe, rapprochés des utilisateurs NetBird par e-mail, toutes les minutes) : contrôler que le joueur a bien enrôlé un pair NetBird avec le même e-mail que son compte CTFd, puis les journaux (membres du groupe d'équipe synchronisés). Vérifier ensuite que les règles OPNsense autorisent le routing peer vers l'IP d'instance (action manuelle). policy NetBird ouverte à tous/ refus de démarrer : une policy active a le groupeAllen source (typiquementDefault). Aucune écriture NetBird n'est faite tant qu'elle existe. La supprimer dans le dashboard (Access Control > Policies) ; le contrôleur reprend seul. La métriquenetbird_sync_open_policiesdoit retomber à 0.ctfd: ... HTTP 401/503:PAD_INTERNAL_TOKENdu secret netbird-sync diffère de celui dectfd-secrets, ou n'est pas configuré côté CTFd.- Service bloqué en
Terminating: le finalizerpad.io/netbird-syncattend le nettoyage NetBird. Corriger l'erreur d'API ; en dernier recours, supprimer la policy et la resource à la main dans NetBird, puiskubectl patch svc -n inst-<id> <nom> --type=merge -p '{"metadata":{"finalizers":null}}'.
Escalade¶
Une réconciliation complète a lieu toutes les 10 minutes : après correction du jeton, les instances en retard se rattrapent seules.
Retour à l'index des runbooks.