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

{{< 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)

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`.


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:
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
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:
Each listening port configured on NGINXaaS requires its own network endpoint group with a matching port. You can use the following helper script to automate these steps:

it's a nit but let's talk in terms of the service rather than what it has underneath.

Copy link
Contributor

Choose a reason for hiding this comment

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

separately, let's be specific about the type of NEG, PSC NEG to avoid confusion as there are various types of NEGs in GCP.

--purpose=REGIONAL_MANAGED_PROXY \
--role=ACTIVE
echo "Created proxy-only subnet: $PROXY_SUBNET"
else
Copy link
Contributor

@puneetsarna puneetsarna Oct 24, 2025

Choose a reason for hiding this comment

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

you can safely drop this and just state that you are using the subnet whether it exists or was just created.

or we fix up the rest of the script with this if-else logic to stay consistent.

exit 1
fi
# Create proxy-only subnet (skip if exists)
Copy link
Contributor

Choose a reason for hiding this comment

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

this statement can be echoed out instead of being a comment. The comment applies throughout the script where you do so.

gcloud compute addresses create $VIPNAME --region=$REGION --project=$PROJECT --network-tier=PREMIUM
fi
VIP=$(gcloud compute addresses describe $VIPNAME --region=$REGION --project=$PROJECT --format='get(address)')
echo "Using VIP address: $VIP"
Copy link
Contributor

Choose a reason for hiding this comment

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

is this a VIP or a static public IP that you are reserving on Google?

# Create regional VIP address (skip if exists)
echo "Creating regional VIP address..."
if ! gcloud compute addresses describe $VIPNAME --region=$REGION --project=$PROJECT >/dev/null 2>&1; then
gcloud compute addresses create $VIPNAME --region=$REGION --project=$PROJECT --network-tier=PREMIUM
Copy link
Contributor

Choose a reason for hiding this comment

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

--network-tier=PREMIUM I don't think it needs to be premium?

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.

5 participants