Choose one of the following setups based on the security requirements of your company and your existing infrastructure.Documentation Index
Fetch the complete documentation index at: https://astronomer-preview.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
This connection option is only available for dedicated Astro clusters.
Prerequisites
- An external VPC on AWS
- A CIDR block for your external VPC in the RFC 1918 range
- Organization Owner permissions
Setup
To set up a private connection between an Astro VPC and an AWS VPC, you can create a VPC peering connection. VPC peering ensures private and secure connectivity, reduces network transit costs, and simplifies network layouts.-
Open the AWS console of the AWS account with the external VPC and copy the following:
- AWS account ID
- AWS region
- VPC ID of the external VPC
- CIDR block of the external VPC
- In the Astro UI, click Organization Settings, then click Clusters, select your cluster, click VPC Peering Connections, then click + VPC Peering Connection.
-
Configure the following values for your VPC peering connection using the information you copied in Step 1:
- Peering Name: Provide a name for the VPC peering connection.
- AWS account ID: Enter the account ID of the external VPC.
- Destination VPC ID: Enter the VPC ID.
- Destination VPC region: Enter the region of the external VPC.
- Destination VPC CIDR block: Enter the CIDR block of the external VPC.
- Click Create Connection. The connection appears as Pending.
- Wait a few minutes for the Complete Activation button to appear, then click Complete Activation link.
- In the modal that appears, follow the instructions to accept the connection from your external VPC and create routes from the external VPC to Astro.
Troubleshooting VPC connection statusesAstro might show additional information in your connection status if it has an issue when it creates the connection. The following are all possible connection statuses.
- Pending (Without Complete Activation): Astro is sending the peering request to the external VPC. Wait 1-2 minutes for request to be created and sent.
- Pending (With Complete Activation): The peering connection request has been created and sent. Click Complete Activation to finish the setup.
- Active: The peering connection was successfully created and accepted.
- Failed: The peering connection request was rejected. Delete the failed connection and retry using a new connection configuration. If you don’t delete the failed connection, Astro will retry creating the peering request whenever you create a new VPC connection.
- Not Found: Astro failed to create the peering request. Wait 5 minutes for Astro to retry. If the status hasn’t changed after 5 minutes, delete the connection and retry using a new connection configuration.
Configure additional routes for a VPC connection
Your initial VPC connection connects Astro to your external VPC through a primary CIDR block. To connect Astro to other data services or systems within the external VPC, you can create additional routes to secondary CIDR blocks or subnets within the primary CIDR block. You can also complete this setup if you recently configured a new service in your external VPC and want to connect it with Astro without updating your base VPC connection.- Open the Routes tab, then click + Route.
-
Configure the following details for your route:
- Route ID: Provide a name for the route.
- Destination: Enter the subnet of the service in the external VPC.
- Target: Select the VPC peering connection you configured.
- Click Create Route, then wait a few minutes for the route to be created.