This page explains concepts associated with HCP Waypoint add-on definitions and add-ons.
HCP Waypoint add-ons are modular components that application developers can use to install supporting infrastructure to their application at any point in the application lifecycle. An add-on can install infrastructure or services, including databases, storage buckets, secrets engines, search engines, telemetry dashboards, and much more.
The platform team creates and maintains add-on definitions, which serve as templates for add-ons. This ensures that any infrastructure provisioned using add-ons is standardized and compliant with your organization's policies.
HCP Waypoint add-on definitions reference Terraform Cloud no-code modules to define the common supporting infrastructure patterns.
Refer to How does HCP Waypoint work? for an overview of the workflow. The following steps describe the add-on creation and consumption model:
Platform engineers create the following artifacts:
- A no-code module that references an HCP Waypoint application: No-code modules are Terraform Cloud artifacts that allow you to deploy a module's resources without writing Terraform configuration. Refer to Designing No-Code Ready Modules in the Terraform documentation for additional information.
- An HCP Waypoint add-on definition associated with the no-code module.
Refer to Create and manage add-on definitions for details and instructions on how to complete this process.
An application engineer goes to an HCP Waypoint application and selects a suitable add on they want to install, triggering the following automated procedure:
- HCP Waypoint uses the add-on definition's Terraform no-code module to create a Terraform workspace in the Terraform Cloud organization as configured by the platform engineer.
- HCP Waypoint assigns the
waypoint_applicationvariables to the Terraform workspace. Your no-code module can reference these values to label the resources it deploys.
- HCP Waypoint starts a Terraform run in the workspace. When the Terraform workspace run completes, the HCP Waypoint add-on and supporting infrastructure is ready.
Refer to Use an add-on to deploy supporting infrastructure for details and instructions on how to complete this process.