Rolle `semaphore_secrets`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/semaphore_secrets.md
Rolle semaphore_secrets
Bootstrap-Secret für den Semaphore-Pod.
| Läuft gegen | controlplane-0 |
| Tags | semaphore, semaphore-secrets |
| Quellcode | roles/semaphore_secrets |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
semaphore_namespace |
semaphore |
– |
semaphore_bootstrap_secret_name |
<verdeckt> |
– |
semaphore_state_dir |
/etc/semaphore-secrets |
– |
semaphore_admin_username |
admin |
– |
semaphore_admin_email |
admin@homeserver |
– |
semaphore_vault_password |
`` | – |
Ablauf
- sicherstellen dass das semaphore-statusverzeichnis existiert
- prüfen ob die datei mit dem admin-passwort schon existiert
- zufälliges admin-passwort erzeugen (nur beim ersten lauf)
- admin-passwort auf der platte ablegen (nur beim ersten lauf)
- admin-passwort von der platte lesen
- admin-passwort als fakt bereitstellen
- schlüssel für die verschlüsselung der zugangsschlüssel erzeugen (nur beim ersten lauf)
- rechte der datei mit dem verschlüsselungsschlüssel einschränken
- verschlüsselungsschlüssel für die zugangsschlüssel von der platte lesen
- verschlüsselungsschlüssel für die zugangsschlüssel als fakt bereitstellen
- ssh-schlüsselpaar für semaphore erzeugen (nur beim ersten lauf)
- rechte des privaten ssh-schlüssels einschränken
- rechte des öffentlichen ssh-schlüssels einschränken
- privaten ssh-schlüssel von semaphore lesen
- öffentlichen ssh-schlüssel von semaphore lesen
- ssh-schlüssel als fakten bereitstellen (hostvars für nachfolgende rollen)
- sicherstellen dass der namespace semaphore existiert
- bootstrap-secret im cluster anlegen (
kubectl apply -f -über stdin, keine Datei in/tmp) - altes temporäres secret-manifest entfernen
- zusammenfassung des semaphore-bootstraps anzeigen
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo ls -l /etc/semaphore-secrets
kubectl -n semaphore get secret
kubectl -n semaphore describe pod -l app.kubernetes.io/name=semaphore
| Symptom | Ursache | Lösung |
|---|---|---|
Semaphore-Pod CreateContainerConfigError |
Bootstrap-Secret fehlt oder ist unvollständig | Rolle erneut ausrollen (make semaphore), Secret prüfen |
| Admin-Passwort unbekannt | Datei /etc/semaphore-secrets/… auf dem Homeserver (erste Ausführung erzeugt es) |
Datei lesen (Semaphore) |
| Schlüssel würden neu erzeugt | State-Verzeichnis gelöscht | Verzeichnis aus dem Backup wiederherstellen, sonst müssen alle Ziele neu autorisiert werden (semaphore_targets) |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.