status

type Config struct {
	// ConfigFile is the path to the SPECTRE migration config TOML file.
	ConfigFile File `default:"spectre/migration.toml" help:"Path to the SPECTRE migration config TOML file."`
}

type Digest string

type File string

type GitCommit string

type Image string

type MigrationConfig struct {
	// App is the service name the config migrates.
	App string `toml:"app"`
	// Platform names the deploy platform the service runs on, e.g. ski.
	Platform string `toml:"platform"`
	// Environments lists the <env>-<region> targets to check, e.g. staging-us-west-2.
	Environments []string `toml:"environments"`
}

type MirrorState struct {
	// Enabled is true when the target deploys a SPECTRE mirror.
	Enabled bool
	// Image is the mirror's full image reference, including its digest.
	Image Image
	// Digest is the mirror image's "@" digest, or "" when it carries none.
	Digest Digest
	// Commit is the git commit the mirror runs when it differs from its image's,
	// e.g. for code synced over the image, or "" to resolve it from the image.
	Commit GitCommit
}

type Platform interface {
	// Mirror reports the SPECTRE mirror state for one <env>-<region> target. It
	// fails when the platform cannot tell whether the target runs a mirror.
	Mirror(ctx context.Context, target string) (MirrorState, error)
	// ResolveCommit returns the git commit for image, or "" when unknown.
	ResolveCommit(ctx context.Context, image Image) (GitCommit, error)
	// ResolveStatus reads the live candidate quarantine status for one target.
	ResolveStatus(ctx context.Context, target string) (QuarantineReport, error)
}

type PlatformFactory func(app string) (Platform, error)

type QuarantineReport struct {
	// Quarantined is true when any proxy has quarantined the candidate.
	Quarantined bool `json:"quarantined"`
	// Sources is the per-proxy quarantine state.
	Sources []SourceStatus `json:"sources"`
}

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

type SourceStatus struct {
	// Name identifies the proxy, e.g. "ingress" or "egress".
	Name string `json:"name"`
	// Quarantined is true once this proxy has refused candidate traffic.
	Quarantined bool `json:"quarantined"`
	// Reason is the error that triggered quarantine, empty while healthy.
	Reason string `json:"reason"`
	// Since is when quarantine began, as RFC 3339, empty while healthy.
	Since string `json:"since"`
}