pack v0.5.0

This is the fifth 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
  inspect-image         Show information about a built 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
  suggest-stacks        Display list of recommended stacks
  version               Show current 'pack' version
  completion            Outputs completion script location
  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
  -v, --verbose      Show more output

Use "pack [command] --help" for more information about a command.

Info

Builders created with this release of the pack CLI contain lifecycle v0.5.0 by default. 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.

Features

• Adds pack inspect-image command (#361).
• Adds buildpack layer metadata to builder images (#360)
• Allow users to set container network mode during build and detect phases (#309)
• Updates to suggested stacks (#330, #311, #329)
• inspect-builder display created-by info (#310)
• Adds --verbose option (#314)
• Display download progress (#298, #236)

Fixes

• Fixes run-image metadata set on image during rebase (#344)
• Fixes error message when buildpack.toml is missing required fields (#338)
• Make buildpack layer generation reproducible in create-builder (#332)
• --no-color works on Windows (only true for pack output, not lifecycle or buildpack output) (#326)

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.