Connect Azure Database for MySQL - Flexible Server with private access connectivity method

APPLIES TO: Azure Database for MySQL - Flexible Server

Azure Database for MySQL flexible server is a managed service that runs, manages, and scales highly available MySQL servers in the cloud. This quickstart shows you how to create an Azure Database for MySQL flexible server instance in a virtual network by using the Azure portal.

If you don't have an Azure subscription, create an Azure free account before you begin. Currently, with an Azure free account, you can try Azure Database for MySQL - Flexible Server free for 12 months. For more information, see Try Azure Database for MySQL - Flexible Server for free.

Sign in to the Azure portal

Sign in to the Azure portal. Enter your credentials to sign in to the portal. The default view is your service dashboard.

Create an Azure Database for MySQL flexible server instance

You create an Azure Database for MySQL flexible server instance with a defined set of compute and storage resources. You create the server within an Azure resource group.

Complete these steps to create an Azure Database for MySQL flexible server instance:

  1. Search for and select Azure Database for MySQL servers in the portal:

    Screenshot that shows a search for Azure Database for MySQL servers.

  2. Select Add.

  3. On the Select Azure Database for MySQL deployment option page, select Flexible server as the deployment option:

    Screenshot that shows the Flexible server option.

  4. On the Basics tab, enter the subscription, resource group , region, administrator username and administrator password. With the default values, this provisions an Azure Database for MySQL flexible server instance of version 5.7 with Burstable Sku using 1 vCore, 2 GiB Memory, and 32 GiB storage. The backup retention is seven days. You can change the configuration.

    Screenshot that shows the Basics tab of the Flexible server page.

    Tip

    For faster data loads during migration, increasing the IOPS to the maximum size supported by computing the size and later scaling it back to save cost is recommended.

  5. Go to the Networking tab, select private access.You can't change the connectivity method after you create the server. Select Create virtual network to create a new virtual network vnetenvironment1.

    Screenshot that shows the Networking tab with new VNET.

  6. Select OK once you've provided the virtual network name and subnet information.

    Review VNET information

  7. Select Review + create to review your Azure Database for MySQL flexible server configuration.

  8. Select Create to provision the server. Provisioning can take a few minutes.

  9. Wait until the deployment is complete and successful.

    Screenshot that shows the Networking settings with new VNET.

  10. Select Go to resource to view the server's Overview page opens.

Create Azure Linux virtual machine

Since the server is in a virtual network, you can only connect to the server from other Azure services in the same virtual network as the server. To connect and manage the server, let's create a Linux virtual machine. The virtual machine must be created in the same region and same subscription. The Linux virtual machine can be used as SSH tunnel to manage your database server.

  1. Go to your resource group in which the server was created. Select Add.

  2. Select Ubuntu Server 18.04 LTS

  3. In the Basics tab, under Project details, make sure the correct subscription is selected and then choose to Create new resource group. Type myResourceGroup for the name.

    Screenshot of the Project details section showing where you select the Azure subscription and the resource group for the virtual machine.

  4. Under Instance details, type myVM for the Virtual machine name, choose the same Region as your database server.

    Screenshot of the Instance details section where you provide a name for the virtual machine and select its region, image and size.

  5. Under Administrator account, select SSH public key.

  6. In Username type azureuser.

  7. For SSH public key source, leave the default of Generate new key pair, and then type myKey for the Key pair name.

    Screenshot of the Administrator account section where you select an authentication type and provide the administrator credentials.

  8. Under Inbound port rules > Public inbound ports, choose Allow selected ports and then select SSH (22) and HTTP (80) from the drop-down.

    Screenshot of the inbound port rules section where you select what ports inbound connections are allowed on.

  9. Select Networking page to configure the virtual network. For the virtual network, choose the vnetenvironment1 created for the Azure Database for MySQL flexible server instance.

    Screenshot of the select existing virtual network of the Azure Database for MySQL flexible server instance.

  10. Select Manage subnet configuration to create a new subnet for the server.

    Screenshot of manage subnet.

  11. Add a new subnet for the virtual machine.

    Screenshot of adding a new subnet for virtual machine

  12. After the subnet has been created successfully, close the page.

    Screenshot of success with adding a new subnet for virtual machine

  13. Select Review + Create.

  14. Select Create. When the Generate new key pair window opens, select Download private key and create resource. Your key file is downloaded as myKey.pem.

    Important

    Make sure you know where the .pem file was downloaded, you need the path to it in the next step.

  15. When the deployment is finished, select Go to resource.

    Screenshot of deployment success.

  16. On the page for your new VM, select the public IP address and copy it to your clipboard.

    Screenshot showing how to copy the IP address for the virtual machine.

Install MySQL client tools

Create an SSH connection with the VM using Bash or PowerShell. At your prompt, open an SSH connection to your virtual machine. Replace the IP address with the one from your VM, and replace the path to the .pem with the path to where the key file was downloaded.

ssh -i .\Downloads\myKey1.pem azureuser@10.111.12.123

Tip

The SSH key you created can be used the next time you create a VM in Azure. Select the Use a key stored in Azure for SSH public key source the next time you create a VM. You already have the private key on your computer, so you won't need to download anything.

You need to install mysql-client tool to connect to the server.

sudo apt-get update
sudo apt-get install mysql-client

Connections to the database are enforced with SSL; hence you need to download the public SSL certificate.

wget --no-check-certificate https://dl.cacerts.digicert.com/DigiCertGlobalRootCA.crt.pem

Connect to the server from Azure Linux virtual machine

With the mysql.exe client tool installed, we can now connect to the server from your local environment.

mysql -h mydemoserver.mysql.database.azure.com -u mydemouser -p --ssl-mode=REQUIRED --ssl-ca=DigiCertGlobalRootCA.crt.pem

Clean up resources

You've created an Azure Database for MySQL flexible server instance in a resource group. If you don't expect to need these resources in the future, you can delete them by deleting the resource group or the Azure Database for MySQL flexible server instance. To delete the resource group, complete these steps:

  1. Search for and select Resource groupsin the Azure portal.
  2. In the list of resource groups, select the name of your resource group.
  3. In the Overview page for your resource group, select Delete resource group.
  4. In the confirmation dialog box, type the name of your resource group and then select Delete.

Next steps