Deploy in a New VPC
With the New VPC option, you run a VeloDB-provided CloudFormation template in your own AWS account. The template creates a new VPC and all the other resources the warehouse needs, so this is the fastest way to create your first BYOC warehouse on AWS.
To use Transparent Data Encryption (TDE) or customer-managed keys for EBS encryption, create the warehouse with the Custom Infrastructure option instead. The New VPC and Existing VPC template flows do not support customer-managed encryption keys.
Prerequisites
Because you run the template yourself, you need an AWS account with sufficient IAM permissions to create a CloudFormation stack. If you lack these permissions, you can copy the CloudFormation URL and send it to your AWS administrator.
Steps
-
Sign in to the VeloDB Cloud console.
-
At the top of the console, open the warehouse menu (All Warehouses, or the current warehouse name) and click Create New Warehouse. You can also open the Organization Overview page and click Create New Warehouse.
-
Select BYOC (New VPC), then click Continue.
-
On the Warehouse Configuration and Initial Cluster cards, set the fields below.
| Field | Description |
|---|---|
| Warehouse Name | Required. Up to 32 characters: letters, numbers, underscores (_), and hyphens (-). The name must be unique within the organization. |
| Cloud Platform | AWS. |
| Region | The AWS region where the warehouse will run. |
| Core Version | The VeloDB Core version to run. A default is preselected. |
| Admin Password | Required. The password for the default admin user. Use at least 8 characters, including at least three of: uppercase letters, lowercase letters, numbers, and special characters. You can reset it later from the warehouse settings page. |
Advanced Settings
| Field | Description |
|---|---|
| Custom Tags | Optional. Add custom tags to the cloud resources VeloDB Cloud creates for the warehouse. |
| Table Name Case Sensitivity | Choose whether table names are case-sensitive. This setting cannot be changed after the warehouse is created. |
Initial Cluster
| Field | Description |
|---|---|
| Compute | The compute size of the warehouse's first cluster. The default range is 4 to 1024 vCPU per cluster at a fixed 1:8 vCPU-to-memory ratio. To raise this quota, get help. |
| Cache | The cache-space limit scales with the compute size. |
-
Click Create. In the Create BYOC Warehouse dialog, click Start.
-
The AWS CloudFormation console opens in a new tab, with the settings pre-filled. If the tab does not open, click Open AWS CloudFormation on the deployment page.
-
In the CloudFormation console, do not change any parameters. Select the acknowledgment checkbox, then click Create stack.
-
Wait for the stack to finish. If your IAM permissions are insufficient, CloudFormation reports an error. The template creates the VPC, subnets, a NAT gateway, security groups, IAM roles, an S3 bucket, a VPC endpoint to VeloDB Cloud, and the agent instance.
-
Return to the VeloDB Cloud console. The deployment page shows progress through Cloud Resource Configuration, Agent Deployment, and Warehouse Initialization. This usually takes 5 to 10 minutes. If it takes more than 30 minutes, get help.
-
When the deployment finishes, the warehouse is ready to use, including its initial cluster.
Related documentation
- Deploy in an Existing VPC: run the same template into a VPC you already have.
- Custom Infrastructure: provide and manage the infrastructure yourself, and use customer-managed encryption keys.
- Warehouse Settings: manage the warehouse, including tags, after creation.