Managing your networks and subnets

Creating a new VPC network

CLI

Use the networking vpc-networks create command to create a new VPC network.

crusoe networking vpc-networks create \
  --name my-new-vpc-network \
  --cidr 10.0.0.0/8

UI

To create a VPC network via the console:

1. From the console, select Networking > VPC Networks in the left nav.
2. Click Create VPC Network.
3. Input a name and CIDR range for the VPC Network.
4. Click Create.

Terraform

To create a VPC network using the Crusoe Terraform provider, you can use the following code snippet:

terraform {
  required_providers {
    crusoe = {
      source = "registry.terraform.io/crusoecloud/crusoe"
    }
  }
}

resource "crusoe_vpc_network" "my_vpc_network" {
  name = "my-new-network"
  cidr = "10.0.0.0/8"
}

"name" and "cidr" required arguments for the VPC network resource in the Crusoe Terraform provider.

Viewing all VPC networks

CLI

Use the networking vpc-networks list command to list existing networks.

crusoe networking vpc-networks list

UI

To view networks via the console, select Networking > VPC Networks in the left nav.

Terraform

To list existing VPC networks using Terraform, the following code snippet can be used to populate a Terraform data source using the Crusoe Terraform provider.

# list vpc networks
data "crusoe_vpc_networks" "networks" {}

output "crusoe_vpc_networks" {
  value = data.crusoe_vpc_networks.networks
}

Update an existing VPC network

CLI

Non-default VPC networks can be updated in the CLI using the networking vpc-networks update <id> command. Currently, only the name of the non-default VPC network can be updated (using the --name flag).

UI

To update an existing non-default VPC network via the console:

1. From the console, select Networking > VPC Networks in the left nav.
2. Navigate to the row of the VPC network you want to update.
3. Click the pencil icon on the far right side of the row.
4. Edit the fields you want to modify.
5. Click Update to save your changes.

Terraform

To update a VPC network using the Crusoe Terraform provider, you can change the fields of an existing VPC network resource and run terraform apply. The Crusoe Terraform provider will apply the changes to the VPC network.

terraform {
  required_providers {
    crusoe = {
      source = "registry.terraform.io/crusoecloud/crusoe"
    }
  }
}

resource "crusoe_vpc_network" "my_vpc_network" {
  name = "my-new-network" -> "new-network-name"
  cidr = "10.0.0.0/8"
}

Currently, only the "name" of the VPC network can be updated. Changes to the "cidr" of the VPC network will force a re-creation of the VPC network (deletion and then creation of a new network)

Deleting a VPC network

info

Warning: deleting a VPC network is a permanant action that will require re-creation of the network to recover.

CLI

Non-default VPC Networks can be deleted in the CLI using the networking vpc-networks delete <id> command.

UI

To delete a VPC network via the console:

1. From the console, select Networking > VPC Networks in the left nav.
2. Navigate to the row of the VPC Network you want to delete.
3. Click the trash can icon on the far right side of the row.
4. Click Confirm.

Terraform

A VPC network can be deleted by using the terraform destroy command provided by the Terraform CLI tool.

If you are having issues working with your VPC networks, please contact support.