imgsrc

Documentation

Index

• func EagerlyEnsureRemoteBuilder(ctx context.Context, apiClient *api.Client, orgSlug string)
• func NewDeploymentTag(appName string, label string) string
• func NewLocalDockerClient() (*dockerclient.Client, error)
• type DeploymentImage
• type DockerDaemonType
  • func NewDockerDaemonType(allowLocal, allowRemote, prefersLocal, useNixpacks bool) DockerDaemonType
  • func (t DockerDaemonType) AllowLocal() bool
  • func (t DockerDaemonType) AllowNone() bool
  • func (t DockerDaemonType) AllowRemote() bool
  • func (t DockerDaemonType) IsAvailable() bool
  • func (t DockerDaemonType) IsNone() bool
  • func (t DockerDaemonType) PrefersLocal() bool
  • func (t DockerDaemonType) UseNixpacks() bool
• type ImageOptions
• type RefOptions
• type RegistryUnauthorizedError
  • func (err *RegistryUnauthorizedError) Error() string
• type Resolver
  • func NewResolver(daemonType DockerDaemonType, apiClient *api.Client, appName string, ...) *Resolver
  • func (r *Resolver) BuildImage(ctx context.Context, streams *iostreams.IOStreams, opts ImageOptions) (img *DeploymentImage, err error)
  • func (r *Resolver) ResolveReference(ctx context.Context, streams *iostreams.IOStreams, opts RefOptions) (img *DeploymentImage, err error)
  • func (r *Resolver) StartHeartbeat(ctx context.Context) chan<- interface{}
  • func (r *Resolver) StopHeartbeat(heartbeat chan<- interface{})

Functions

func EagerlyEnsureRemoteBuilder

func EagerlyEnsureRemoteBuilder(ctx context.Context, apiClient *api.Client, orgSlug string)

func NewDeploymentTag

func NewDeploymentTag(appName string, label string) string

NewDeploymentTag generates a Docker image reference including the current registry, the app name, and a timestamp: registry.fly.io/appname:deployment-$timestamp

func NewLocalDockerClient

func NewLocalDockerClient() (*dockerclient.Client, error)

Types

type DeploymentImage

type DeploymentImage struct {
	ID   string
	Tag  string
	Size int64
}

type DockerDaemonType

type DockerDaemonType int

const (
	DockerDaemonTypeLocal DockerDaemonType = 1 << iota
	DockerDaemonTypeRemote
	DockerDaemonTypeNone
	DockerDaemonTypePrefersLocal
	DockerDaemonTypeNixpacks
)

func NewDockerDaemonType

func NewDockerDaemonType(allowLocal, allowRemote, prefersLocal, useNixpacks bool) DockerDaemonType

func (DockerDaemonType) AllowLocal

func (t DockerDaemonType) AllowLocal() bool

func (DockerDaemonType) AllowNone

func (t DockerDaemonType) AllowNone() bool

func (DockerDaemonType) AllowRemote

func (t DockerDaemonType) AllowRemote() bool

func (DockerDaemonType) IsAvailable

func (t DockerDaemonType) IsAvailable() bool

func (DockerDaemonType) IsNone

func (t DockerDaemonType) IsNone() bool

func (DockerDaemonType) PrefersLocal

func (t DockerDaemonType) PrefersLocal() bool

func (DockerDaemonType) UseNixpacks

func (t DockerDaemonType) UseNixpacks() bool

type ImageOptions

type ImageOptions struct {
	AppName         string
	WorkingDir      string
	DockerfilePath  string
	ImageRef        string
	BuildArgs       map[string]string
	ExtraBuildArgs  map[string]string
	BuildSecrets    map[string]string
	ImageLabel      string
	Publish         bool
	Tag             string
	Target          string
	NoCache         bool
	BuiltIn         string
	BuiltInSettings map[string]interface{}
	Builder         string
	Buildpacks      []string
}

type RefOptions

type RefOptions struct {
	AppName    string
	WorkingDir string
	ImageRef   string
	ImageLabel string
	Publish    bool
	Tag        string
}

type RegistryUnauthorizedError

type RegistryUnauthorizedError struct {
	Tag string
}

func (*RegistryUnauthorizedError) Error

func (err *RegistryUnauthorizedError) Error() string

type Resolver

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

func NewResolver

func NewResolver(daemonType DockerDaemonType, apiClient *api.Client, appName string, iostreams *iostreams.IOStreams) *Resolver

func (*Resolver) BuildImage

func (r *Resolver) BuildImage(ctx context.Context, streams *iostreams.IOStreams, opts ImageOptions) (img *DeploymentImage, err error)

BuildImage converts source code to an image using a Dockerfile, buildpacks, or builtins.

func (*Resolver) ResolveReference

func (r *Resolver) ResolveReference(ctx context.Context, streams *iostreams.IOStreams, opts RefOptions) (img *DeploymentImage, err error)

ResolveReference returns an Image give an reference using either the local docker daemon or remote registry

func (*Resolver) StartHeartbeat

func (r *Resolver) StartHeartbeat(ctx context.Context) chan<- interface{}

For remote builders send a periodic heartbeat during build to ensure machine stays alive This is a noop for local builders

func (*Resolver) StopHeartbeat

func (r *Resolver) StopHeartbeat(heartbeat chan<- interface{})