playbook

type CopySpec struct {
	Src  string `yaml:"src"`
	Dest string `yaml:"dest"`
	// Mode 文件权限，如 "0644"，为空则保持源文件权限
	Mode string `yaml:"mode,omitempty"`
}

type Duration struct {
	time.Duration
}

type Engine struct {
	// contains filtered or unexported fields
}

type EnsureSpec struct {
	// Check 检查命令，退出码 0 表示已满足期望状态
	Check string `yaml:"check"`
	// Action 当 Check 未通过时执行的修复命令
	Action string `yaml:"action"`
}

type HostReport struct {
	NodeID   string
	Host     string
	Steps    []StepResult
	Status   HostStatus
	Duration time.Duration
}

type HostStatus string

type OnError string

type Playbook struct {
	Name        string            `yaml:"name"`
	Description string            `yaml:"description,omitempty"`
	Targets     Targets           `yaml:"targets"`
	Settings    Settings          `yaml:"settings,omitempty"`
	Vars        map[string]string `yaml:"vars,omitempty"`
	Steps       []Step            `yaml:"steps"`
}

type Report struct {
	PlaybookName string
	StartTime    time.Time
	EndTime      time.Time
	Hosts        []HostReport
}

type Settings struct {
	// Concurrency 控制最大并发主机数，0 表示使用默认值 1
	Concurrency uint     `yaml:"concurrency,omitempty"`
	Sudo        bool     `yaml:"sudo,omitempty"`
	OnError     OnError  `yaml:"on_error,omitempty"`
	Timeout     Duration `yaml:"timeout,omitempty"`
}

type Step struct {
	Name     string      `yaml:"name"`
	Shell    string      `yaml:"shell,omitempty"`
	Script   string      `yaml:"script,omitempty"`
	Copy     *CopySpec   `yaml:"copy,omitempty"`
	Ensure   *EnsureSpec `yaml:"ensure,omitempty"`
	Template *CopySpec   `yaml:"template,omitempty"`

	// Sudo 步骤级别的提权覆盖；nil 表示继承全局 Settings.Sudo
	Sudo *bool `yaml:"sudo,omitempty"`

	// Retries 失败重试次数，默认 0（不重试）
	Retries int `yaml:"retries,omitempty"`
	// RetryDelay 重试间隔，默认 1s
	RetryDelay Duration `yaml:"retry_delay,omitempty"`
	// IgnoreError 即使步骤失败也继续，优先级高于 Settings.OnError
	IgnoreError bool `yaml:"ignore_error,omitempty"`
}

type StepResult struct {
	StepName string
	Status   StepStatus
	Output   string
	Err      error
	Duration time.Duration
}

type StepStatus string

type Targets struct {
	Tags  []string `yaml:"tags,omitempty"`
	Nodes []string `yaml:"nodes,omitempty"`
	Hosts []string `yaml:"hosts,omitempty"`
}