vpc_id
Description
The vpc_id parameter specifies the ID of an existing VPC to use for cluster creation. When using this parameter, ensure that you also configure the cidr block and internet_gateway_id.
Default Value
The default value for vpc_id is "". When set to "", Convox will create a new VPC for the cluster.
Use Cases
- Existing VPC Integration: Use this parameter to integrate your Convox rack with an existing VPC.
- Custom Network Configuration: Specify an existing VPC to meet specific network requirements and configurations.
Setting Parameters
The vpc_id parameter must be configured at rack installation. Example:
| Key | Value |
|---|---|
vpc_id |
vpc-12345678 |
Additional Information
When configuring the vpc_id parameter, ensure that you also set the cidr block and internet_gateway_id parameters. Without subnet lists, Convox creates its subnets and route tables inside this VPC from the cidr range, plus NAT gateways when private is true. With private_subnets_ids and public_subnets_ids, Convox uses those subnets and creates no subnets, NAT gateways, internet gateway or route tables. Proper configuration of these parameters is essential for integrating your Convox rack with an existing VPC and ensuring network connectivity and security.
Use vpc_id to deploy your Convox rack into existing network infrastructure and customize the VPC configuration.