Merge pull request #1814 from aiven/dorota-mysql-create-read-replicas

1685 migrate aiven for mysql remote replica

_toc.yml

@@ -841,6 +841,8 @@ entries:
               - file: docs/products/mysql/howto/connect-with-java
               - file: docs/products/mysql/howto/connect-with-php
           - file: docs/products/mysql/howto/create-database
+          - file: docs/products/mysql/howto/create-remote-replica
+            title: Create remote replicas
           - file: docs/products/mysql/howto/connect-from-mysql-workbench
           - file: docs/products/mysql/howto/do-check-service-migration
             title: Run pre-migration checks

docs/products/mysql/howto/create-remote-replica.rst

@@ -0,0 +1,36 @@
+Create Aiven for MySQL® remote replicas
+=======================================
+
+Learn how to create an Aiven for MySQL® remote replica to provide a read-only instance of your managed MySQL service in another geographically-autonomous region.
+
+About remote replicas
+---------------------
+
+Aiven for MySQL read-only replicas provide a great way to reduce the load on the primary server by enabling read-only queries to be performed against the replica. It is also a good way to optimise query response times across different geographical locations since, with Aiven, the replica can be placed in different regions or even different cloud providers.
+
+Using read-only replicas works as an extra measure to protect your data from the unlikely event that a whole region would go down. It can also improve performance if a read replica is placed closer to your end-users that read from the database.
+
+Create a remote replica
+-----------------------
+
+Take the following steps to provision a remote replica:
+
+1. Log in to the `Aiven console <https://console.aiven.io/>`_  using your credentials.
+
+2. Navigate to Aiven for MySQL services for which you wish to create a remote replica.
+
+3. Select **Create a read replica**.
+
+.. image:: /images/products/mysql/mysql-create-read-only-replica.png
+   :alt: Start creating a read-only replica 
+
+4. For the remote replica, give your service a name, select the cloud provider and region, and choose a suitable Aiven for MySQL plan.
+
+5. Select **Create**.
+
+.. image:: /images/products/mysql/mysql-create-read-only-replica-choose-plan.png
+   :alt: Create read-only replica wizard
+
+.. topic:: Result
+
+   You can see the read replica being created and listed as any other Aiven service on the **Services** page in the console.