Quick and practical tips to help users optimize tasks, improve skills, and solve common problems effectively across various areas like tech, lifestyle, productivity, and more.
ePlus.DEV - Exploring Technology with David Nguyen
1278 posts
A passionate full-stack developer from VIETNAM.
Overview
In this lab, you configure a Cloud SQL server and learn how to connect an application to it via a proxy over an external connection. You also configure a connection over a Private IP link that offers performance and security benefits. The app we chose to demonstrate in this lab is Wordpress, but the information and best practices are applicable to any application that needs SQL Server.
By the end of this lab, you will have 2 working instances of the Wordpress frontend connected over 2 different connection types to their SQL instance backend, as shown in this diagram:
Objectives
In this lab, you learn how to perform the following tasks:
Create a Cloud SQL database
Configure a virtual machine to run a proxy
Create a connection between an application and Cloud SQL
Connect an application to Cloud SQL using Private IP address
Setup
For each lab, you get a new Google Cloud project and set of resources for a fixed time at no cost.
Sign in to Qwiklabs using an incognito window.
Note the lab's access time (for example, 1:15:00), and make sure you can finish within that time. There is no pause feature. You can restart if needed, but you have to start at the beginning.
When ready, click Start lab.
Note your lab credentials (Username and Password). You will use them to sign in to the Google Cloud Console.
Click Open Google Console.
Click Use another account and copy/paste credentials for this lab into the prompts. If you use other credentials, you'll receive errors or incur charges.
Accept the terms and skip the recovery resource page.
Task 1. Create a Cloud SQL database
In this task, you configure a SQL server according to Google Cloud best practices and create a Private IP connection.
On the Navigation menu (
), click SQL.
Note: If pop-up appears to explore the Gemini in Databases click DISMISS.
Click Create instance.
Click Choose MySQL.
Specify the following, and leave the remaining settings as their defaults:
Property
Value
Instance ID
wordpress-db
Root password
type a password
Choose a Cloud SQL edition
Enterprise
Region
us-west1
Zone
Any
Database Version
MySQL 5.7
Note: Note the root password; it will be used in a later step and referred to as [ROOT_PASSWORD].
Expand Show configuration options.
Expand the Machine configuartion section.
Provision the right amount of vCPU and memory. To choose a Machine configuration, click the dropdown menu, and then explore your options.
Note: A few points to consider:
Shared-core machines are good for prototyping, and are not covered by Cloud SLA.
Each vCPU is subject to a 250 MB/s network throughput cap for peak performance. Each additional core increases the network cap, up to a theoretical maximum of 2000 MB/s.
For performance-sensitive workloads such as online transaction processing (OLTP), a general guideline is to ensure that your instance has enough memory to contain the entire working set and accommodate the number of active connections.
For this lab, select Dedicated core from the dropdown menu, and then select 1 vCPU, 3.75 GB.
Next, expand the Storage section and then choose Storage type and Storage capacity.
Note: A few points to consider:
SSD (solid-state drive) is the best choice for most use cases. HDD (hard-disk drive) offers lower performance, but storage costs are significantly reduced, so HDD may be preferable for storing data that is infrequently accessed and does not require very low latency.
There is a direct relationship between the storage capacity and its throughput.
Click each of the capacity options to see how it affects the throughput. Reset the option to 10GB.
Note: Setting your storage capacity too low without enabling an automatic storage increase can cause your instance to lose its SLA.
Expand the Connections section.
Select Private IP.
In the Network dropdown, select default.
Click the Set up Connection button that appears.
In the panel to the right, click Enable API, click Use an automatically allocated IP range, click Continue, and then click Create Connection.
Click Create Instance at the bottom of the page to create the database instance.
Note: You might have to wait for the Private IP changes to propagate before the Create button becomes clickable.
Click Check my progress to verify the objective.
Create a Cloud SQL instance
Check my progress
Task 2. Configure a proxy on a virtual machine
When your application does not reside in the same VPC connected network and region as your Cloud SQL instance, use a proxy to secure its external connection.
In order to configure the proxy, you need the Cloud SQL instance connection name.
Note: The lab comes with 2 virtual machines preconfigured with Wordpress and its dependencies. You can view the startup script and service account access by clicking on a virtual machine name. Notice that we used the principle of least privilege and only allow SQL access for that VM. There's also a network tag and a firewall preconfigured to allow port 80 from any host.
On the Navigation menu () click Compute Engine.
Click SSH next to wordpress-proxy.
Download the Cloud SQL Proxy and make it executable:
In order to start the proxy, you need the connection name of the Cloud SQL instance. Keep your SSH window open and return to the Cloud Console.
On the Navigation menu (), click SQL.
Click on the wordpress-db instance and wait for a green checkmark next to its name, which indicates that it is operational (this could take a couple of minutes).
Note the connection name it will be used later and referred to as [SQL_CONNECTION_NAME].
In addition, for the application to work, you need to create a table. Click Databases.
Click Create database, type wordpress, which is the name the application expects, and then click Create.
Return to the SSH window and save the connection name in an environment variable, replacing [SQL_CONNECTION_NAME] with the unique name you copied in a previous step:
export SQL_CONNECTION=[SQL_CONNECTION_NAME]
To verify that the environment variable is set, run:
echo $SQL_CONNECTION
The connection name should be printed out.
To activate the proxy connection to your Cloud SQL database and send the process to the background, run the following command:
Listeningon127.0.0.1:3306 for [SQL_CONNECTION_NAME]Ready for new connections
Press ENTER.
Note: The proxy will listen on 127.0.0.1:3306 (localhost) and proxy that connects securely to your Cloud SQL over a secure tunnel using the machine's external IP address.
Click Check my progress to verify the objective.
Create a database and configure a proxy on a Virtual Machine
Check my progress
Task 3. Connect an application to the Cloud SQL instance
In this task, you will connect a sample application to the Cloud SQL instance.
Configure the Wordpress application. To find the external IP address of your virtual machine, query its metadata:
Go to the wordpress-proxy external IP address in your browser and configure the Wordpress application.
Click Let's Go.
Specify the following, replacing [ROOT_PASSWORD] with the password you configured upon machine creation, and leave the remaining settings as their defaults:
Property
Value
Database Name
wordpress
Username
root
Password
[ROOT_PASSWORD]
Database Host
127.0.0.1
Note: You are using 127.0.0.1, localhost as the Database IP because the proxy you initiated listens on this address and redirects that traffic to your SQL server securely.
Click Submit.
When a connection has been made, click Run the installation to instantiate Wordpress and its database in your Cloud SQL. This might take a few moments to complete.
Populate your demo site's information with random information and click Install Wordpress. You won't have to remember or use these details.
Note: Installing Wordpress might take up to 3 minutes, because it propagates all its data to your SQL Server.
When a 'Success!' window appears, remove the text after the IP address in your web browser's address bar and press ENTER. You'll be presented with a working Wordpress Blog!
Task 4. Connect to Cloud SQL via internal IP
If you can host your application in the same region and VPC connected network as your Cloud SQL, you can leverage a more secure and performant configuration using Private IP.
By using Private IP, you will increase performance by reducing latency and minimize the attack surface of your Cloud SQL instance because you can communicate with it exclusively over internal IPs.
In the Cloud Console, on the Navigation menu (
), click SQL.
Click wordpress-db.
Note the Private IP address of the Cloud SQL server; it will be referred to as [SQL_PRIVATE_IP].
On the Navigation menu, click Compute Engine.
Note: Notice that wordpress-private-ip is located at us-west1, where your Cloud SQL is located, which enables you to leverage a more secure connection.
Copy the external IP address of wordpress-private-ip, paste it in a browser window, and press ENTER.
Click Let's Go.
Specify the following, and leave the remaining settings as their defaults:
Property
Value
Database Name
wordpress
Username
root
Password
type the [ROOT_PASSWORD] configured when the Cloud SQL instance was created
Database Host
[SQL_PRIVATE_IP]
Click Submit.
Note: Notice that this time you are creating a direct connection to a Private IP, instead of configuring a proxy. That connection is private, which means that it doesn't egress to the internet and therefore benefits from better performance and security.
Click Run the installation. An 'Already Installed!' window is displayed, which means that your application is connected to the Cloud SQL server over private IP.
In your web browser's address bar, remove the text after the IP address and press ENTER. You'll be presented with a working Wordpress Blog!
Task 5. Review
In this lab, you created a Cloud SQL database and configured it to use both an external connection over a secure proxy and a Private IP address, which is more secure and performant. Remember that you can only connect via Private IP if the application and the Cloud SQL server are collocated in the same region and are part of the same VPC network. If your application is hosted in another region, VPC, or even project, use a proxy to secure its connection over the external connection.
