deploy

type AppStore interface {
	SaveApp(ctx context.Context, a store.App) error
	GetAppByName(ctx context.Context, name string) (store.App, error)
	UpdateServiceApp(ctx context.Context, serviceName, appID string) error
}

type BuildMetricsRecorder interface {
	RecordBuildDuration(ctx context.Context, serviceName string, d time.Duration, at time.Time) error
}

type ImageBuilder interface {
	Build(ctx context.Context, req build.Request, progress func(build.ProgressEvent)) (*build.Result, error)

	// BuildRailpack builds a service whose build.Type is
	// spec.BuildRailpack: Railpack's own provider detection replaces a
	// user-authored Dockerfile, scoped to node and golang only (see
	// deployRailpack). A separate method, not a build.Request field,
	// because internal/build's own solve path is genuinely different
	// (Definition-based, not dockerfile.v0-frontend-based; see
	// internal/build/railpack.go's package doc comment).
	BuildRailpack(ctx context.Context, req build.RailpackRequest, progress func(build.ProgressEvent)) (*build.Result, error)
}

type MultiRequest struct {
	// AppName identifies the store.App every fanned-out service is
	// linked to (created if it doesn't exist yet, reused if it does: see
	// DeploySpec's own doc comment). Each service's own DesiredService
	// name is "<AppName>-<serviceKey>", the flat naming convention
	// internal/api/apps_group.go's own doc comment establishes.
	AppName string
	// Services is app.yaml's services: map, keyed by service name (e.g.
	// "web", "worker").
	Services map[string]spec.Service
	// SourceDir is the local checkout root, shared by every service's
	// build: one git checkout produces every service's image.
	SourceDir string
	CommitSHA string
	// ImageRepoBase is the image name without a tag or per-service
	// suffix, e.g. "levelrail/myapp"; each service tags as
	// "<ImageRepoBase>-<serviceKey>:<CommitSHA>".
	ImageRepoBase string
}

type Option func(*Pipeline)

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

type Request struct {
	// ServiceName identifies the service, matching the name the
	// application controller (1.3) reconciles under.
	ServiceName string
	// Service is the app.yaml service block: build config, port, env,
	// resources, health.
	Service spec.Service
	// SourceDir is the local checkout root, the build context.
	SourceDir string
	// CommitSHA tags the built image, and is what a future rollback
	// command points desired.Image back at.
	CommitSHA string
	// ImageRepo is the image name without a tag, e.g. "levelrail/thesvg".
	// Naming policy (namespacing, registry prefix) is the caller's
	// decision, not this package's.
	ImageRepo string
}

type SecretChecker interface {
	Exists(ctx context.Context, serviceName, envKey string) (bool, error)
}

type ServiceOutcome struct {
	ServiceKey  string
	ServiceName string
	Image       string
	Err         error
}

type ServiceStore interface {
	SaveDesiredService(ctx context.Context, svc store.DesiredService) error
	// GetRegistryCredentialByName resolves build.type: image's optional
	// registryCredential field (a name, spec.Build.RegistryCredential's
	// own doc comment on why not an ID) at deploy time, in deployImage.
	GetRegistryCredentialByName(ctx context.Context, name string) (store.RegistryCredential, error)
	// GetDesiredDatabase resolves a { from: "<database>.<field>" } env
	// var's database at deploy time (validateEnv), so an app referencing
	// an unknown database fails the deploy itself rather than only
	// surfacing later as a reconcile failure.
	GetDesiredDatabase(ctx context.Context, name string) (*store.DesiredDatabase, error)
}

type StaticSiteStore interface {
	SaveStaticSite(ctx context.Context, site store.StaticSite) error
}