Skip to main content

HCP Waypoint to add actions, enhances golden pattern capabilities, and more

The beta of HCP Waypoint actions — coming soon — will let platform teams expose Day 2+ operations and workflows to developers. Plus: enhancements to HCP Waypoint templates and add-ons.

Today at HashiDays in London, we are pleased to announce that the public beta of HCP Waypoint actions will be available soon. Actions enable platform teams to seamlessly expose Day 2+ operations and workflows to developers. HCP Waypoint is designed to empower platform teams to define golden patterns and workflows for developers to enable management of applications at scale. The addition of actions helps organizations define and execute golden workflows such as building an application, performing a rollback, or executing operations in private environments.

Alongside the new actions capability, we are announcing a suite of enhancements to HCP Waypoint templates and add-ons — two features that were first introduced in beta at HashiConf 2023. These enhancements give platform teams more ways to customize templates and add-ons while also introducing new ways to enable a seamless end-to-end self-serve experience for developers. The enhancements include:

  • Variable inputs and outputs: Variable inputs let platform teams select or specify input variable values when creating golden patterns using templates and add-ons. Platform teams may also choose which input values should be provided by developers. Variable output lets developers see outputs from the applications they create or the add-ons they install in HCP Waypoint.
  • HCP Terraform project selection: This feature allows platform teams to pre-define the HCP Terraform project where the associated Terraform workspace will be created for both application creation and add-on installations.
  • HCP CLI support: Users can access the HCP command-line interface (CLI) to interact with HCP Waypoint to manage templates, and add-ons features.
  • Terraform provider support: Platform teams can configure HCP Waypoint features through the familiar Terraform interface.

»Application lifecycle management challenges

Application lifecycle management involves all stages of application development, from creation until end-of-life. As services proliferate in large enterprises, managing them becomes more complex. The stages of an application’s lifecycle may involve supporting operations such as building, testing, releasing, and rollbacks. Each of these operations may use a different set of tools, which can create an inconsistent experience for developers.

Manually managing the application lifecycle can be tedious and error prone. Development teams need in-depth knowledge of every tool, creating multiple learning curves that begin again every time technologies evolve and teams need to change tools.

To help organizations meet these challenges, we are pleased to share that the public beta of HCP Waypoint actions will be available soon.

»Actions for HCP Waypoint

HCP Waypoint actions will provide a push-button experience to enable Day 2 operations like build promotions, rollbacks, or modifying feature flags. Actions let platform teams seamlessly share golden workflows with developers. Developers can then use those actions to execute their workflows with the push of a button.

Platform engineers can create actions that integrate with third-party APIs to trigger Day 2 workflows using the custom action type in HCP Waypoint. Once created, actions can be assigned to existing golden patterns using templates.

Creating Waypoint action

Creating an action in the HCP Waypoint UI

When developers use templates to create applications, actions are automatically attached to the applications. Developers can use these actions to perform Day 2 operations such as triggering a build, deploying an application, or changing a feature flag.

Accessing assigned actions for an application in the HCP Waypoint UI

Accessing assigned actions for an application in the HCP Waypoint UI

»Supporting operations in private environments with HCP Waypoint agents

Organizations often have infrastructure and application workloads spanning public clouds and private on-premises datacenters. HCP Waypoint agents provide a secure way to integrate private environment operations with HCP Waypoint actions. This means that even in more custom, self-managed infrastructure environments, HCP Waypoint actions can still perform Day 2 operations with a push-button experience.

HCP Waypoint agents let customers execute their application lifecycle operations inside private on-premises environments while continuing to benefit from the HCP Waypoint management platform — without having to change their network access policies to ingest traffic.

HCP Waypoint agent running in a private environment to securely execute an HCP Waypoint action

HCP Waypoint agent running in a private environment to securely execute an HCP Waypoint action

Platform engineers can create “agent” type actions and let developers execute them using the HCP Waypoint UI. Agents use an HCL configuration file that contains action definitions and instructions for what the agent should do when users run an action. For example, users can use the agent to trigger custom scripts written in Bash or other programs. Here is a sample HCP Waypoint agent configuration file:

group "internal-infra-us-west-2" {
  action "update-deployment" {
    run {
      command = ["./update-deployment.sh", var.waypoint_application]
    }
  }
 
  action "example-action" {
    run {
      command = ["echo", "hello world"]
    }
  }
}

»Input and output variables

HCP Waypoint helps platform teams define golden patterns for their application developers using templates and add-ons that build on no-code ready modules present in HCP Terraform. Platform engineers often want to define a set of variables and associated values for creating templates or add-ons, and pass these values to the underlying no-code ready module during workspace provisioning. Additionally, platform teams want developers to provide variable values during application creation. Previously, templates and add-ons in HCP Waypoint didn’t allow users to specify variable values.

Input variables let platform teams select or specify appropriate input variable values when creating templates and add-ons. These variable values can be passed to the no-code ready module when provisioning an HCP Terraform workspace. Platform teams may also choose variables whose values can be supplied by developers during application creation, which enhances composability and customization for developers.

Creating an application while supplying input variable values in the HCP Waypoint UI

Creating an application while supplying input variable values in the HCP Waypoint UI

When creating applications using templates or installing add-ons, developers often need to see the resulting output values. These output values may include the application URL, code repository address, database address, and so on. Output variables let developers see these outputs in HCP Waypoint when they create applications or install an add-on.

Viewing an add-on output in the HCP Waypoint UI

Viewing an add-on output in the HCP Waypoint UI

»HCP Terraform project selection

Platform teams often need to target a specific HCP Terraform project for workspaces created when developers build applications or install add-ons using HCP Waypoint. Users can now configure HCP Waypoint templates and add-ons to select an HCP Terraform project during the creation process.

Selecting an HCP Terraform project in HCP Waypoint UI

Selecting an HCP Terraform project in HCP Waypoint UI

»HCP CLI support

Previously, users could use only the HCP Waypoint UI to create, view, or manage their Waypoint resources. Now, the HCP CLI supports HCP Waypoint, enabling interaction with templates, and add-ons features. Here is an example usage of the Waypoint subcommand in the HCP CLI:

hcp waypoint
USAGE
  hcp waypoint <command> [Optional Flags]
 
DESCRIPTION
  The hcp waypoint command group lets you manage HCP Waypoint resources through
  the CLI. These commands let you to interact with their HCP Waypoint instance to
  manage their application deployment process.
 
COMMAND GROUPS
  add-ons:       Manage HCP Waypoint add-ons and add-on definitions.
  applications:  Manage HCP Waypoint applications.
  templates:     Manage HCP Waypoint templates.
  tfc-config:    Manage Terraform Cloud Configurations.

»Terraform provider support

HCP Waypoint now supports managing resources such as templates, add-ons, or applications using the HCP Terraform provider and provisioning them using HashiCorp Terraform. This lets platform teams configure HCP Waypoint features through the familiar Terraform interface, making it easier to manage their resources. Here is an example configuration that creates an HCP Waypoint template using the HCP Terraform provider and uses the template to create a HCP Waypoint application:

data "tfe_project" "waypoint" {
  name         = "Default Project"
  organization = "waypoint-tfc-testing"
}
 
resource "hcp_waypoint_application_template" "static" {
  name                     = "static-app"
  readme_markdown_template = base64encode("# Hello world!")
  terraform_no_code_module = {
    source  = "private/example/static-app/hello"
    version = "0.0.1"
  }
  terraform_cloud_workspace_details = {
    name                 = data.tfe_project.waypoint.name
    terraform_project_id = data.tfe_project.waypoint.id
  }
  labels = ["static"]
}
 
resource "hcp_waypoint_application" "example" {
  name                    = "example-application"
  application_template_id = hcp_waypoint_application_template.static.id
}

»Get started with HCP Waypoint

We are excited for users to try templates, add-ons, and actions in HCP Waypoint, available soon in public beta. If you don’t already have one, we recommend getting started by creating a HashiCorp Cloud Platform (HCP) account and giving HCP Waypoint a try.

For more information, please visit the HCP product page or sign up through the HCP portal. To learn more about HCP Waypoint templates, add-ons, and actions, please refer to the documentation and watch the demo video below:

For more context, check out HashiCorp Co-Founder and CTO Armon Dadgar’s whiteboard explainer video on internal developer platforms:

Sign up for the latest HashiCorp news

By submitting this form, you acknowledge and agree that HashiCorp will process your personal information in accordance with the Privacy Policy.

HashiCorp uses data collected by cookies and JavaScript libraries to improve your browsing experience, analyze site traffic, and increase the overall performance of our site. By using our website, you’re agreeing to our Privacy Policy and Cookie Policy.

The categories below outline which companies and tools we use for collecting data. To opt out of a category of data collection, set the toggle to “Off” and save your preferences.