Manage your subnets

Creating a new VPC subnet

CLI

Use the networking vpc-subnets create command to create a new VPC subnet. Optionally, you may use the nat-gateway-enabled flag to enable NAT Gateways.

crusoe networking vpc-subnets create \
  --name my-new-vpc-subnet \
  --location us-east1-a
  --vpc-network-id <uuid-of-vpc-network>
  --cidr 10.10.0.0/16
  --nat-gateway-enabled true

UI

In order to create a VPC subnet via the Crusoe Cloud console:

• Visit the Crusoe Cloud console
• Click the "Network" tab in the left nav
• Click the "VPC Subnets" tab underneath the "Network" title
• Click the "Create VPC Subnet" button
• Input a name and CIDR range for the VPC Subnet
• Select the location and VPC Network in which you would like to create the VPC Subnet
• Optionally, use the "Enable NAT Gateway" toggle to provision your VPC Subnet with a NAT Gateway
• Click "Create"

Terraform

To create a VPC subnet using the Crusoe Terraform provider, you can use the following code snippet. The snippet creates a new VPC network, and then creates a new VPC subnet in the created. This example also creates a subnet with a NAT Gateway.

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"
}

resource "crusoe_vpc_subnet" "my_vpc_subnet" {
  name = "my-new-subnet"
  cidr = "10.0.0.0/16"
  location = "us-northcentral1-a"
  network = crusoe_vpc_network.my_vpc_network.id
  nat_gateway_enabled = true
}

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

Viewing all VPC subnets

CLI

Use the networking vpc-subnets list commands to list existing subnets.

crusoe networking vpc-subnets list

UI

In order to view subnets via the Crusoe Cloud console:

• Visit the Crusoe Cloud console
• Click the "Network" tab in the left nav
• Click the "VPC subnets" tab
• Click on the specific subnet you wish to view for additional details

Terraform

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

# list vpc subnets
data "crusoe_vpc_subnets" "subnets" {}

output "crusoe_vpc_subnets" {
  value = data.crusoe_vpc_subnets.subnets
}

Update an existing VPC subnet

CLI

Non-default VPC subnets can be updated in the CLI using the networking vpc-subnets update <id> command. You may update the name, or enable / disable NAT Gateways on the subnet.

crusoe networking vpc-subnets update \
  --name my-new-vpc-subnet \
  --nat-gateway-enabled true/false

UI

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

• Visit the Crusoe Cloud console
• Click the "Network" tab in the left nav
• Click the "VPC Subnets" tab underneath the "Network" title
• Navigate to the row of the VPC subnet you wish to update
• Click the pencil icon on the far right side of the row
• Edit the fields you wish to modify
• Click on the "Update" button to save your changes

Terraform

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

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

...

resource "crusoe_vpc_subnet" "my_vpc_subnet" {
  name = "my-new-subnet" -> "my-new-name"
  cidr = "10.0.0.0/16"
  location = "us-northcentral1-a"
  network = crusoe_vpc_network.my_vpc_network.id
}

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

Deleting a VPC subnet

info

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

CLI

VPC subnets can be deleted in the CLI using the networking vpc-subnets delete <id> command.

UI

In order to delete a VPC subnet via the Crusoe Cloud console:

• Visit the Crusoe Cloud console
• Click the "Network" tab in the left nav
• Click the "VPC Subnets" tab underneath the "Network" title
• Navigate to the row of the VPC Subnet you wish to delete
• Click the trash can icon on the far right side of the row
• Click the "Confirm" button

Terraform

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

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