Manage your subnets

Creating a new VPC subnet

CLI

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

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

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
• 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 :

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
}

"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

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. Currently, only the name of a non-default VPC subnet can be updated (using the --name flag).

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.