upcloud fixes

docs/platform/howto/manage-org-vpc-peering-google.md

@@ -11,6 +11,9 @@ import TabItem from '@theme/TabItem';
 
 Set up a peering connection between your Aiven project VPC and a Google Cloud VPC.
 
+Establishing a peering connection between an Aiven VPC and a Google Cloud VPC requires
+creating the peering both from the VPC in Aiven and from the VPC in Google Cloud.
+
 ## Prerequisites
 
 - [Manage organization networking](/docs/platform/concepts/permissions#organization-permissions)
@@ -23,11 +26,11 @@ Set up a peering connection between your Aiven project VPC and a Google Cloud VP
 
 ## Create a peering connection
 
-### Collect data in the Google Cloud console
+### Collect data from Google Cloud
 
 <CollectDataGoogle/>
 
-### Create a peering in Aiven
+### Create the peering in Aiven
 
 Create an organization VPC peering connection in the [Aiven Console](https://console.aiven.io/):
 
@@ -49,7 +52,7 @@ Create an organization VPC peering connection in the [Aiven Console](https://con
 1. Click <ConsoleLabel name="service settings"/> in the sidebar, and make a note of your
    **Project name** in the **Project settings** field.
 
-### Accept the peering request in the Google Cloud console
+### Create the peering in Google Cloud
 
 <AcceptPeeringGoogle/>
 

docs/platform/howto/manage-org-vpc-peering-upcloud.md

@@ -5,13 +5,37 @@ sidebar_label: UpCloud peering
 
 import CollectDataUpcloud from "@site/static/includes/vpc/collect-data-upcloud.md";
 import AcceptPeeringUpcloud from "@site/static/includes/vpc/accept-peering-upcloud.md";
+import RenewLeaseUpcloud from "@site/static/includes/vpc/renew-lease-upcloud.md";
 import ConsoleLabel from "@site/src/components/non-swizzled/ConsoleIcons";
 
 Set up a peering connection between your Aiven organization VPC and an UpCloud SDN network.
 
 Establishing a peering connection between an Aiven VPC and an UpCloud SDN network requires
 creating the peering both from the VPC in Aiven and from the SDN network in UpCloud.
 
+- Setting up the peering from Aiven to UpCloud in the
+  [Aiven Console](https://console.aiven.io/) requires the UpCloud SDN network UUID.
+  To find it, you can use either the [UpCloud Control Panel](https://hub.upcloud.com/)
+  or the [UpCloud API](https://developers.upcloud.com/1.3/).
+- Setting up the peering from UpCloud to Aiven is possible either in the
+  [UpCloud Control Panel](https://hub.upcloud.com/) or through the
+  [UpCloud API](https://developers.upcloud.com/1.3/).
+
+## Limitations
+
+-   Peering connections are only supported between networks of type
+    `private`.
+-   You cannot initiate a peering between two networks with overlapping
+    CIDR ranges.
+-   The networks to be peered need to be in the same cloud zone.
+
+:::important
+Make sure you only create peerings between accounts, platforms, or
+networks you trust. There is no limit on what traffic can flow between
+the peered components. The server firewall has no effect on `private`
+type networks.
+:::
+
 ## Prerequisites
 
 - [Manage organization networking](/docs/platform/concepts/permissions#organization-permissions)
@@ -37,16 +61,23 @@ Create an organization VPC peering connection in the [Aiven Console](https://con
    top navigation bar.
 1. Click <ConsoleLabel name="organizationvpcs"/> in the sidebar.
 1. On the **Organization VPCs** page, select an organization VPC to peer.
-1. On the **Organization VPC details** page, click **Add peering connection**.
-1. In the **Add peering connection** window:
-   1. Enter your UpCloud SDN network UUID in the **Peer network ID** field.
+1. On the **Organization VPC details** page, go to the **VPC peering connection** field and
+   click **Add peering connection**.
+1. In the **Add peering connection** window.
+   1. Enter your UpCloud SDN network UUID in the **UpCloud Network UUID** field.
    1. Click **Add peering connection**.
 
-This adds a connection in the **Pending peer** state to the VPC peering connections
-list in the [Aiven Console](https://console.aiven.io/). At this point, the Aiven VPC
-network UUID should be available in the **Aiven network ID** column of the VPC peering
-connections table.
+      This adds a connection with the **Pending peer** status in the
+      [Aiven Console](https://console.aiven.io/).
+
+1. While still on the **Organization VPC details** page, make a note of the ID of your
+   Aiven VPC available in the **Aiven network ID** column of the VPC peering connections
+   table.
 
 ### Create the peering in UpCloud
 
 <AcceptPeeringUpcloud/>
+
+## Renew a DHCP lease
+
+<RenewLeaseUpcloud/>

docs/platform/howto/vpc-peering-gcp.md

@@ -9,6 +9,9 @@ import ConsoleLabel from "@site/src/components/non-swizzled/ConsoleIcons";
 
 Set up a peering connection between your Aiven project VPC and a Google Cloud VPC.
 
+Establishing a peering connection between an Aiven VPC and a Google Cloud VPC requires
+creating the peering both from the VPC in Aiven and from the VPC in Google Cloud.
+
 ## Prerequisites
 
 - [Manage project networking](/docs/platform/concepts/permissions#project-permissions)
@@ -21,11 +24,11 @@ Set up a peering connection between your Aiven project VPC and a Google Cloud VP
 
 ## Create a peering connection
 
-### Collect data in the the Google Cloud console
+### Collect data from Google Cloud
 
 <CollectDataGoogle/>
 
-### Create a peering in Aiven
+### Create the peering in Aiven
 
 Create a project VPC peering connection in the [Aiven Console](https://console.aiven.io/):
 
@@ -46,7 +49,7 @@ Create a project VPC peering connection in the [Aiven Console](https://console.a
 1. Click <ConsoleLabel name="service settings"/> in the sidebar, and make a note of your
    **Project name** in the **Project settings** field.
 
-### Accept the peering request in the Google Cloud console
+### Create the peering in Google Cloud
 
 <AcceptPeeringGoogle/>
 

docs/platform/howto/vpc-peering-upcloud.md

@@ -5,21 +5,21 @@ sidebar_label: UpCloud peering
 
 import CollectDataUpcloud from "@site/static/includes/vpc/collect-data-upcloud.md";
 import AcceptPeeringUpcloud from "@site/static/includes/vpc/accept-peering-upcloud.md";
+import RenewLeaseUpcloud from "@site/static/includes/vpc/renew-lease-upcloud.md";
 import ConsoleLabel from "@site/src/components/non-swizzled/ConsoleIcons";
 
-Set up a peering connection between your Aiven project VPC and an UpCloud SDN network to enable traffic between them.
+Set up a peering connection between your Aiven project VPC and an UpCloud SDN network.
 
 Establishing a peering connection between an Aiven VPC and an UpCloud SDN network requires
 creating the peering both from the VPC in Aiven and from the SDN network in UpCloud.
 
--   To set up a peering from Aiven to UpCloud, you can use [Aiven
-    Console](https://console.aiven.io/) to create a VPC for your Aiven
-    project and add a peering connection to UpCloud. For this purpose,
-    identify the UpCloud SDN network UUID first.
--   To set up a peering from UpCloud to Aiven, you can use [UpCloud
-    API](https://developers.upcloud.com/1.3/). Since the API takes UUIDs
-    of both networks as attributes, identify the network
-    UUIDs before calling the API.
+- Setting up the peering from Aiven to UpCloud in the
+  [Aiven Console](https://console.aiven.io/) requires the UpCloud SDN network UUID.
+  To find it, you can use either the [UpCloud Control Panel](https://hub.upcloud.com/)
+  or the [UpCloud API](https://developers.upcloud.com/1.3/).
+- Setting up the peering from UpCloud to Aiven is possible either in the
+  [UpCloud Control Panel](https://hub.upcloud.com/) or through the
+  [UpCloud API](https://developers.upcloud.com/1.3/).
 
 ## Limitations
 
@@ -60,46 +60,25 @@ Create a project VPC peering connection in the [Aiven Console](https://console.a
 1. Log in to the [Aiven Console](https://console.aiven.io/), and go to your project page.
 1. Click <ConsoleLabel name="vpcs"/> in the sidebar.
 1. On the **Virtual private clouds** page, select a project VPC to peer.
-1. On the **VPC peering connections** page:
-   1. Enter your UpCloud SDN network UUID in the **Peer network ID** field.
+1. On the **VPC details** page, go to the **VPC peering connection** field and click
+   **Add peering connection**.
+1. In the **Add peering connection** window:
+   1. Enter your UpCloud SDN network UUID in the **UpCloud Network UUID** field.
    1. Click **Add peering connection**.
 
-This adds a connection in the **Pending peer** state to the VPC peering connections
-list in the [Aiven Console](https://console.aiven.io/). At this point, the Aiven VPC
-network UUID should be available in the **Aiven network ID** column of the VPC peering
-connections table.
+      This adds a connection with the **Pending peer** status in the
+      [Aiven Console](https://console.aiven.io/).
+
+1. While still on the **VPC details** page, make a note of the ID of your Aiven VPC
+   available in the **Aiven network ID** column of the VPC peering connections table.
 
 ### Create the peering in UpCloud
 
 <AcceptPeeringUpcloud/>
 
 ## Renew a DHCP lease
 
-You only need to take this step if any of your VMs has been created
-before setting up the network peering. In this case, refresh
-the Dynamic Host Configuration Protocol (DHCP) lease for a relevant
-network interface to get new routes.
-
-:::warning
-A peering connection between an Aiven VPC and VMs created before the
-peering setup won't work unless you refresh the DHCP lease for a
-relevant network interface.
-:::
-
-To refresh the DHCP lease for a network interface, run the following
-commands:
-
-1.  To clear the existing DHCP lease
-
-    ```bash
-    dhclient -r NETWORK_INTERFACE_NAME
-    ```
-
-1.  To request a renewal of the DHCP lease
-
-    ```bash
-    dhclient NETWORK_INTERFACE_NAME
-    ```
+<RenewLeaseUpcloud/>
 
 ## Related pages
 

static/includes/vpc/accept-peering-upcloud.md

@@ -9,8 +9,11 @@ To create the VPC peering connection in UpCloud, use either the
 <TabItem value="gui" label="UpCloud Control Panel" default>
 1. Log in to the [UpCloud Control Panel](https://hub.upcloud.com/), and go to **Network** >
    **Peering**.
-1. Click **Create network peering**, specify the peering name, select the source peer
-   network, provide the UUID of the target peer network, and click **Create**.
+1. Click **Create network peering**, and in the **Create network peering** window:
+   1. Specify the peering name.
+   1. Select the source peer network (your UpCloud SDN network).
+   1. Provide the UUID of the target peer network (the ID of your Aiven VPC).
+   1. Click **Create**.
 
 This creates the peering connection between your Aiven VPC and your UpCloud SDN network.
 

static/includes/vpc/renew-lease-upcloud.md

@@ -0,0 +1,25 @@
+You only need to take this step if any of your VMs has been created
+before setting up the network peering. In this case, refresh
+the Dynamic Host Configuration Protocol (DHCP) lease for a relevant
+network interface to get new routes.
+
+:::warning
+A peering connection between an Aiven VPC and VMs created before the
+peering setup won't work unless you refresh the DHCP lease for a
+relevant network interface.
+:::
+
+To refresh the DHCP lease for a network interface, run the following
+commands:
+
+1.  To clear the existing DHCP lease
+
+    ```bash
+    dhclient -r NETWORK_INTERFACE_NAME
+    ```
+
+1.  To request a renewal of the DHCP lease
+
+    ```bash
+    dhclient NETWORK_INTERFACE_NAME
+    ```