Skip to content

feat: add detailed steps for PostgreSQL mirroring with network isolation enabled#158

Open
Harmanpreet-Microsoft wants to merge 2 commits into
microsoft:devfrom
Saswato-Microsoft:postgreswafaddition
Open

feat: add detailed steps for PostgreSQL mirroring with network isolation enabled#158
Harmanpreet-Microsoft wants to merge 2 commits into
microsoft:devfrom
Saswato-Microsoft:postgreswafaddition

Conversation

@Harmanpreet-Microsoft
Copy link
Copy Markdown
Contributor

Purpose

This pull request adds detailed documentation for deploying PostgreSQL mirroring in a network-isolated environment. The new section provides step-by-step instructions for setting up and connecting to a PostgreSQL instance when both Key Vault and PostgreSQL are behind private endpoints, using a VNet-connected jumpbox and a Fabric VNet Data Gateway.

Key additions and improvements:

Network Isolation Deployment Instructions:

  • Added a comprehensive guide for scenarios where postgreSqlNetworkIsolation = true, including recommended deployment parameters and a step-by-step process for connecting securely via a jumpbox VM.

Jumpbox Setup:

  • Included instructions for installing required tools (Azure CLI, PostgreSQL client, Visual C++ Runtime) on the jumpbox VM to enable secure operations from within the VNet.

Database Preparation:

  • Provided PowerShell commands for retrieving the PostgreSQL admin password from Key Vault, creating the seed table, and verifying configuration such as wal_level.

Fabric VNet Gateway Configuration:

  • Added steps for creating a delegated subnet, deploying a Virtual Network Data Gateway in Fabric, and connecting it to PostgreSQL using the gateway.

Automation Support:

  • Documented how to persist the Fabric VNet gateway ID for use in future automated deployments.
  • ...

Does this introduce a breaking change?

  • Yes
  • No

Golden Path Validation

  • I have tested the primary workflows (the "golden path") to ensure they function correctly without errors.

Deployment Validation

  • I have validated the deployment process successfully and all services are running as expected with this change.

What to Check

Verify that the following are valid

  • ...

Other Information

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new, step-by-step documentation section covering PostgreSQL mirroring when postgreSqlNetworkIsolation = true, focusing on performing setup from a VNet-connected jumpbox VM and connecting Fabric via a VNet Data Gateway.

Changes:

  • Documented jumpbox access and prerequisite tooling installation (Azure CLI, psql, VC++ runtime).
  • Added PowerShell steps for retrieving credentials, creating a seed table, and validating wal_level.
  • Added Fabric VNet Data Gateway subnet creation, gateway setup, connection creation, and capturing the gateway ID for automation.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/postgresql_mirroring.md
Comment thread docs/postgresql_mirroring.md
Comment thread docs/postgresql_mirroring.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants