pack v0.3.0

This is the third 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.3.0. This new release of the lifecycle contains several features and fixes that are not mentioned below.

Features

• Support building with zipped application directories as well as JAR files (#220 -> #234).
• Add bash autocompletion (#146).
• Export additional builder methods (#214 -> #227).
• Support pack create-builder on Windows (#181).

Fixes

• Use correct home directory on Windows for pack CLI configuration (#242).
• Fix backwards compatibility of cache (#229 -> #231).
• Only skip analysis step in analyze phase when clearing cache (#221).
• Skip sockets in the app directory instead of failing (#208, #218).
• Validate remote run images when building against the daemon (#213).

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.