Use a template to deploy and manage an application

This page describes how to create an HCP Waypoint application using a template. Application engineers often perform this task. Refer to Templates for additional information.

Background

HCP Waypoint templates are common infrastructure patterns created and maintained by platform engineers. This ensures that any infrastructure provisioned using templates is compliant with your organization's policies for security, finance, scaling, and more. Application developers use these standardized templates to deploy their applications without worrying about the underlying infrastructure.

Prerequisites

• An HCP Account. Refer to HCP Account for information about creating an account.

Create an application

To create an application, complete the following steps:

1. From the HCP Waypoint overview, go to the Applications menu.
2. Click Create application, and then select Create application with template.
3. Select the template which suits the needs of your new application
4. Click Next.
5. Configure the settings for your new application, including the application name.
6. Click Create application.
7. On the next screen, the application overview page, monitor the status of the creation of the application infrastructure, and read through the developer instructions.
8. After the application infrastructure is created, follow the developer instructions to complete the process of deploying your application.

Update an application

When you update the module version in HCP Terraform, every application deployed from a template that uses that module displays a notification that you can update the application. HCP Waypoint does not automatically update applications. The owner of the application must respond to the update notification to upgrade the application, and HCP Waypoint prompts for values for any new input variables. For more information on updating a no-code module's version, refer to the designing no-code modules documentation.

If the new module version has a new input variable, you must first update the template settings to either provide a default value for the variable, or allow the value to be supplied when the template is deployed.

To update an application that has a new version available:

1. Navigate to the application overview page.
2. Click the View update in the "Application is ready to update" notification at the top of the page.
3. Enter values for any new input variables.
4. Click Apply update.

HCP Waypoint automatically starts a plan run in HCP Terraform. If the plan completes successfully, HCP Waypoint automatically starts an apply run to upgrade the workspace.

Delete an application

Deleting an application will delete the HCP Terraform workspace and resources associated with the application.

To delete an application, complete the following steps:

1. From the HCP Waypoint overview, go to the Application menu.
2. Select your application, then go to the Settings page.
3. Click Manage, and select Delete application.
4. Enter DELETE, and then click Delete.

Next steps

To learn more about what you can do with HCP Waypoint after you deployed an application using a template, refer to the following topics:

• Create and manage add-on definitions
• Use an add-on to deploy supporting infrastructure