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

APPLIES TO: Azure Database for PostgreSQL - Flexible Server

Azure Database for PostgreSQL flexible server is a managed service that you can use to run, manage, and scale highly available PostgreSQL servers in the cloud. This quickstart shows you how to create an Azure Database for PostgreSQL flexible server instance in a virtual network by using the Azure portal.

If you don't have an Azure subscription, create a free Azure account before you begin.

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 PostgreSQL flexible server

You create an Azure Database for PostgreSQL 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 PostgreSQL flexible server instance:

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

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

  2. Select Add.

  1. On the Basics tab, enter the subscription, resource group, region, and server name. With the default values, this will provision an Azure Database for PostgreSQL flexible server instance of version 12 with General purpose pricing tier using 2 vCores, 8 GiB RAM, and 28 GiB storage. The backup retention is seven days. You can use Development workload to default to a lower-cost pricing tier.

    Screenshot that shows the Basics tab of the Azure Database for PostgreSQL flexible server page.

  2. In the Basics tab, enter a unique admin username and admin password.

    Screenshot that shows the admin user information page.

  3. Go to the Networking tab, and 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. Select OK once you have provided the virtual network name and subnet information.

    Screenshot that shows the Networking tab with new VNET.

  4. Select Review + create to review your Azure Database for PostgreSQL flexible server configuration.

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

  6. Wait until the deployment is complete and successful.

    Screenshot that shows deployment success.

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

Create an 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 an SSH tunnel to manage your Azure Database for PostgreSQL flexible server instance.

  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, and choose the same Region as your Azure Database for PostgreSQL flexible server instance.

    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 the Networking page to configure the virtual network. For the virtual network, choose the vnetenvironment1 created for the database server.

    Screenshot of select existing virtual network of the database server.

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

    Screenshot of manage subnet.

  11. Add the 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 will be downloaded as myKey.pem.

    Important

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

  15. When the deployment is finished, select Go to resource to view the virtual machine Overview page.

  16. Select the public IP address and copy it to your clipboard.

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

Install PostgreSQL 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. Just 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 the postgresql-client tool to be able to connect to the server.

sudo apt-get update
sudo apt-get install postgresql-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 psql client tool installed, we can now connect to the server from your local environment.

psql --host=mydemoserver-pg.postgres.database.azure.com --port=5432 --username=myadmin --dbname=postgres --set=sslmode=require --set=sslrootcert=DigiCertGlobalRootCA.crt.pem

Clean up resources

You have now created an Azure Database for PostgreSQL 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 you can just delete the Azure Database for PostgreSQL flexible server instance. To delete the resource group, complete the following steps:

  1. In the Azure portal, search for and select Resource groups.
  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