Skip to content

Conversation

rshyamsu
Copy link
Contributor

@rshyamsu rshyamsu commented Oct 14, 2025

Proposed changes

Checklist

Before sharing this pull request, I completed the following checklist:

Footnotes

  1. Potentially sensitive information includes personally identify information (PII), authentication credentials, and live URLs. Refer to the style guide for guidance about placeholder content.

@rshyamsu rshyamsu requested a review from a team as a code owner October 14, 2025 21:02
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Oct 14, 2025
@github-actions
Copy link

Deploy Preview will be available once build job completes!

Name Link
😎 Deploy Preview https://frontdoor-test-docs.nginx.com/previews/docs/1306/

@rshyamsu rshyamsu self-assigned this Oct 14, 2025
@mjang mjang requested a review from JTorreG October 16, 2025 13:11
Copy link
Contributor

@mjang mjang left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm personally good with this, but will leave it to @JTorreG to approve and merge

To set up connectivity to your NGINXaaS deployment, you will need to configure a [Private Service Connect backend](https://cloud.google.com/vpc/docs/private-service-connect-backends).

1. Access the [Google Cloud Console](https://console.cloud.google.com/).
1. Access the [Google Cloud Console](https://console.cloud.google.com/) and choose a project where you would like to create resources for connecting to your F5 NGINXaaS deployment.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Access the [Google Cloud Console](https://console.cloud.google.com/) and choose a project where you would like to create resources for connecting to your F5 NGINXaaS deployment.
1. Access the [Google Cloud Console](https://console.cloud.google.com/) and select the project where your networking resources for connecting to your F5 NGINXaaS deployment should be created.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(probably just my own personal word style -- didn't like the "where you would like to" verbiage, but feel free to resolve as really not important)

- For **Port number**, enter the same port as your NEG's Producer port, for example, port `80`.


If you have multiple ports configured on NGINX, you will have to create a new network endpoint group for every port. You can also automate these steps by using the following helper script:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you have multiple ports configured on NGINX, you will have to create a new network endpoint group for every port. You can also automate these steps by using the following helper script:
Each listening port configured on NGINX requires its own network endpoint group with a matching port. You can use the following helper script to automate these steps:

{{< details summary="Show helper script" >}}

```bash
#!/bin/bash
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should always apply set -eo pipefail in any bash scripts, otherwise poor error handling can lead to unexpected results.

I'd also suggest -u to ensure any expected env vars are set (set -euo pipefail)

Example:
$0 --project my-project --region us-central1 --network my-vpc \\
--service-attachment "projects/producer-proj/regions/us-central1 serviceAttachments/ my-service" \\
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

there are some interesting white-spaces added in this example. intentional?

Suggested change
--service-attachment "projects/producer-proj/regions/us-central1 serviceAttachments/ my-service" \\
--service-attachment "projects/producer-proj/regions/us-central1/serviceAttachments/sa-aa4c6965-4b03-4518-85ea-2ca6fc2e869c" \\

Comment on lines +180 to +182
# Set auto-generated proxy subnet name and VIP name
PROXY_SUBNET="psc-proxy-subnet"
VIPNAME="psc-vip"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: move these up to the top with the other default env vars. even though there isn't a command line flag to modify them right now, a user might want to just change what is hardcoded and it's easier to find at the top

- For **Port number**, enter the same port as your NEG's Producer port, for example, port `80`.


If you have multiple ports configured on NGINX, you will have to create a new network endpoint group for every port. You can also automate these steps by using the following helper script:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you have multiple ports configured on NGINX, you will have to create a new network endpoint group for every port. You can also automate these steps by using the following helper script:
Each listening port configured on NGINX requires its own network endpoint group with a matching port. You can use the following helper script to automate these steps:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants