Skip to main content

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.

note

To use Transparent Data Encryption (TDE) or a customer-managed key for EBS encryption, create the warehouse with the Custom Infrastructure option instead. This template flow does 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​

  1. Sign in to the VeloDB Cloud console.

  2. 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 click Create New Warehouse on the Organization Overview page. Select BYOC (New VPC), then click Continue.

  3. On the Warehouse Configuration card, set:

    • Warehouse Name: 1 to 32 characters, using letters (case-insensitive), numbers, underscores (_), and hyphens (-).
    • 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: 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.
    • Optionally open Advanced Settings to add custom tags or set table-name case sensitivity.

    On the Initial Cluster card, set the initial compute and cache for the warehouse's first cluster.

  4. Click Create. A dialog titled Create BYOC Warehouse explains that after you click Start, the AWS CloudFormation console opens in a new tab with the required settings pre-filled. Creating the stack requires sufficient IAM permissions. Click Start.

  5. In the AWS CloudFormation console, review the pre-filled parameters and create the stack. For a new VPC, 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. If the AWS tab does not open, use Open AWS CloudFormation on the deployment page to reopen it.

  6. Return to the VeloDB Cloud console. The deployment page tracks progress through Cloud Resource Configuration, Agent Deployment, and Warehouse Initialization. Deploying the warehouse usually takes 5 to 10 minutes. If it takes more than 30 minutes, get help.

  7. When the deployment finishes, the warehouse is ready to use, including its initial cluster.