Konfiguration von Watchtower

Watchtower wird über Umgebungsvariablen konfiguriert.

Umgebungsvariablen

WATCHTOWER_POLL_INTERVAL

Abstand zwischen zwei Prüfungen auf neue Images, in Sekunden. Standardwert ist 86400, also einmal am Tag. Der Abstand zählt ab dem Start des Containers.

Zwischen zwei Prüfungen bleibt ein Container auf seiner Version, auch wenn im Registry längst eine neuere liegt.

Beispiel

WATCHTOWER_POLL_INTERVAL=28800

HELIOS

HELIOS setzt den Wert immer, standardmäßig 86400. Zur Wahl stellt es ihn erst, wenn mindestens ein Dienst auf Entwicklung steht, unter Konfiguration → Grundeinstellungen → Software-Stand. Dort stehen täglich (86400), alle 8 Stunden (28800) und stündlich (3600).

WATCHTOWER_SCOPE

Beschränkt Watchtower auf die Container, die das Label com.centurylinklabs.watchtower.scope mit genau diesem Wert tragen. Welche Dienste von SOLECTRUS das Label bekommen, steht in der Übersicht. Der Sonderwert none kehrt die Auswahl um: Watchtower übergeht dann alle Container, die ein Scope-Label tragen.

Ohne die Variable nimmt sich Watchtower jeden Container auf dem Host vor, auch die, die nichts mit SOLECTRUS zu tun haben.

Beispiel

WATCHTOWER_SCOPE=solectrus

HELIOS

HELIOS gibt solectrus vor, einzustellen gibt es nichts.

WATCHTOWER_CLEANUP

Entfernt das alte Image, sobald der Container auf die neue Version umgestellt ist. Erlaubt sind true und false. Standardwert ist false.

Ohne die Einstellung bleiben die abgelösten Images liegen und belegen weiter Platz auf der Platte.

Beispiel

WATCHTOWER_CLEANUP=true

HELIOS

HELIOS setzt true, einzustellen gibt es nichts.

TZ

Zeitzone gemäß Liste. Standardwert ist UTC.

Sie betrifft die Zeitstempel im Protokoll von Watchtower. Auf den Abstand zwischen zwei Prüfungen wirkt sie sich nicht aus, den bestimmt allein WATCHTOWER_POLL_INTERVAL.

Beispiel

TZ=Europe/Berlin

HELIOS

HELIOS fragt die Zeitzone unter Konfiguration → Grundeinstellungen → PV-Anlage ab, vorbelegt mit Europe/Berlin.

Weitere Variablen

Watchtower kennt noch etliche Variablen mehr, etwa für Benachrichtigungen bei Updates, private Registries oder eine HTTP-API. HELIOS setzt keine davon, und für den Betrieb von SOLECTRUS braucht es sie nicht.

Wer sie trotzdem nutzen will, findet sie in der Dokumentation des Watchtower-Projekts unter Configuration → Arguments. Zu beachten ist dabei: HELIOS erzeugt die compose.yaml bei jeder Änderung neu und verwirft dabei alles, was es nicht selbst geschrieben hat.