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:

1. Download the .tgz or .zip file for your platform
2. Extract the pack binary
3. (Optional) Add the directory containing pack to PATH, or copy pack 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.