docker

package
v1.0.0-rc1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 16, 2017 License: MPL-2.0 Imports: 29 Imported by: 0

Documentation

Index

Constants

View Source
const (
	BuilderId       = "packer.docker"
	BuilderIdImport = "packer.post-processor.docker-import"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type AwsAccessConfig added in v0.11.0

type AwsAccessConfig struct {
	AccessKey string `mapstructure:"aws_access_key"`
	SecretKey string `mapstructure:"aws_secret_key"`
	Token     string `mapstructure:"aws_token"`
}

func (*AwsAccessConfig) EcrGetLogin added in v0.11.0

func (c *AwsAccessConfig) EcrGetLogin(ecrUrl string) (string, string, error)

Get a login token for Amazon AWS ECR. Returns username and password or an error.

type Builder

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

func (*Builder) Cancel

func (b *Builder) Cancel()

func (*Builder) Prepare

func (b *Builder) Prepare(raws ...interface{}) ([]string, error)

func (*Builder) Run

func (b *Builder) Run(ui packer.Ui, hook packer.Hook, cache packer.Cache) (packer.Artifact, error)

type Communicator

type Communicator struct {
	ContainerId  string
	HostDir      string
	ContainerDir string
	Version      *version.Version
	Config       *Config
	// contains filtered or unexported fields
}

func (*Communicator) Download

func (c *Communicator) Download(src string, dst io.Writer) error

Download pulls a file out of a container using `docker cp`. We have a source path and want to write to an io.Writer, not a file. We use - to make docker cp to write to stdout, and then copy the stream to our destination io.Writer.

func (*Communicator) DownloadDir added in v0.9.0

func (c *Communicator) DownloadDir(src string, dst string, exclude []string) error

func (*Communicator) Start

func (c *Communicator) Start(remote *packer.RemoteCmd) error

func (*Communicator) Upload

func (c *Communicator) Upload(dst string, src io.Reader, fi *os.FileInfo) error

func (*Communicator) UploadDir

func (c *Communicator) UploadDir(dst string, src string, exclude []string) error

type Config

type Config struct {
	common.PackerConfig `mapstructure:",squash"`
	Comm                communicator.Config `mapstructure:",squash"`

	Commit     bool
	Discard    bool
	ExportPath string `mapstructure:"export_path"`
	Image      string
	Pty        bool
	Pull       bool
	RunCommand []string `mapstructure:"run_command"`
	Volumes    map[string]string
	Privileged bool `mapstructure:"privileged"`
	Author     string
	Changes    []string
	Message    string

	// This is used to login to dockerhub to pull a private base container. For
	// pushing to dockerhub, see the docker post-processors
	Login           bool
	LoginEmail      string `mapstructure:"login_email"`
	LoginPassword   string `mapstructure:"login_password"`
	LoginServer     string `mapstructure:"login_server"`
	LoginUsername   string `mapstructure:"login_username"`
	EcrLogin        bool   `mapstructure:"ecr_login"`
	AwsAccessConfig `mapstructure:",squash"`
	// contains filtered or unexported fields
}

func NewConfig

func NewConfig(raws ...interface{}) (*Config, []string, error)

type ContainerConfig

type ContainerConfig struct {
	Image      string
	RunCommand []string
	Volumes    map[string]string
	Privileged bool
}

ContainerConfig is the configuration used to start a container.

type DockerDriver

type DockerDriver struct {
	Ui  packer.Ui
	Ctx *interpolate.Context
	// contains filtered or unexported fields
}

func (*DockerDriver) Commit added in v0.7.0

func (d *DockerDriver) Commit(id string, author string, changes []string, message string) (string, error)

func (*DockerDriver) DeleteImage added in v0.5.2

func (d *DockerDriver) DeleteImage(id string) error

func (*DockerDriver) Export

func (d *DockerDriver) Export(id string, dst io.Writer) error

func (*DockerDriver) IPAddress added in v0.8.0

func (d *DockerDriver) IPAddress(id string) (string, error)

func (*DockerDriver) Import added in v0.5.2

func (d *DockerDriver) Import(path string, repo string) (string, error)

func (*DockerDriver) Login added in v0.7.0

func (d *DockerDriver) Login(repo, email, user, pass string) error

func (*DockerDriver) Logout added in v0.7.0

func (d *DockerDriver) Logout(repo string) error

func (*DockerDriver) Pull

func (d *DockerDriver) Pull(image string) error

func (*DockerDriver) Push added in v0.5.2

func (d *DockerDriver) Push(name string) error

func (*DockerDriver) SaveImage added in v0.7.0

func (d *DockerDriver) SaveImage(id string, dst io.Writer) error

func (*DockerDriver) StartContainer

func (d *DockerDriver) StartContainer(config *ContainerConfig) (string, error)

func (*DockerDriver) StopContainer

func (d *DockerDriver) StopContainer(id string) error

func (*DockerDriver) TagImage added in v0.7.0

func (d *DockerDriver) TagImage(id string, repo string, force bool) error

func (*DockerDriver) Verify

func (d *DockerDriver) Verify() error

func (*DockerDriver) Version added in v0.8.0

func (d *DockerDriver) Version() (*version.Version, error)

type Driver

type Driver interface {
	// Commit the container to a tag
	Commit(id string, author string, changes []string, message string) (string, error)

	// Delete an image that is imported into Docker
	DeleteImage(id string) error

	// Export exports the container with the given ID to the given writer.
	Export(id string, dst io.Writer) error

	// Import imports a container from a tar file
	Import(path, repo string) (string, error)

	// IPAddress returns the address of the container that can be used
	// for external access.
	IPAddress(id string) (string, error)

	// Login. This will lock the driver from performing another Login
	// until Logout is called. Therefore, any users MUST call Logout.
	Login(repo, email, username, password string) error

	// Logout. This can only be called if Login succeeded.
	Logout(repo string) error

	// Pull should pull down the given image.
	Pull(image string) error

	// Push pushes an image to a Docker index/registry.
	Push(name string) error

	// Save an image with the given ID to the given writer.
	SaveImage(id string, dst io.Writer) error

	// StartContainer starts a container and returns the ID for that container,
	// along with a potential error.
	StartContainer(*ContainerConfig) (string, error)

	// StopContainer forcibly stops a container.
	StopContainer(id string) error

	// TagImage tags the image with the given ID
	TagImage(id string, repo string, force bool) error

	// Verify verifies that the driver can run
	Verify() error

	// Version reads the Docker version
	Version() (*version.Version, error)
}

Driver is the interface that has to be implemented to communicate with Docker. The Driver interface also allows the steps to be tested since a mock driver can be shimmed in.

type ExportArtifact

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

ExportArtifact is an Artifact implementation for when a container is exported from docker into a single flat file.

func (*ExportArtifact) BuilderId

func (*ExportArtifact) BuilderId() string

func (*ExportArtifact) Destroy

func (a *ExportArtifact) Destroy() error

func (*ExportArtifact) Files

func (a *ExportArtifact) Files() []string

func (*ExportArtifact) Id

func (*ExportArtifact) Id() string

func (*ExportArtifact) State added in v0.7.2

func (a *ExportArtifact) State(name string) interface{}

func (*ExportArtifact) String

func (a *ExportArtifact) String() string

type ImportArtifact added in v0.5.2

type ImportArtifact struct {
	BuilderIdValue string
	Driver         Driver
	IdValue        string
}

ImportArtifact is an Artifact implementation for when a container is exported from docker into a single flat file.

func (*ImportArtifact) BuilderId added in v0.5.2

func (a *ImportArtifact) BuilderId() string

func (*ImportArtifact) Destroy added in v0.5.2

func (a *ImportArtifact) Destroy() error

func (*ImportArtifact) Files added in v0.5.2

func (*ImportArtifact) Files() []string

func (*ImportArtifact) Id added in v0.5.2

func (a *ImportArtifact) Id() string

func (*ImportArtifact) State added in v0.7.2

func (*ImportArtifact) State(name string) interface{}

func (*ImportArtifact) String added in v0.5.2

func (a *ImportArtifact) String() string

type MockDriver

type MockDriver struct {
	CommitCalled      bool
	CommitContainerId string
	CommitImageId     string
	CommitErr         error

	DeleteImageCalled bool
	DeleteImageId     string
	DeleteImageErr    error

	ImportCalled bool
	ImportPath   string
	ImportRepo   string
	ImportId     string
	ImportErr    error

	IPAddressCalled bool
	IPAddressID     string
	IPAddressResult string
	IPAddressErr    error

	LoginCalled   bool
	LoginEmail    string
	LoginUsername string
	LoginPassword string
	LoginRepo     string
	LoginErr      error

	LogoutCalled bool
	LogoutRepo   string
	LogoutErr    error

	PushCalled bool
	PushName   string
	PushErr    error

	SaveImageCalled bool
	SaveImageId     string
	SaveImageReader io.Reader
	SaveImageError  error

	TagImageCalled  bool
	TagImageImageId string
	TagImageRepo    string
	TagImageForce   bool
	TagImageErr     error

	ExportReader io.Reader
	ExportError  error
	PullError    error
	StartID      string
	StartError   error
	StopError    error
	VerifyError  error

	ExportCalled bool
	ExportID     string
	PullCalled   bool
	PullImage    string
	StartCalled  bool
	StartConfig  *ContainerConfig
	StopCalled   bool
	StopID       string
	VerifyCalled bool

	VersionCalled  bool
	VersionVersion string
}

MockDriver is a driver implementation that can be used for tests.

func (*MockDriver) Commit added in v0.7.0

func (d *MockDriver) Commit(id string, author string, changes []string, message string) (string, error)

func (*MockDriver) DeleteImage added in v0.5.2

func (d *MockDriver) DeleteImage(id string) error

func (*MockDriver) Export

func (d *MockDriver) Export(id string, dst io.Writer) error

func (*MockDriver) IPAddress added in v0.8.0

func (d *MockDriver) IPAddress(id string) (string, error)

func (*MockDriver) Import added in v0.5.2

func (d *MockDriver) Import(path, repo string) (string, error)

func (*MockDriver) Login added in v0.7.0

func (d *MockDriver) Login(r, e, u, p string) error

func (*MockDriver) Logout added in v0.7.0

func (d *MockDriver) Logout(r string) error

func (*MockDriver) Pull

func (d *MockDriver) Pull(image string) error

func (*MockDriver) Push added in v0.5.2

func (d *MockDriver) Push(name string) error

func (*MockDriver) SaveImage added in v0.7.0

func (d *MockDriver) SaveImage(id string, dst io.Writer) error

func (*MockDriver) StartContainer

func (d *MockDriver) StartContainer(config *ContainerConfig) (string, error)

func (*MockDriver) StopContainer

func (d *MockDriver) StopContainer(id string) error

func (*MockDriver) TagImage added in v0.7.0

func (d *MockDriver) TagImage(id string, repo string, force bool) error

func (*MockDriver) Verify

func (d *MockDriver) Verify() error

func (*MockDriver) Version added in v0.8.0

func (d *MockDriver) Version() (*version.Version, error)

type StepCommit added in v0.7.0

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

StepCommit commits the container to a image.

func (*StepCommit) Cleanup added in v0.7.0

func (s *StepCommit) Cleanup(state multistep.StateBag)

func (*StepCommit) Run added in v0.7.0

type StepConnectDocker added in v0.8.0

type StepConnectDocker struct{}

func (*StepConnectDocker) Cleanup added in v0.8.0

func (s *StepConnectDocker) Cleanup(state multistep.StateBag)

func (*StepConnectDocker) Run added in v0.8.0

type StepExport

type StepExport struct{}

StepExport exports the container to a flat tar file.

func (*StepExport) Cleanup

func (s *StepExport) Cleanup(state multistep.StateBag)

func (*StepExport) Run

type StepPull

type StepPull struct{}

func (*StepPull) Cleanup

func (s *StepPull) Cleanup(state multistep.StateBag)

func (*StepPull) Run

type StepRun

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

func (*StepRun) Cleanup

func (s *StepRun) Cleanup(state multistep.StateBag)

func (*StepRun) Run

type StepTempDir

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

StepTempDir creates a temporary directory that we use in order to share data with the docker container over the communicator.

func (*StepTempDir) Cleanup

func (s *StepTempDir) Cleanup(state multistep.StateBag)

func (*StepTempDir) Run

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL