Deploy using the NGINXaaS Console
This guide explains how to deploy F5 NGINXaaS for Google Cloud (NGINXaaS) using Google Cloud Console and the NGINXaaS Console. The deployment process involves creating a new deployment, configuring the deployment, and testing the deployment.
Before you can deploy NGINXaaS, follow the steps in the Prerequisites topic to subscribe to the NGINXaaS for Google Cloud offering in the Google Cloud Marketplace.
NGINXaaS requires a network attachment to connect your consumer Virtual Private Cloud (VPC) network and your NGINXaaS deployment’s VPC network.
-
Access the Google Cloud Console.
-
Create a consumer VPC network and subnetwork. See Google’s documentation on creating a VPC and subnet for a step-by-step guide.
- The region you choose in this step must match the region where your NGINXaaS deployment will be created.
-
Create a network attachment in your new subnet that automatically accepts connections. See Google’s documentation on creating a network attachment for a step-by-step guide.
-
Make a note of the network attachment ID. You will need it in the next steps to create your NGINXaaS deployment.
NGINXaaS for Google Cloud currently supports the following regions:
NGINXaaS Geography Google Cloud Regions US us-west1, us-east1, us-central1 EU europe-west2, europe-west1
Once you have completed the subscription process and created a network attachment, you can access the NGINXaaS Console.
- Visit https://console.nginxaas.net/ to access the NGINXaaS Console.
- Log in to the console with your Google credentials.
- Select the appropriate Geography to work in, based on the region your network attachment was created in.
In the NGINXaaS Console,
-
On the left menu, select Configurations.
-
Select Add Configuration to add a new NGINX configuration.
-
You can either create a new configuration from scratch or copy an existing configuration:
- Select New configuration to create a new config.
- Provide a name for your configuration and an optional description.
- Change the configuration path if needed.
- Select to start with the “NGINXaaS Default” (a basic NGINX setup) or an empty configuration file.
- Select Next.
- Select Copy existing configuration to use one of the existing configuration files in your account as template.
- Provide a name for your configuration and an optional description.
- Change the configuration path if needed.
- Use the Choose configuration to copy list to select the configuration file you want to copy.
- Use the Choose configuration version to copy list to select the version of the configuration file you want to copy.
- Select Next.
- Select New configuration to create a new config.
-
Modify the configuration file as needed and select Save.
- You can import certificates using the Add file option.
Next, create a new NGINXaaS deployment using the NGINXaaS Console:
-
On the left menu, select Deployments.
-
Select Add Deployment to create a new deployment.
- Enter a Name.
- Add an optional description for your deployment.
- Change the NCU Capacity if needed.
- The default value of
20 NCU
should be adequate for most scenarios. - This value must be a multiple of
10
.
- The default value of
- In the Cloud Details section, enter the network attachment ID that you created earlier or select it in the Network attachment list.
- The network attachment ID is formatted like the following example:
projects/my-google-project/regions/us-east1/networkAttachments/my-network-attachment
.
- The network attachment ID is formatted like the following example:
- In the Apply Configuration section, select an NGINX configuration you created earlier from the Choose Configuration list.
- Select a Configuration Version from the list.
- Select Submit to begin the deployment process.
Your new deployment will appear in the list of deployments. The status of the deployment will be “Pending” while the deployment is being created. Once the deployment is complete, the status will change to “Ready”.
In the NGINXaaS Console,
- To open the details of your deployment, select its name from the list of deployments.
- You can view the details of your deployment, including the status, region, network attachment, NGINX configuration, and more.
- Select Edit to modify the deployment description, and NCU Capacity.
- You can also configure monitoring from here. Detailed instructions can be found in Enable Monitoring
- Select Update to save your changes.
- Select the Configuration tab to view the current NGINX configuration associated with the deployment.
- Select Update Configuration to change the NGINX configuration associated with the deployment.
- To modify the contents of the NGINX configuration, see Update an NGINX Configuration.
To set up connectivity to your NGINXaaS deployment, you will need to configure a Private Service Connect backend.
- Access the Google Cloud Console.
- Create a public IP address. See Google’s documentation on reserving a static address for a step-by-step guide.
- Create a Network Endpoint Group (NEG). See Google’s documentation on creating a NEG for a step-by-step guide.
- For Target service, enter your NGINXaaS deployment’s Service Attachment, which is visible on the
Deployment Details
section for your deployment. - For Producer port, enter the port your NGINX server is listening on. If you’re using the default NGINX config, enter port
80
. - For Network and Subnetwork select your consumer VPC network and subnet.
- For Target service, enter your NGINXaaS deployment’s Service Attachment, which is visible on the
- Create a proxy-only subnet in your consumer VPC. See Google’s documentation on creating a proxy-only subnet for a step-by-step guide.
- Create a regional external proxy Network Load Balancer. See Google’s documentation on configuring the load balancer for a step-by-step guide.
- For Network, select your consumer VPC network.
- For Backend configuration, follow Google’s step-by-step guide to add a backend.
- In the Frontend configuration section,
- For IP address, select the public IP address created earlier.
- For Port number, enter the same port as your NEG’s Producer port, for example, port
80
.
- To test your deployment, go to the IP address created in Set up connectivity to your deployment using your favorite web browser.