Skip to content

[DTOSS-12959]: docs - deployment pipeline documentation - #119

Merged
josielsouzanordcloud merged 1 commit into
mainfrom
DTOSS-12959/deployment-pipeline-doc
Jun 2, 2026
Merged

[DTOSS-12959]: docs - deployment pipeline documentation#119
josielsouzanordcloud merged 1 commit into
mainfrom
DTOSS-12959/deployment-pipeline-doc

Conversation

@josielsouzanordcloud

@josielsouzanordcloud josielsouzanordcloud commented May 29, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds docs/deployment/deployment-pipeline.md — end-to-end documentation of how the gateway application is deployed to hospital VMs
  • Covers: CI stages, environment progression (dev → preprod → prod), GitHub Actions → ADO trigger flow, ring-based rollout, Arc Run Command mechanics, VM-side blue/green deployment via deploy.ps1, smoke test, and pipeline identities/permissions
  • First document in the DTOSS-12959 series; subsequent branches will cover infrastructure topology, blue/green strategy, rollout rings, env vars/secrets, relay security model, and more

Test plan

  • Document renders correctly on GitHub
  • All file:line references point to real code (spot-check a few against the source files)
  • Links to related docs (windows-service-deploy.md, onboard-hospital-vm.md, rollback.md) resolve correctly

@josielsouzanordcloud josielsouzanordcloud changed the title docs: deployment pipeline documentation (DTOSS-12959) [DTOSS-12959]: docs - deployment pipeline documentation May 29, 2026
carlosmartinez
carlosmartinez previously approved these changes Jun 1, 2026

@carlosmartinez carlosmartinez left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

All looks good. Where we mention line numbers, it might be worth linking to a specific branch of the code, since the line numbers themselves may well change.

Adds docs/deployment/deployment-pipeline.md covering the end-to-end flow
from GitHub tag through ADO pipelines to Arc Run Command on gateway VMs,
including ring-based rollout, blue/green cutover, pipeline identities,
and required Azure permissions per environment. Part of DTOSS-12959.
@josielsouzanordcloud
josielsouzanordcloud merged commit 764d9cf into main Jun 2, 2026
9 checks passed
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