|
| 1 | += Add a Dedicated VPC Peering Connection |
| 2 | +:description: Use the Redpanda Cloud UI to set up VNet peering. |
| 3 | + |
| 4 | +When you deploy a Dedicated cluster, you have the option to select private networking. Virtual network (VNet) peering connects your Azure VNet to the Redpanda Cloud VPC, allowing them to communicate with each other as if they were within the same network. |
| 5 | + |
| 6 | +NOTE: With VNet peering, traffic is _not_ routed over the public internet. |
| 7 | + |
| 8 | +Because Azure does not allow you to initiate a peering against another tenant without having delegated access to that tenant, Redpanda must first create a multi-tenant Entra ID Enterprise application with a service principal attached to that application in Redpanda's tenant. The Redpanda Cloud UI provides this application ID. You must create a service principal on your tenant with that application ID, and attach a role to that service principal. Redpanda can then initiate the peering. |
| 9 | + |
| 10 | +Creating a VNet peering involves the following steps: |
| 11 | + |
| 12 | +. Create a peering connection in the Redpanda Cloud UI. |
| 13 | +. Create a service principal with the provided application ID in Azure Cloud Shell. |
| 14 | +. Assign a set of roles to the service principal in Azure Cloud Shell. |
| 15 | + |
| 16 | +== Prerequisites |
| 17 | + |
| 18 | +* *Azure VNet*: Before setting up a peering connection in the Redpanda Cloud UI, you must have an Azure VNet in your own account for Redpanda's VPC to connect to. |
| 19 | +* *Matching region*: Peering connections can only be established between networks created in the *same region*. Redpanda Cloud does not support inter-region peering connections. |
| 20 | +* *Non-overlapping CIDR blocks*: The CIDR block (address space) for your VNet cannot match or overlap with the CIDR block for the Redpanda Cloud VPC. |
| 21 | ++ |
| 22 | +TIP: Consider adding `rp` at the beginning of the VNet name to indicate that this VNet is for deploying a Redpanda cluster. |
| 23 | + |
| 24 | +== Create a peering connection in Redpanda Cloud |
| 25 | + |
| 26 | +To create a peering connection between your Azure VNet and Redpanda VPC: |
| 27 | + |
| 28 | +. In the Redpanda Cloud UI, go to the *Overview* page for your cluster. |
| 29 | +. In the Details section, click the name of the *Redpanda network*. |
| 30 | +. On the *Network* page for your cluster, click *+ Add peering connection*. |
| 31 | +. For *Connection name*, enter a name. For example, the name could refer to your Azure VNet ID. |
| 32 | +. For *Azure account number*, enter the account number associated with the VNet you want to connect to. |
| 33 | +. For *Azure VNet ID*, enter the VNet ID. |
| 34 | +. Click *Create peering connection*. |
| 35 | + |
| 36 | +NOTE: In the Redpanda Cloud UI, Redpanda provides the *application ID* for the multi-tenant application it created with a service principal attached to it in Redpanda's tenant. |
| 37 | + |
| 38 | +== Create a service principal in Azure Cloud Shell |
| 39 | + |
| 40 | +Create a service principal on your tenant tied to the *application ID*. This is public across tenants. |
| 41 | + |
| 42 | +In the Azure Cloud Shell: |
| 43 | + |
| 44 | +. Create a service principal with the provided application ID. |
| 45 | +. Assign a set of roles to the service principal. |
| 46 | ++ |
| 47 | +Redpanda creates the service principal with a role assignment that allows it Network Contributor access to the Redpanda tenant and subscription scoped to the cluster's network, but you may choose a custom role that is less broad, and scoped to your network. |
| 48 | ++ |
| 49 | +Example for Network Contributor role: |
| 50 | ++ |
| 51 | +```bash |
| 52 | +# Set environment variables. |
| 53 | +export RP_RESOURCE_GROUP_ID=<Retrieve resource group ID from Redpanda Cloud URL> |
| 54 | +export AZURE_VNET_ID=<Retrieve Azure VNET ID from Azure VNET UI> |
| 55 | + |
| 56 | +# Create service principal and get its ID. |
| 57 | +> spid=$(az ad sp create –id <application-id> --query "id" -o tsv |
| 58 | + |
| 59 | +# Assign the role to the service principal using the environment variables. |
| 60 | +# The assignee is the ID created above. |
| 61 | +> az role assignment create \ |
| 62 | + –-assignee $spid \ |
| 63 | + --role "Network Contributor" |
| 64 | + --scope /subscriptions/<subscription-id>/resourceGroups/$RP_RESOURCE_GROUP_ID/providers/Microsoft.Network/virtualNetworks/$AZURE_VNET_ID |
| 65 | +``` |
| 66 | ++ |
| 67 | +Example for custom role with scoped permissions for peering: |
| 68 | ++ |
| 69 | +```bash |
| 70 | +# Set environment variables. |
| 71 | +export RP_RESOURCE_GROUP_ID=<Retrieve resource group ID from Redpanda Cloud URL> |
| 72 | +export AZURE_VNET_ID=<Retrieve Azure VNET ID from Azure VNET UI> |
| 73 | + |
| 74 | +# Create service principal and get its ID. |
| 75 | +> spid=$(az ad sp create –id <application-id> --query "id" -o tsv) |
| 76 | + |
| 77 | +# Create custom role definition for Redpanda peering role and get its ID. |
| 78 | +> rdid=$(az role definition create --role-definition '{ |
| 79 | + "Name": "Redpanda Peering Role", |
| 80 | + "Description": "Peers networks to Redpanda networks.", |
| 81 | + "Actions": [ |
| 82 | +"Microsoft.Network/virtualNetworks/peer/action", |
| 83 | +"Microsoft.Network/virtualNetworks/virtualNetworkPeerings/read", |
| 84 | +"Microsoft.Network/virtualNetworks/virtualNetworkPeerings/write", |
| 85 | +"Microsoft.ClassicNetwork/virtualNetworks/peer/action”, |
| 86 | +"Microsoft.Network/virtualNetworks/virtualNetworkPeerings/delete" |
| 87 | + ], |
| 88 | + "AssignableScopes": ["/subscriptions/<subscription-id>/..."] |
| 89 | +}' --query "name" -o tsv) |
| 90 | + |
| 91 | +# Assign the role to the service principal using the environment variables. |
| 92 | +# The assignee is the ID created above. |
| 93 | +> az role assignment create \ |
| 94 | + --assignee $spid \ |
| 95 | + --role $rdid \ |
| 96 | + --scope /subscriptions/<subscription-id>/resourceGroups/$RP_RESOURCE_GROUP_ID/providers/Microsoft.Network/virtualNetworks/$AZURE_VNET_ID |
| 97 | +``` |
| 98 | + |
| 99 | +Redpanda polls with the application to try to access the customer tenant. When access is available, it initiates the peering API calls. After you create the service principal, the API calls use the application to create the peering on the Redpanda network and then the peering on the Azure network. |
0 commit comments