config

type Build struct {
	Method string `yaml:"method"` // "remote" | "pull" | "" (auto per service)
	Retain int    `yaml:"retain"` // stopped old-version containers kept per service
}

type Command struct {
	Name        string `yaml:"-"`
	Description string `yaml:"description"`
	Service     string `yaml:"service"` // runs inside this service's container...
	Server      string `yaml:"server"`  // ...or on a host
	Command     string `yaml:"command"`
	Interactive bool   `yaml:"interactive"`
}

type Config struct {
	Name     string              `yaml:"name"`
	Compose  []string            `yaml:"compose"`
	Servers  map[string]*Server  `yaml:"servers"`
	Proxy    Proxy               `yaml:"proxy"`
	Build    Build               `yaml:"build"`
	Registry *Registry           `yaml:"registry"`
	Env      Env                 `yaml:"env"`
	Services map[string]*Service `yaml:"services"`
	Preview  Preview             `yaml:"preview"`
	Hooks    map[HookType]Hook   `yaml:"hooks"`
	Commands map[string]*Command `yaml:"commands"`

	// Dir is the directory containing ferry.yaml; relative paths resolve
	// against it.
	Dir string `yaml:"-"`
}

type Env struct {
	File       string `yaml:"file"`
	Encryption string `yaml:"encryption"` // "none" | "sops-age"
}

type Health struct {
	Path     string `yaml:"path"`
	Interval string `yaml:"interval"`
	Timeout  string `yaml:"timeout"`
}

type Hook []string

type HookType string

type Preview struct {
	Domain   string   `yaml:"domain"`
	Server   string   `yaml:"server"`
	Services []string `yaml:"services"`
	Isolate  []string `yaml:"isolate"`
	EnvFile  string   `yaml:"env_file"`
	TTL      string   `yaml:"ttl"`
}

type Proxy struct {
	Image     string `yaml:"image"`
	Network   string `yaml:"network"`
	HTTPPort  int    `yaml:"http_port"`
	HTTPSPort int    `yaml:"https_port"`
}

type Registry struct {
	Server   string `yaml:"server"`
	Username string `yaml:"username"`
	Password string `yaml:"password"` // name of a variable in the env file, never a literal
}

type Server struct {
	Name string `yaml:"-"`
	Host string `yaml:"host"`
	User string `yaml:"user"`
	Port int    `yaml:"port"`
}

type Service struct {
	Name     string            `yaml:"-"`
	Servers  []string          `yaml:"servers"`
	Domain   string            `yaml:"domain"`
	Domains  []string          `yaml:"domains"`
	Port     int               `yaml:"port"`
	Health   Health            `yaml:"health"`
	Proxy    map[string]string `yaml:"proxy"` // passthrough kamal-proxy deploy flags
	EnvFile  string            `yaml:"env_file"`
	Build    string            `yaml:"build"` // per-service override of build.method
	Job      bool              `yaml:"job"`
	Stateful bool              `yaml:"stateful"` // converge in place: stable container, recreated only on config change
}