pack v0.11.0

This is a 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

macOS

If you're on macOS, you can use Homebrew:

$ brew install buildpacks/tap/pack

Linux

On Linux you can use the one of the following methods of installation.

Arch Linux

• pack-cli
• pack-cli-bin

Command

(export GH=buildpacks/pack; export LATEST=$(curl -s https://api.github.com/repos/$GH/releases/latest | grep -o -E "https://.+?-linux.tgz" | head -1); echo "$LATEST"; curl -sSL "$LATEST" | sudo tar -C /usr/local/bin/ --no-same-owner -xzv $(basename $GH))

Others

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
  rebase                Rebase app image with latest run image
  inspect-image         Show information about a built image
  set-run-image-mirrors Set mirrors to other repositories for a given run image
  set-default-builder   Set default builder used by other commands
  inspect-builder       Show information about a builder
  suggest-builders      Display list of recommended builders
  trust-builder         Trust builder
  create-builder        Create builder image
  package-buildpack     Package buildpack in OCI format.
  suggest-stacks        Display list of recommended stacks
  version               Show current 'pack' version
  report                Display useful information for reporting an issue
  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
      --version      Show current 'pack' version

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

Info

Builders created with this release of the pack CLI continue to contain lifecycle v0.7.5 by default.

Features

• Performance and security improvements (learn more)
  • Trusted builders (#634, #644)
  • Run analyze, restore, and export via a trusted lifecycle image (#631)
  • Run creator from the lifecycle (#595)
• Hide stack mixins for inspect-builder behind --verbose option (#630)
• Add .cnb file support for package-buildpack dependencies (#633)
• Support .cnb files in create-builder (#611)
• Overwrite permissions in zip files for FAT formatted entries (#598)
• Error when --publish and --no-pull are used in an unsupported fashion (#594)
• Adds experimental flagging (#576)
• Add Google builder to suggest-builders (#637)
• Update suggest-builders to use Paketo builders instead of Cloud Foundry builders (#559)
• Support windows containers for create-builder [experimental] (#571)
• Support buildpacks from buildpack registry for create-builder and build [experimental] (#540)

Fixes

• Propagate verbose logging flag to analyze and build phases (#636)
• build ... --publish now respects default process type (#602)
• Support substitution for config files such as from envsubst (#592)
• Remove daemon access from restore phase (#589)
• create-builder can now handle when both uri and image buildpacks as provided (#625)

Breaking Changes

• Network mode is now respected for all phases of the lifecycle (#595)
  • This means that publishing (--publish) might be impacted if the network mode does not have access to the registry to which the image is being published to. Previously, analyze and export phases used host network mode when publishing and now use the default (aka bridge) network mode.
  • Related conversations: Slack
  • Solution:
    • Network mode can be configured via the --network flag.
• Builders with lifecycle versions that don't have a published lifecycle image will error (#644)
  • This would only impacts builders that are not trusted.
  • Solutions:
    • Set builder as trusted via pack trust-builder ... or pass --trust-builder to the build command.
    • Update builder to use the latest versions of supported lifecycle versions.