Create and manage an HVN

You can create and manage a HashiCorp Virtual Network (HVN) for Microsoft Azure. Use an HVN to delegate an IPv4 CIDR range to HCP. The platform uses this CIDR range to automatically create a virtual network (VNet).

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 westus2 region, for example, adds the cluster to the westus2 region.
• All HCP resources must be located in one HVN. A single product deployment cannot span two different HVNs.
• You cannot move product deployments from one HVN to another.
• You cannot change HVNs after you deploy them.

Create an HVN

1. Sign in to the HCP Portal and select your organization.

2. From the left navigation menu, click HashiCorp Virtual Network.

3. Click Create network.

4. Name your virtual network.

5. Select Microsoft Azure as your provider.

6. Select a region from the dropdown menu.

   • One HVN can be created in each available cloud region.
   • Resources added to the HVN later are added in the same region.

7. (Optional) Specify a CIDR block. Click Show recommendations for more information.

   Recommended practice for HCP administrators

   Use a unique CIDR block for each HVN and ensure HVN CIDR blocks do not overlap with VNets in your Azure account.

8. Click Create network.

Connect an HVN to Microsoft Azure

To connect your HashiCorp Virtual Network to your Azure infrastructure, you must first create a peering connection. Then, specify traffic routes so that clusters can communicate with client resources. Individual configuration instructions are available:

• Peering Connections
• Routes
• Network Security Groups

Manage an HVN

You cannot modify HVNs after you deploy them, but some management features are available.

Import to Terraform

To import and manage your HVN in Terraform, complete the following steps:

1. Sign in to the HCP Portal and select your organization.
2. From the sidebar, click HashiCorp Virtual Network.
3. Click on an HVN in the ID column.
4. From the Manage menu, copy the provided terraform import command.
5. Open your terminal and run the command.

Delete an HVN

1. Sign in to the HCP Portal and select your organization.
2. From the sidebar, click HashiCorp Virtual Network.
3. Click on an HVN in the ID column.
4. From the Manage menu, click Delete.
5. When prompted, select Confirm.

Tutorial

• HashiCorp Virtual Network tutorials