9f82b75e57
* removed packer.Cache and references since packer.Cache is never used except in the download step. The download step now uses the new func packer.CachePath(targetPath) for this, the behavior is the same. * removed download code from packer that was reimplemented into the go-getter library: progress bar, http download restart, checksuming from file, skip already downloaded files, symlinking, make a download cancellable by context. * on windows if packer is running without symlinking rights and we are getting a local file, the file will be copied instead to avoid errors. * added unit tests for step_download that are now CI tested on windows, mac & linux. * files are now downloaded under cache dir `sha1(filename + "?checksum=" + checksum) + file_extension` * since the output dir is based on the source url and the checksum, when the checksum fails, the file is auto deleted. * a download file is protected and locked by a file lock, * updated docs * updated go modules and vendors
37 lines
1.6 KiB
Go
37 lines
1.6 KiB
Go
package packer
|
|
|
|
// Implementers of Builder are responsible for actually building images
|
|
// on some platform given some configuration.
|
|
//
|
|
// In addition to the documentation on Prepare above: Prepare is sometimes
|
|
// configured with a `map[string]interface{}` that has a key "packer_debug".
|
|
// This is a boolean value. If it is set to true, then the builder should
|
|
// enable a debug mode which allows builder developers and advanced users
|
|
// to introspect what is going on during a build. During debug builds,
|
|
// parallelism is strictly disabled, so it is safe to request input from
|
|
// stdin and so on.
|
|
type Builder interface {
|
|
// Prepare is responsible for configuring the builder and validating
|
|
// that configuration. Any setup should be done in this method. Note that
|
|
// NO side effects should take place in prepare, it is meant as a state
|
|
// setup only. Calling Prepare is not necessarily followed by a Run.
|
|
//
|
|
// The parameters to Prepare are a set of interface{} values of the
|
|
// configuration. These are almost always `map[string]interface{}`
|
|
// parsed from a template, but no guarantee is made.
|
|
//
|
|
// Each of the configuration values should merge into the final
|
|
// configuration.
|
|
//
|
|
// Prepare should return a list of warnings along with any errors
|
|
// that occurred while preparing.
|
|
Prepare(...interface{}) ([]string, error)
|
|
|
|
// Run is where the actual build should take place. It takes a Build and a Ui.
|
|
Run(ui Ui, hook Hook) (Artifact, error)
|
|
|
|
// Cancel cancels a possibly running Builder. This should block until
|
|
// the builder actually cancels and cleans up after itself.
|
|
Cancel()
|
|
}
|