Skip to main content

HCP Waypoint actions is now in public beta

The beta of HCP Waypoint actions to let platform teams expose Day 2+ operations and workflows to developers.

Initially announced at HashiDays in London, HCP Waypoint actions enable platform teams to seamlessly expose Day 2+ operations and workflows to developers. Today, we’re pleased to announce the public beta release of HCP Waypoint actions.

»Introducing HCP Waypoint actions

HCP Waypoint is designed to help platform teams define golden patterns and workflows that developers can use to ship applications at scale. HCP Waypoint actions provide a push-button experience to enable Day 2+ operations such as build promotions, rollbacks, and modifying feature flags. Actions make it easier for platform teams to enable self-service, Day 2+ golden workflows for developers.

Platform teams and developers can interact with actions directly in the HashiCorp Cloud Platform (HCP). A typical action usage process looks like this:

1.  A platform engineer creates an action using the HCP Waypoint UI by selecting an action type and providing specific details relevant to the action.

Platform engineer creates an action and assigns it to a template

Platform engineer creates an action and assigns it to a template

2.  Once the action is created, the platform engineer assigns the action to a template.

3.  A developer uses the template to create an application, and actions are automatically assigned to the application.

Application engineer creates an application using a template, and actions are automatically assigned to the newly created application

Application engineer creates an application using a template, and actions are automatically assigned to the newly created application

4.  A developer can then trigger Day 2+ workflows by simply by selecting the name of the action they want to run

Application engineer executes an action to trigger Day 2+ workflows

Application engineer executes an action to trigger Day 2+ workflows

»Integrate with HTTP APIs

Platform engineers can create actions that integrate with third-party HTTP APIs to trigger Day 2+ workflows using the “Custom” action type in HCP Waypoint.

Creating an action in the HCP Waypoint UI

Creating an action in the HCP Waypoint UI

Using the “Custom” action type, you can configure a source URL, method, headers, and body of the request that can be used to trigger an upstream API. This enables platform teams to create actions tailored to specific Day 2+ use cases.

Configuring a custom type action with HTTP options

Configuring a custom type action with HTTP options

Developers can execute actions right from their application dashboard in HCP Waypoint:

Accessing assigned actions for an application in the HCP Waypoint UI

Accessing assigned actions for an application in the HCP Waypoint UI

Workflows that can be enabled by the custom action type by integrating with HTTP APIs include:

  • Triggering CI/CD operations such as building and deploying applications
  • Promotions and rollbacks of services
  • Turning on maintenance mode for web services
  • Restarting services
  • Toggling feature flags
  • Initiating snapshots for databases

»Trigger operations in private environments

HCP Waypoint agents let customers execute their application lifecycle operations using actions 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 an “agent group” in HCP Waypoint that lets them group Waypoint agents together:

Creating an agent group in the HCP Waypoint UI

Creating an agent group in the HCP Waypoint UI

Platform engineers can then create “agent” type actions and select the agent group that the action belongs to. Agents use an HashiCorp Configuration Language (HCL) configuration file that contains action definitions and instructions for what the agent should do when users run an action. Platform teams can use the agent configuration file to specify commands, scripts, or any custom program that they want to trigger. 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"]
    }
  }
}

Currently, agents can be started by using a simple command in the HCP CLI and providing an agent configuration file:

hcp waypoint agent run -c ${AGENT_CONFIG_FILE}

Developers can use agent type actions to trigger operations that may be running in a private environment using a push-button experience in HCP Waypoint. Based on the action executed, agents can execute the appropriate operation specified in the agent configuration file.

Workflows that are enabled by the agent action type include:

  • Accessing private version control system (VCS) providers to perform build or deploy operations.
  • Integrating with internal legacy systems

»Key benefits of actions

Key benefits of using HCP Waypoint actions include:

  • Self-service for developers: Actions let developers run application lifecycle tasks independently, without requiring them to reach out to platform teams.
  • Auto-assign prescribed workflows with applications: Actions promote standardized best practices for Day 2+ workflows by automatically assigning them to golden patterns prescribed using Waypoint templates.

»Get started with HCP Waypoint actions

We are excited for users to try HCP Waypoint actions in public beta. If you don’t already have one, we recommend getting started by creating a HCP account and giving HCP Waypoint a try.

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

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.