HashiCorp Developer AI Private beta now available Sign up today
Waypoint
Waypoint Integrations
Docker

@hashicorp

The Docker plugin can build a Docker image of an application, push a Docker image to a remote registry, and/or deploy the Docker image to a Docker daemon. It also launches on-demand runners to do operations remotely.

  • Official
  • Built-in

Updated last year

Docker Builder

Archive Notice

This integration relates to a legacy version of Waypoint and is no longer actively maintained.
Read the blog
(opens in new tab)

Build a Docker image from a Dockerfile.

If a Docker server is available (either locally or via environment variables such as "DOCKER_HOST"), then "docker build" will be used to build an image from a Dockerfile.

Dockerless Builds

Many hosted environments, such as Kubernetes clusters, don't provide access to a Docker server. In these cases, it is desirable to perform what is called a "dockerless" build: building a Docker image without access to a Docker daemon. Waypoint supports dockerless builds.

Waypoint performs Dockerless builds by leveraging Kaniko within on-demand launched runners. This should work in all supported Waypoint installation environments by default and you should not have to specify any additional configuration.

Interface

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

Examples

build {
  use "docker" {
    buildkit    = false
    disable_entrypoint = false
  }
}

Parameters

17 Results

  • authOptionalcategory

    the authentication information to log into the docker repository

    • auth.authOptionalstring
    • auth.emailOptionalstring
    • auth.hostnameOptionalstring

      Hostname of Docker registry

    • auth.identityTokenOptionalstring

      Token used to authenticate user

    • auth.passwordOptionalstring

      Password of Docker registry account

    • auth.registryTokenOptionalstring

      Bearer tokens to be sent to Docker registry

    • auth.serverAddressOptionalstring

      Address of Docker registry

    • auth.usernameOptionalstring

      Username of Docker registry account

  • build_argsOptionalmap of string to string

    build args to pass to docker for the build step A map of key/value pairs passed as build-args to docker for the build step.

  • buildkitOptionalbool

    if set, use the buildkit builder from Docker

  • contextOptionalstring

    Build context path

  • disable_entrypointOptionalbool

    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

  • dockerfileOptionalstring

    The path to the Dockerfile. Set this when the Dockerfile is not APP-PATH/Dockerfile

  • no_cacheOptionalbool

    Do not use cache when building the image Ensures a clean image build.

  • platformOptionalstring

    set target platform to build container if server is multi-platform capable Must enable Docker buildkit to use the 'platform' flag.

  • targetOptionalstring

    the target build stage in a multi-stage Dockerfile If buildkit is enabled unused stages will be skipped

Outputs

4 Results

  • architecturestring
  • imagestring
  • locationdocker.isImage_Location
  • tagstring