• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
Waypoint
  • Install
  • Tutorials
  • Documentation
  • CLI
  • Plugins
  • Try Cloud(opens in new tab)
  • Sign up
Waypoint Home

Documentation

Skip to main content
  • Documentation
  • Getting Started


    • Overview
    • app
    • build
    • config
    • deploy
    • hook
    • plugin
    • registry
    • release
    • runner
    • url
    • use
    • variable
  • URL Service
  • Logs
  • Exec
  • Workspaces
  • Plugins
  • Triggers

  • Troubleshooting
  • Glossary

  • Roadmap

  • Resources

  • Tutorial Library
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  1. Developer
  2. Waypoint
  3. Documentation
  4. waypoint.hcl
  5. build
  • Waypoint
  • v0.9.x
  • v0.8.x
  • v0.7.x
  • v0.6.x
  • v0.5.x
  • v0.4.x
  • v0.3.x
  • v0.2.x
  • v0.1.x

ยปbuild Stanza

Placementapp -> build

The build stanza describes how an application is built. Waypoint converts application source code into an artifact. Waypoint can store the image locally, or push it to a remote registry. Read more about the build phase of the application lifecycle here.

Exactly one build stanza is required within an app stanza.

app "frontend" {
  build {
    use "docker" {}

    registry {
      # ...
    }

    hook {
      # ...
    }
  }

  # ...
}

build Parameters

Required

  • use (use) - The plugin to use for building the application. For example, the "docker" plugin will use docker build to build your application.

Optional

  • hook (hook: nil) - Hooks to execute before and/or after the build.

  • registry (registry: nil) - A registry to push the built artifact to. If this isn't specified, the artifact isn't pushed to any registry and it is assumed that the deployment can access the build result.

Edit this page on GitHub

On this page

  1. build Stanza
  2. build Parameters
Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)