HCP Terraform Workflows for GitHub
This repo includes prescriptive workflows that implement best practices when interacting with HCP Terraform. These starter workflow templates provide a entrypoint to integrate your CI/CD pipelines with HCP Terraform.
Related Projects
About
These templates use individual custom Docker GitHub Actions that interact with HCP Terraform API's rather than the traditional Terraform CLI.
The core tooling is a containerized go application, designed to work with GitHub Actions, GitLab Pipelines, and more in the future.
Starter Workflow Templates
Getting Started
See workflow/README.md
GitHub Actions
See actions/README.md
Supported Actions:
-
upload-configuration: Creates and uploads configuration files for a given HCP Terraform workspace.
-
create-run: Performs a new plan run in HCP Terraform, using a configuration version and the workspace’s current variables.
-
apply-run: Applies a run that is paused waiting for confirmation after a plan.
-
discard-run: Skips any remaining work on runs that are paused waiting for confirmation or priority.
-
cancel-run: Interrupts a run that is currently planning or applying.
-
show-run: Returns run details for the corresponding Run ID.
-
plan-output: Returns the plan details for the provided Plan ID.
Contributing Guideline
See docs/CONTRIBUTING.md
License
Mozilla Public License v2.0