instance

Aug 10, 2026

Changes in this version

+ var ErrHostAlreadyExists = errors.New("host already exists")

+ var ErrHostHasBackups = errors.New("host has backups; rename would orphan their blob storage")

type Service

+ func (s *Service) CanRenameHost(ctx context.Context, oldID, newID string) error

+ func (s *Service) RenameHost(ctx context.Context, oldID, newID string, ...) error

Aug 8, 2026

Changes in this version

type Service

+ func (s *Service) HostUptime(ctx context.Context, host string) (time.Duration, bool, error)

Aug 7, 2026

Changes in this version

type ObservedContainer

+ IsInfra bool

Jul 29, 2026

Changes in this version

+ type HostStats struct

+ Containers map[string]podman.ContainerStats

+ FetchedAt time.Time

+ type HostVolumeUsage struct

+ FetchedAt time.Time

+ Sizes map[string]int64

type Service

+ func (s *Service) DropHostStats(host string)

+ func (s *Service) RefreshHostStats(ctx context.Context, host string) error

+ func (s *Service) RefreshHostVolumeUsage(ctx context.Context, host string) error

+ func (s *Service) StatsSnapshot() map[string]HostStats

+ func (s *Service) VolumeUsageSnapshot() map[string]HostVolumeUsage

Jul 26, 2026

Changes in this version

+ func PublicParameters(m render.Meta, params map[string]any, secretVals map[string]bool) map[string]any

type Observed

+ Parameters map[string]any

Jul 26, 2026

Changes in this version

type Service

+ func (s *Service) UpdateInstanceParameters(ctx context.Context, host, tmpl, slug string, newParams map[string]any) error

Jul 25, 2026

Changes in this version

+ type HostInventory struct

+ FetchedAt time.Time

+ HasData bool

+ Observed []Observed

+ Reachable bool

type Service

+ func (s *Service) InventorySnapshot() map[string]HostInventory

Jul 23, 2026

Changes in this version

+ type Freshness struct

+ FetchedAt time.Time

+ HasData bool

+ Reachable bool

+ func (f Freshness) Age() time.Duration

type Service

+ func (s *Service) EnableWarmInventory()

+ func (s *Service) ListAllInstancesWithMeta(ctx context.Context, host string) ([]Observed, Freshness, error)

+ func (s *Service) RefreshHost(ctx context.Context, host string) error

Jul 22, 2026

Changes in this version

type Service

+ func (s *Service) SetInstanceCacheTTL(ttl time.Duration)

Jun 16, 2026

Changes in this version

type ApplyOptions

+ RestoreIntent *extension.RestoreIntent

+ type PITRRestoreRequest struct

+ Host string

+ Slug string

+ Template string

+ Timestamp string

+ Volumes []string

type Service

+ func (s *Service) CheckInstanceExists(ctx context.Context, host, tmpl, slug string) error

+ func (s *Service) PITRRestore(ctx context.Context, req PITRRestoreRequest, step func(step, detail string)) error

Jun 15, 2026

Changes in this version

+ var ErrNewSlugSameAsOld = errors.New("new slug is the same as the old slug")

+ type RenameRequest struct

+ Domains []string

+ KeepOldStandby bool

+ NewSlug string

type Service

+ func (s *Service) CheckRenameable(ctx context.Context, host, tmpl, slug string, req RenameRequest) error

+ func (s *Service) Rename(ctx context.Context, host, tmpl, slug string, req RenameRequest, ...) error

+ func (s *Service) StoredSpec(ctx context.Context, host, tmpl, slug string) (store.Spec, error)

Jun 14, 2026

Changes in this version

type Service

+ func (s *Service) SetSidecarInjector(si SidecarInjector)

+ type SidecarInjector = extension.SidecarInjector

Jun 14, 2026

Changes in this version

type EvacuateRequest

+ Moves []Move

+ type Move struct

+ Slug string

+ Template string

+ ToHost string

Jun 13, 2026

Changes in this version

+ func SetDeployVerifyStableCount(n int)

+ func SetVerifyStableCount(n int)

type MigrateRequest

+ AlsoStop []PairedInstanceRef

+ type PairedInstanceRef struct

+ Slug string

+ Template string

Jun 12, 2026

Changes in this version

+ var ErrBackupBusy = errors.New("backup has a backup or restore in flight")

+ var ErrBackupNotFound = errors.New("backup not found")

+ var ErrBackupNotRestorable = errors.New("backup is not restorable")

+ var ErrBackupsDisabled = errors.New("backups require a blob store (-backup-dir)")

+ var ErrHostDraining = errors.New("host is draining")

+ var ErrHostSecretMissing = errors.New("required host secret missing")

+ var ErrImagePull = errors.New("image pull failed")

+ var ErrInstanceExists = errors.New("instance already exists")

+ var ErrInstanceNotFound = errors.New("instance not found")

+ var ErrInvalidEvacuation = errors.New("invalid evacuation request")

+ var ErrInvalidTemplate = errors.New("invalid template")

+ var ErrPortConflict = errors.New("required host port already in use")

+ var ErrSameHost = errors.New("source and destination host are the same")

+ var ErrStoreDisabled = errors.New("migrate requires the state store")

+ var ErrTemplateExists = errors.New("template already exists")

+ var ErrTemplateInUse = errors.New("template is in use by one or more instances")

+ var ErrUnknownHost = errors.New("unknown host")

+ var ErrUnknownTemplate = errors.New("unknown template")

+ var ErrVolumeIntegrity = errors.New("volume copy failed integrity check")

+ func BackupDeletable(ctx context.Context, js store.JobStore, backupID string) error

+ func BackupInFlight(ctx context.Context, js store.JobStore, backupID string) (bool, error)

+ func RestoreInFlight(ctx context.Context, js store.JobStore, backupID string) (bool, error)

+ func SetDeployVerifyTimeout(d time.Duration)

+ func SetVerifyTimeout(d time.Duration)

+ func ValidateTemplate(t store.Template) error

+ type ApplyOptions struct

+ AllowMissingSecrets bool

+ Replace bool

+ SkipPull bool

+ type ApplyRequest struct

+ Domains []string

+ Parameters map[string]any

+ Secrets map[string]string

+ Slug string

+ Template string

+ type BackupRequest struct

+ BackupID string

+ Host string

+ Slug string

+ Template string

+ type BlobStore = extension.BlobStore

+ type BlobWriter = extension.BlobWriter

+ type DeleteOptions struct

+ PruneSecrets bool

+ PruneVolumes bool

+ type EvacuateRequest struct

+ Concurrency int

+ FromHost string

+ Map map[string]string

+ type EvacuationPlan struct

+ FromHost string

+ Moves []PlannedMove

+ type Manifest map[string]fileInfo

+ type MigrateRequest struct

+ FromHost string

+ Parameters map[string]any

+ Slug string

+ Template string

+ ToHost string

+ type Observed struct

+ Containers []ObservedContainer

+ EnvSummary map[string]string

+ Pod ObservedPod

+ Ready bool

+ Slug string

+ Template string

+ Volumes []ObservedVolume

+ Warnings []string

+ func Normalize(p podman.Pod, template, slug string, vols []podman.Volume, ...) Observed

+ type ObservedContainer struct

+ Health string

+ Image string

+ ImageTag string

+ Name string

+ Ports []ObservedPortMapping

+ RestartCount int

+ StartedAt time.Time

+ Status string

+ type ObservedPod struct

+ Created time.Time

+ ID string

+ Status string

+ type ObservedPortMapping struct

+ ContainerPort int

+ HostIP string

+ HostPort int

+ Protocol string

+ type ObservedVolume struct

+ Name string

+ SizeBytes int64

+ type PlanIssue struct

+ Code string

+ Message string

+ type PlannedMove struct

+ Issues []PlanIssue

+ OK bool

+ Provisions []string

+ Slug string

+ Template string

+ ToHost string

+ type RestoreRequest struct

+ BackupID string

+ type Service struct

+ func NewService(client podman.Client, hosts []config.Host) *Service

+ func (s *Service) Apply(ctx context.Context, host string, req ApplyRequest, opts ApplyOptions) error

+ func (s *Service) ApplyAndObserve(ctx context.Context, host string, req ApplyRequest, opts ApplyOptions) (Observed, error)

+ func (s *Service) Backup(ctx context.Context, req BackupRequest, step func(step, detail string)) error

+ func (s *Service) CheckBackupable(ctx context.Context, host, tmpl, slug string) error

+ func (s *Service) CheckMigratable(ctx context.Context, req MigrateRequest) error

+ func (s *Service) CheckRestorable(ctx context.Context, backupID string) (store.Backup, error)

+ func (s *Service) CloneTemplate(ctx context.Context, srcID, newID string) (store.Template, error)

+ func (s *Service) CopyVolume(ctx context.Context, fromHost, toHost, name string) error

+ func (s *Service) CreateTemplate(ctx context.Context, t store.Template) error

+ func (s *Service) Delete(ctx context.Context, host, tmpl, slug string, opts DeleteOptions) error

+ func (s *Service) DeleteBackup(ctx context.Context, id string) error

+ func (s *Service) DeleteHostSecret(ctx context.Context, host, name string) error

+ func (s *Service) DeleteTemplate(ctx context.Context, id string, force bool) error

+ func (s *Service) DeleteVolume(ctx context.Context, host, name string, force bool) error

+ func (s *Service) Get(ctx context.Context, host, tmpl, slug string) (Observed, error)

+ func (s *Service) GetBackup(ctx context.Context, id string) (store.Backup, error)

+ func (s *Service) GetTemplate(ctx context.Context, id string) (store.Template, error)

+ func (s *Service) HostCounts(ctx context.Context, host string) (instances, containers int, err error)

+ func (s *Service) HostLoad(ctx context.Context, host string) (podman.HostInfo, error)

+ func (s *Service) HostSecrets(ctx context.Context, host string) ([]podman.Secret, error)

+ func (s *Service) Hosts() []config.Host

+ func (s *Service) InstanceCount(ctx context.Context, host string) (int, error)

+ func (s *Service) InstanceSecretState(ctx context.Context, host, tmpl, slug string) (map[string]bool, error)

+ func (s *Service) InstanceVolumes(ctx context.Context, host, tmpl, slug string) ([]podman.Volume, error)

+ func (s *Service) List(ctx context.Context, host, tmpl string) ([]Observed, error)

+ func (s *Service) ListAllInstances(ctx context.Context, host string) ([]Observed, error)

+ func (s *Service) ListBackups(ctx context.Context, host, tmpl, slug string, limit int) ([]store.Backup, error)

+ func (s *Service) Logs(ctx context.Context, host, tmpl, slug, container string, ...) (<-chan podman.LogLine, error)

+ func (s *Service) Migrate(ctx context.Context, req MigrateRequest, step func(step, detail string)) error

+ func (s *Service) Ping(ctx context.Context, host string) error

+ func (s *Service) PlanEvacuation(ctx context.Context, req EvacuateRequest) (EvacuationPlan, error)

+ func (s *Service) PortsInUse(ctx context.Context, host string) ([]podman.PortMapping, error)

+ func (s *Service) PutHostSecret(ctx context.Context, host, name string, value []byte, persist bool) error

+ func (s *Service) ReconcileBackup(ctx context.Context, req BackupRequest, step func(step, detail string)) (resolved, ok bool, message string, err error)

+ func (s *Service) ReconcileMigrate(ctx context.Context, req MigrateRequest, step func(step, detail string)) (resolved, succeeded bool, message string, err error)

+ func (s *Service) ReconcileSpecsOnHost(ctx context.Context, hostID string)

+ func (s *Service) ResolveEvacuation(ctx context.Context, req EvacuateRequest) ([]MigrateRequest, error)

+ func (s *Service) Restart(ctx context.Context, host, tmpl, slug string) error

+ func (s *Service) Restore(ctx context.Context, req RestoreRequest, step func(step, detail string)) error

+ func (s *Service) RotateInstanceSecrets(ctx context.Context, host, tmpl, slug string, newSecrets map[string]string) error

+ func (s *Service) SetBlobStore(bs BlobStore)

+ func (s *Service) SetHosts(hosts []config.Host)

+ func (s *Service) SetIngress(c ingress.Controller, network string)

+ func (s *Service) SetStore(st Store)

+ func (s *Service) SetVerifyVolumes(v bool)

+ func (s *Service) Start(ctx context.Context, host, tmpl, slug string) (Observed, error)

+ func (s *Service) Stop(ctx context.Context, host, tmpl, slug string) error

+ func (s *Service) Template(ctx context.Context, id string) (store.Template, error)

+ func (s *Service) Templates(ctx context.Context) ([]store.Template, error)

+ func (s *Service) UpdateTemplate(ctx context.Context, t store.Template) error

+ func (s *Service) Upgrade(ctx context.Context, host string, req ApplyRequest, image string) error

+ func (s *Service) UpgradeImage(ctx context.Context, host, tmpl, slug, image string) error

+ func (s *Service) Version(ctx context.Context, host string) (string, error)

+ type Store interface