Integrating Waypoint with GitHub Actions
Warning
This content is part of the legacy version of Waypoint that is no longer actively maintained. For additional information on the new vision of Waypoint, check out this blog post and the HCP Waypoint documentation.
Running Waypoint and GitHub Actions takes minimal setup and configuration due to a set of GitHub Actions provided to automatically install and run Waypoint. Waypoint can also be configured via these actions to automatically annotate pull requests and commits with relevant statuses of builds, deploys, and releases.
There are two options for utilizing Waypoint and GitHub actions.
hashicorp/action-setup-waypoint
This action sets up Waypoint based on version. This action can be composed with other steps to run Waypoint, and is currently the recommended approach.
For example, a cloud provider credentials or tooling can be installed or configured before running Waypoint, ensuring it has the appropriate credentials in the environment to run.
The source is available on GitHub at hashicorp/action-setup-waypoint.
Example
hashicorp/action-waypoint
Note: This is an experiment and isn't recommended for consistent usage. For anything beyond experimental, we recommend using action-setup-waypoint.
This action provides an abstraction for working with Waypoint and the GitHub releases and commit statuses APIs. It is intended to be the easiest way to automatically deploy applications with GitHub and Waypoint, only requiring that you are running a Waypoint server and have configured actions as in the below example.
This results in an experience in a pull request similar to the below screenshot.
The source is available on GitHub at hashicorp/action-waypoint.
Example