»CloudNative Buildpacks

»pack (builder)

Create a Docker image using CloudNative Buildpacks.

Pack requires access to a Docker daemon. For remote builds, such as those triggered by Git polling, the runner needs to have access to a Docker daemon such as exposing the Docker socket, enabling Docker-in-Docker, etc. Unfortunately, pack doesn't support dockerless builds. Configuring Docker access within a Docker container is outside the scope of these docs, please search the internet for "Docker in Docker" or other terms for more information.


  • Input: component.Source
  • Output: pack.Image


build {
  use "pack" {
    builder     = "heroku/buildpacks:18"
    disable_entrypoint = false


»Allow pack images to be used as normal docker images

  • Input: pack.Image
  • Output: docker.Image

»Required Parameters

This plugin has no required parameters.

»Optional Parameters

These parameters are used in the use stanza for this plugin.


The buildpack builder image to use.

  • Type: string
  • Optional
  • Default: heroku/buildpacks:18


The exact buildpacks to use.

If set, the builder will run these buildpacks in the specified order. They can be listed using several URI formats.

  • Type: list of string
  • Optional


If set, the entrypoint binary won't be injected into the image.

The entrypoint binary is what provides extended functionality such as logs and exec. If it is not injected at build time the expectation is that the image already contains it.

  • Type: bool
  • Optional


File patterns to match files which will not be included in the build.

  1. A blank line matches no files, so it can serve as a separator for readability.
  3. Trailing spaces are ignored unless they are quoted with backslash ("\").
  9. Two consecutive asterisks ("") in patterns matched against full pathname may have special meaning: i. A leading "" followed by a slash means match in all directories. For example, " /foo" matches file or directory "foo" anywhere, the same as pattern "foo". " /foo/bar" matches file or directory "bar" anywhere that is directly under directory "foo". ii. A trailing "/" matches everything inside. For example, "abc/" matches all files inside directory "abc", relative to the location of the .gitignore file, with infinite depth. iii. A slash followed by two consecutive asterisks then a slash matches zero or more directories. For example, "a/** /b" matches "a/b", "a/x/b", "a/x/y/b" and so on. iv. Other consecutive asterisks are considered invalid.`),
  • Type: list of string
  • Optional


The process type to use from your Procfile. if not set, defaults to web.

The process type is used to control over all container modes, such as configuring it to start a web app vs a background worker.

  • Type: string
  • Optional


Environment variables to expose to the buildpack.

These environment variables should not be run of the mill configuration variables, use waypoint config for that. These variables are used to control over all container modes, such as configuring it to start a web app vs a background worker.

  • Type: map of string to string
  • Optional

»Output Attributes

Output attributes can be used in your waypoint.hcl as variables via artifact or deploy.


  • Type: map of string to string


  • Type: string


  • Type: string