release / release (push) Successful in 7m6s
The new Cairn OBS: a self-hosted monitor for networks, hosts and services. Licensed AGPLv3.
81 lines
2.4 KiB
Go
81 lines
2.4 KiB
Go
// Package maint is maintenance windows: daily times when a host is
|
|
// expected to go away (the nightly auto-reboot) and nobody should be woken.
|
|
package maint
|
|
|
|
import (
|
|
"fmt"
|
|
"time"
|
|
_ "time/tzdata" // obs-beacond and the agent run without the system's zone files
|
|
)
|
|
|
|
// Window is one daily window, in its own timezone (so it follows daylight
|
|
// saving the way the host's own timer does).
|
|
type Window struct {
|
|
Name string `yaml:"name" json:"name"`
|
|
Hosts []string `yaml:"hosts" json:"hosts,omitempty"` // obs-beacond: whose alerts are held
|
|
Daily string `yaml:"daily" json:"daily"` // HH:MM
|
|
Timezone string `yaml:"timezone" json:"timezone"` // e.g. Europe/Berlin; default UTC
|
|
Duration time.Duration `yaml:"duration" json:"duration_s"` // how long it stays open
|
|
|
|
loc *time.Location
|
|
h, m int
|
|
}
|
|
|
|
// Check parses the window and refuses one that can't work.
|
|
func (w *Window) Check() error {
|
|
if w.Timezone == "" {
|
|
w.Timezone = "UTC"
|
|
}
|
|
loc, err := time.LoadLocation(w.Timezone)
|
|
if err != nil {
|
|
return fmt.Errorf("maintenance window %q: %w", w.Name, err)
|
|
}
|
|
w.loc = loc
|
|
if _, err := fmt.Sscanf(w.Daily, "%d:%d", &w.h, &w.m); err != nil || w.h < 0 || w.h > 23 || w.m < 0 || w.m > 59 || len(w.Daily) != 5 {
|
|
return fmt.Errorf("maintenance window %q: daily must be HH:MM", w.Name)
|
|
}
|
|
if w.Duration <= 0 || w.Duration > 12*time.Hour {
|
|
return fmt.Errorf("maintenance window %q: duration must be between 1s and 12h", w.Name)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// start is the window's start on the day of t (in its timezone).
|
|
func (w *Window) start(t time.Time) time.Time {
|
|
t = t.In(w.loc)
|
|
return time.Date(t.Year(), t.Month(), t.Day(), w.h, w.m, 0, 0, w.loc)
|
|
}
|
|
|
|
// Active says whether now falls in the window (including one that began
|
|
// yesterday and runs past midnight).
|
|
func (w *Window) Active(now time.Time) bool {
|
|
for _, s := range []time.Time{w.start(now), w.start(now.AddDate(0, 0, -1))} {
|
|
if !now.Before(s) && now.Before(s.Add(w.Duration)) {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
// Next is when the window next opens (now, if it is open).
|
|
func (w *Window) Next(now time.Time) time.Time {
|
|
if w.Active(now) {
|
|
return now
|
|
}
|
|
s := w.start(now)
|
|
if !s.After(now) {
|
|
s = w.start(now.AddDate(0, 0, 1))
|
|
}
|
|
return s
|
|
}
|
|
|
|
// AnyActive says whether any of the windows is open.
|
|
func AnyActive(ws []Window, now time.Time) bool {
|
|
for i := range ws {
|
|
if ws[i].Active(now) {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|