Type '/' to Search

»Create and Manage an HVN

This topic describes how to create and manage a HashiCorp Virtual Network (HVN) for AWS. An HVN allows you to delegate an IPv4 CIDR range to HCP, which the platform then uses to automatically create a virtual private cloud (VPC).

»Specification

  • You can create one HVN for each available cloud region.

  • Resources added to an HVN appear in the HVN's cloud region. Deploying a cluster into an HVN created in the us-east-1 region, for example, adds the cluster to the us-east-1 region.

  • All HCP resources must be located in one HVN. A single product deployment cannot span two different HVNs.

  • Product deployments cannot be moved from one HVN to another.

  • HVNs cannot be changed after they are deployed.

»Create an HVN

  1. Launch the HCP portal and log in.
  2. Choose your organization and click HashiCorp Virtual Network in the sidebar.
  3. Click Create a network and specify a name for your network.
  4. Choose the region from the Region selection menu. One HVN can be created in each available cloud region. Resources added to the HVN will be placed in the same region.
  5. (Optional) Specify a CIDR block. Click Show recommendations to learn more about CIDR block options.
  6. Click Create network. The HVN overview screen appears, which contains details about the new HVN.

You can now begin connecting the HVN to your AWS infrastructure.

»Connect an HVN

You must either create a peering connection or a transit gateway (TGW) attachment and specify traffic routes so that clusters can communicate with client resources. Refer to the following topics for instructions:

»Manage an HVN

HVNs cannot be modified after they are deployed, but the following management features are available.

»Import to Terraform

HCP prints a command that you can copy and run to import and manage the HVN in Terraform.

  1. Launch the HCP portal and log in.
  2. Choose your organization and click HashiCorp Virtual Network in the sidebar.
  3. Click the HVN in the ID column and open the Manage menu.
  4. Add the resource to your root Terraform module.
  5. Copy and run the provided terraform import command.

»Delete an HVN

  1. Launch the HCP portal and log in.
  2. Choose your organization and click HashiCorp Virtual Network in the sidebar.
  3. Click on the HVN in the ID column and open the Manage menu.
  4. Click Delete and follow the instructions for completing the action when prompted.