»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
- Launch the HCP portal and log in.
- Choose your organization and click HashiCorp Virtual Network in the sidebar.
- Click Create a network and specify a name for your network.
- 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.
- (Optional) Specify a CIDR block. Click Show recommendations to learn more about CIDR block options.
- 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.
Tutorial: Refer to the HashiCorp Virtual Network tutorials for additional guidance on creating an HVN.
»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.
- Launch the HCP portal and log in.
- Choose your organization and click HashiCorp Virtual Network in the sidebar.
- Click the HVN in the ID column and open the Manage menu.
- Add the resource to your root Terraform module.
- Copy and run the provided
terraform import
command.
»Delete an HVN
- Launch the HCP portal and log in.
- Choose your organization and click HashiCorp Virtual Network in the sidebar.
- Click on the HVN in the ID column and open the Manage menu.
- Click Delete and follow the instructions for completing the action when prompted.