pack v0.4.1
pack v0.4.1
This is the fourth beta release of the Cloud Native Buildpack local CLI. This platform implementation should be relatively stable and reliable, but breaking changes in the underlying specification may be implemented without notice. Note that pack is intended for local image builds, and thus requires a Docker daemon. The lifecycle should be used directly when building on cloud platforms.
Prerequisites
- The Docker daemon must be installed on your workstation or accessible over the network.
Install
If you're on macOS, you can use Homebrew:
$ brew tap buildpack/tap
$ brew install pack
Otherwise:
- Download the
.tgz
or.zip
file for your platform - Extract the
pack
binary - (Optional) Add the directory containing
pack
toPATH
, or copypack
to a directory like/usr/local/bin
Run
Run the command pack
.
You should see the following output
Usage:
pack [command]
Available Commands:
build Generate app image from source code
run Build and run app image (recommended for development only)
rebase Rebase app image with latest run image
create-builder Create builder image
set-run-image-mirrors Set mirrors to other repositories for a given run image
inspect-builder Show information about a builder
set-default-builder Set default builder used by other commands
suggest-builders Display list of recommended builders
version Show current 'pack' version
help Help about any command
Flags:
-h, --help Help for 'pack'
--no-color Disable color output
-q, --quiet Show less output
--timestamps Enable timestamps in output
Use "pack [command] --help" for more information about a command.
Info
Builders created with this release of the pack CLI contain lifecycle v0.4.0. This new release of the lifecycle contains several features and fixes that are not mentioned below. Please see the lifecycle release notes for additional changes.
Notice of Breaking Changes
pack create-builder
now creates builders using 0.4.0 of the lifecycle. This release contains major breaking changes to the buildpack contract. Please read the lifecycle v0.4.0 release notes and update your buildpacks accordingly.
pack build
continues to support builders created with lifecycle 0.3.0.
Features
- Support more ways of specifying buildpacks (#301, #300).
- Allow
--env-file
to be specified more than once (#291, #264). - Validate API versions specified by the lifecycle and buildpacks (#284).
- Switch to new default builder paths (#266).
- Improve validation of builder.toml (#263).
- Support both 0.3.0 and 0.4.0 lifecycles (#259, #252, #250).
Fixes
- Make
--no-pull
skip checking remote image (#290, #249). - Make downloads interruptible (#292, #235).
- Fix issue where
--buildpack
fails to support buildpack URIs (#246, #245). - Fix bash completion issue (#272).
Known Issues
- Publishing to a private registry from Windows still fails in some cases (#109). We have fixed this upstream in Docker for Windows (docker/docker-credential-helpers#139), but Docker will need to ship a new version to fix this bug.