mmckechney · mmckechney · Mar 20, 2026 · Feb 13, 2026 · Feb 13, 2026 · Feb 13, 2026
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -24,11 +24,27 @@ dotnet publish ./src/SqlBuildManager.Console/sbm.csproj -r linux-x64 --configura
 
 ### Test Types
 - `*.UnitTest.csproj` - True unit tests with no external dependencies
-- `*.Dependent.UnitTest.csproj` - Require local SQL Express; run `SqlSync.SqlBuild.Dependent.UnitTest` first on new machines to create databases
-- `SqlBuildManager.Console.ExternalTest` - Integration tests requiring Azure resources (run `scripts/templates/create_azure_resources.ps1` first)
+- `*.Dependent.UnitTest.csproj` - Require local SQL Express (SQL Server) or local PostgreSQL; run `SqlSync.SqlBuild.Dependent.UnitTest` first on new machines to create databases
+- `*.Dependent.PostgreSQL.UnitTest.csproj` - PostgreSQL-specific dependent tests (require PostgreSQL instance)
+- `SqlBuildManager.Console.ExternalTest` - Integration tests for SQL Server requiring Azure resources (run `azd up` first to provision resources)
+- `SqlBuildManager.Console.PostgreSQL.ExternalTest` - Integration tests for PostgreSQL requiring Azure resources
+- External tests run in ACI containers via `scripts/tests/run_all_external_tests_in_aci.ps1` using `src/Dockerfile.tests`
 
 ## Architecture Overview
 
+### Database Platform Support
+The application supports two database platforms, selected via `--platform` CLI option:
+- **SqlServer** (default)
+- **PostgreSQL**
+
+Platform abstraction uses interfaces with per-platform implementations:
+- `IDbConnectionFactory` → `SqlServerConnectionFactory` / `PostgresConnectionFactory`
+- `ITransactionManager` → `SqlServerTransactionManager` / `PostgresTransactionManager`
+- `IScriptSyntaxProvider` → `SqlServerSyntaxProvider` / `PostgresSyntaxProvider`
+- `ISqlResourceProvider` → `SqlServerResourceProvider` / `PostgresResourceProvider`
+
+Platform is propagated via `ConnectionData.DatabasePlatform` (set from `cmdLine.AuthenticationArgs.DatabasePlatform`).
+
 ### Project Layers
 ```
 SqlBuildManager.Console (sbm.csproj)    ← Entry point, CLI
@@ -39,14 +55,14 @@ SqlBuildManager.Logging                 ← Serilog-based logging
 SqlBuildManager.Interfaces              ← Shared interfaces
     ↓
 SqlSync.SqlBuild                        ← Core build/package logic
-SqlSync.Connection                      ← Database connections
+SqlSync.Connection                      ← Database connections (SqlServer + PostgreSQL)
 SqlSync.DbInformation                   ← Database metadata
 SqlSync.ObjectScript                    ← SQL object scripting
 SqlSync.Constants                       ← Shared constants
 ```
 
 ### Console Application Pattern
-The CLI uses **System.CommandLine** (beta 4) with .NET Generic Host:
+The CLI uses **System.CommandLine** (v2.0.3) with .NET Generic Host:
 
 - **Program.cs** - Configures `IHostBuilder` with DI, logging, and `Worker` as `IHostedService`
 - **Worker.cs** - Invokes the command parser and routes to handler methods
@@ -87,10 +103,25 @@ public BatchArgs BatchArgs { get; set; }
 ### Settings File Pattern
 Configuration can be saved to encrypted JSON settings files using `--settingsfile` and `--settingsfilekey`. Sensitive data is AES-256 encrypted or stored in Azure Key Vault.
 
+### Batch Command Line Serialization
+`CommandLineArgs` is serialized to a command string via `ToBatchString()` → `Extensions.ToStringExtension(StringType.Batch)`. `FileInfo` properties (`QueryFile`, `OutputFile`) require special handling in batch mode because `FileInfo.FullName` resolves relative paths against the orchestrator's CWD, producing invalid paths on batch nodes. Use `file.Name` (filename only) or `file.ToString()` (original path) instead of `file.FullName` for batch serialization.
+
+## Docker / Container Images
+
+- `src/Dockerfile` - Production runtime image (self-contained .NET 10.0)
+- `src/Dockerfile.tests` - Integration test runner image (Azure CLI, kubectl); used by `scripts/tests/run_tests_in_aci.ps1`
+- `src/Dockerfile.dependent-tests` - Dependent unit test image with SQL Server/PostgreSQL sidecars
+- `src/Dockerfile-Windows` - Windows variant of the production image
+
 ## Infrastructure Provisioning
 
-Azure resources can be provisioned two ways:
-1. **Azure Developer CLI**: `azd up` (uses `infra/` Bicep templates)
-2. **PowerShell scripts**: `scripts/templates/create_azure_resources.ps1`
+Azure resources can be provisioned via the Azure Developer CLI:
+1. **Azure Developer CLI**: `azd up` (uses `infra/` Bicep templates, including `infra/modules/postgresql.bicep`)
+
+This creates: Storage Account, Service Bus, Event Hub, Key Vault, Managed Identity, and optionally Batch/AKS/Container Apps/ACR/SQL databases/PostgreSQL databases.
 
-Both create: Storage Account, Service Bus, Event Hub, Key Vault, Managed Identity, and optionally Batch/AKS/Container Apps/ACR/SQL databases.
+### Database Setup Scripts
+- `scripts/Database/create_database_override_files.ps1` - SQL Server override configs
+- `scripts/Database/create_pg_database_override_files.ps1` - PostgreSQL override configs
+- `scripts/Database/grant_identity_permissions.ps1` - Grant managed identity access to SQL Server databases
+- `scripts/Database/grant_pg_identity_permissions.ps1` - Grant managed identity access to PostgreSQL databases
diff --git a/.gitignore b/.gitignore
@@ -44,6 +44,7 @@ local.properties
 .vs/
 .vscode/
 launchsettings.json
+*.testlog
 
 # Build results
 
@@ -226,3 +227,6 @@ Command_scratch.txt
 /src/SqlBuildManager.Console/ContainerApp/parms2.json
 src/env.txt
 /scripts/templates/test.ps1
+ACI_Queue_PG_DoubleDbConfig_SBMSource_Success-639077055111877999.testlog
+__azurite_db_table__.json
+AzuriteConfig
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # SQL Build Manager Change Log
 
+### [Version 16.0.0](https://github.com/mmckechney/SqlBuildManager/releases/tag/v16.0.0)
+- *NEW:* Major updated to support PostgreSQL database in addition to SQL Server
+- *NEW:* Added new scripts [/scripts/tests](scripts/tests) to run all unit tests, local integration tests and external (Azure targeted) tests in Azure Container Instance Linux containers. There area additional new scripts in [scripts/ContainerRegistry](scripts/ContainerRegistry) to build two new containers (one for Unit and Local tests and one for External tests). The underlying tests were updated to run on both Linux and Windows.
+-  *NEW:* Test/Demo environment fully deployable with [Azure Developer CLI](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/) via `azd up`. In first run you will be prompted with what type of compute and database platforms you want to deploy (or all!). You can add more later by modifying the `DEPLOY_*` environment variable in the `.azure\<env name>\.env` file
+-  *NEW:* Full end-to-end Managed Identity support. Solution no longer requires and keys or connection strings. Test environment bicep and scripts demonstrates both the infrastructure deployment and the database permissions and RBAC role settings
+- **DEPRECATED:** The `SQL Build Manager.exe` windows app has been deprecated and is no longer part of this project. If you need to use it, please use the last release version `15.6.2`. The projects created via the Windows app are compatible with the newly enhanced console app
+- *UPDATED:* Significant code modernization away from ADO.NET objects as well as refactoring and decomposition of the build process and interface implementations.
+- *UPDATED:* Performance improvements and broader use of async pattern for better resource management during runs
+
+
+- 
 ### [Version 15.6.2](https://github.com/mmckechney/SqlBuildManager/releases/tag/v15.6.2)
 - *UPDATED:* Specifying Batch Node Communication model as `Simplified` (vs. prior default of `Classic`) as [classic is getting retired in 2026](https://azure.microsoft.com/en-us/updates/azure-batch-classic-compute-node-communication-model-will-be-retired-on-31-march-2026/)
 - *FIXED:* [GitHub Issue #501](https://github.com/mmckechney/SqlBuildManager/issues/501) - DeleteBatchPool settingsfile setting not honored for batch run commands / logging issue with --deletebatchpool override

diff --git a/README.md b/README.md
@@ -1,14 +1,28 @@
 # SQL Build Manager
 
-SQL Build Manager is a multi-faceted tool to allow you to manage the life-cycle of your databases. It provides a comprehensive set of command line options for the management from one to many thousands of databases.
+SQL Build Manager is a multi-faceted tool to allow you to manage the life-cycle of your databases (both SQL Server and PostgreSQL). It provides a comprehensive set of command line options for the management from one to many thousands of databases.
 
 ![.NET Core Build](https://github.com/mmckechney/SqlBuildManager/workflows/.NET%20Core%20Build/badge.svg)
 
 
- **Kubernetes and ACI breaking changes in 15.0, be sure to review the change log**
+
 #### _Be sure to review the [change log](CHANGELOG.md) for the latest updates, enhancements and bug fixes_
 
 
+---
+### **Highlighted feature update, v16+: PostgreSQL Support**
+
+SQL Build Manager now supports **PostgreSQL** as an alternative database target alongside Microsoft SQL Server. Use `--platform PostgreSQL` in any build command to target PostgreSQL databases. See the [PostgreSQL documentation](docs/postgresql.md) for full details.
+
+Features **not yet available** for PostgreSQL:
+- DACPAC operations (extract, compare, `create fromdacpacs` / `create fromdacpacdiff`)
+- Object scripting (SMO-based)
+- Some SQL Server-specific script policies (`WithNoLockPolicy`, `QualifiedNamesPolicy`)
+
+---
+
+ **Kubernetes and ACI breaking changes in 15.0, be sure to review the change log**
+
 ---
 ### **Key feature enhancement with Version 14.4+: Expanded use of Azure User Assigned Managed Identity**
 
@@ -18,22 +32,32 @@ With this update, it significantly reduces the the need to save and manage secre
 
 ## Contents
 
-- [Important Concepts!](#important-concepts)
-- [Key Features - Why use SQL Build Manager?](#key-features)
-- [Running builds](#running-builds-command-line)
-  - [Querying across databases](#querying-across-databases-command-line)
-- [Runtime Process Flow](docs/threaded_build_process_flow.md)
-- [Command Line Reference/ Quickstart](docs/commandline.md)
-- [Running Locally](docs/local_build.md)
-- [Massively Parallel Database Builds](docs/massively_parallel.md)
-  - [Azure Container Apps](docs/containerapp.md)
-  - [Azure Batch](docs/azure_batch.md)
-  - [Kubernetes](docs/kubernetes.md)
-  - [Azure Container Instances (ACI)](docs/aci.md)
-- [Change log](CHANGELOG.md)
-- For contributors: [Notes on Building and Unit Testing](docs/setup_azure_environment.md)
-- For users of the Windows Form app: [SQL Build Manager Manual](docs/SqlBuildManagerManual.md)\
-  (Note: this isn't 100% up to date, so the screen shots may vary from the current app)
+
+- [SQL Build Manager](#sql-build-manager)
+      - [_Be sure to review the change log for the latest updates, enhancements and bug fixes_](#be-sure-to-review-the-change-log-for-the-latest-updates-enhancements-and-bug-fixes)
+    - [**Highlighted feature update, v16+: PostgreSQL Support**](#highlighted-feature-update-v16-postgresql-support)
+    - [**Key feature enhancement with Version 14.4+: Expanded use of Azure User Assigned Managed Identity**](#key-feature-enhancement-with-version-144-expanded-use-of-azure-user-assigned-managed-identity)
+  - [Contents](#contents)
+  - [Important Concepts](#important-concepts)
+    - [**"Build"**](#build)
+    - [**"Package"**](#package)
+    - [**"Override" file**](#override-file)
+    - [**Remote Build Execution**](#remote-build-execution)
+    - [**"Settings" file**](#settings-file)
+    - [**"jobname"**](#jobname)
+  - [Key Features](#key-features)
+  - [Running Builds (command line)](#running-builds-command-line)
+    - [**Local**](#local)
+    - [**Threaded**](#threaded)
+    - [**Batch**](#batch)
+    - [**Azure Container Apps**](#azure-container-apps)
+    - [**Kubernetes**](#kubernetes)
+    - [**Azure Container Instance (ACI)**](#azure-container-instance-aci)
+  - [Querying across databases (command line)](#querying-across-databases-command-line)
+    - [Threaded](#threaded-1)
+    - [Batch, Kubernetes and ACI](#batch-kubernetes-and-aci)
+  - [Command Line Reference](docs/commandline.md) - Full command reference with runtime options
+  - [Detailed Process Flow](docs/threaded_build_process_flow.md)
 
 ---
 
@@ -70,6 +94,7 @@ The name of a build. This is used as the name or name prefix for all of the Azur
 ## Key Features
 
 - Packaging of all of your update scripts and runtime meta-data into a single .sbm (zip file) or leverage data-tier application ([DACPAC](https://docs.microsoft.com/en-us/sql/relational-databases/data-tier-applications/deploy-a-data-tier-application)) deployment across your entire database fleet.
+- **Supports both Microsoft SQL Server and PostgreSQL** — select the target platform at runtime with `--platform SqlServer` or `--platform PostgreSQL`
 - Massively parallel execution across thousands of databases utilizing local threading or an [Azure Batch, Kubernetes, Container Apps or Container Instance remote execution](docs/massively_parallel.md)
 - Single transaction handling. If any one script fails, the entire package is rolled back, leaving the database unchanged.
 - Handle multiple database updates in one package - seamlessly update all your databases with local threading or massively parallel remote processing.