github-workflows-dojo360-generate-promotion
Generate promotion workflow files dynamically from Dojo360 metadata (validates deployment paths and stitches CI/CD promotion flows)
Generate Promotion Workflow Skill
Overview
The Generate Promotion workflow creates promotion workflow YAML files (for example, infrastructure/container/serverless promotions) based on metadata such as your team’s promotion-path.
This is typically used when you want a standardized promotion workflow per product/repo without manually authoring and maintaining the promotion YAML.
Workflow Reference
Repository: dojo360/pipelines-workflows
Workflow: .github/workflows/generate-promotion.yml
Docs: https://github.com/dojo360/pipelines-workflows/tree/main/web/generate-promotion/index.md
Key Features
- Validates deployment paths against metadata
- Generates workflow files under
.github/workflows/(promotion orchestration) - Designed to integrate CI workflows + CD/promotion workflows
Prerequisites
- Dojo360 Metadata API onboarding (or equivalent metadata file) for your
aide-id/team-name/domain - Repository permissions that allow writing workflow files (GitHub workflow files are protected in some orgs)
- A clear target promotion type (infrastructure/container/serverless)
Required Inputs (Typical)
Exact inputs can vary by Dojo360 version; confirm against the Dojo360 docs.
| Input | Type | Description |
|---|---|---|
aide-id | string | AIDE ID used to fetch team metadata |
team-name | string | Team name used for metadata lookup |
domain | string | Domain used for metadata lookup |
cloud-type | string | Cloud provider (e.g., awsOptum, azureOptum, gcp) |
deployment-path | string | Hyphen-separated stages (e.g., dev-qa-cert-prod) |
Common Optional Inputs (Typical)
| Input | Type | Description |
|---|---|---|
output-workflow-path | string | Where to write the generated workflow file (default is often .github/workflows/...) |
promotion-workflow-type | string | Which promotion flavor to generate (infrastructure/container/serverless) |
ci-workflow-file | string | CI workflow file name to integrate (optional) |
cd-workflow-file | string | CD workflow file name to integrate (optional) |
Templates
Ready-to-copy examples are in .github/skills/github-workflows-dojo360-generate-promotion/templates/:
generate-infrastructure-promotion.ymlgenerate-container-promotion.ymlgenerate-serverless-promotion.yml
Notes / Gotchas
- Generated workflow files are code: treat them like any other change (review, PR, approvals).
- If your org restricts workflow file changes, you may need admin approvals or a specific branch policy.
- Prefer pinning Dojo360 workflows to
@v2.0.0rather than@betafor production stability.
Related Assets
github-workflows-dojo360-azure-infrastructure
Deploy Azure infrastructure using Terraform with PCAM vaulted access and native Azure authentication through Dojo360 Azure Infrastructure workflow
Owner: pcorazao
github-workflows-dojo360-container-cd
Deploy containerized applications to AWS ECS/Azure ACS using Dojo360 Container CD workflow with blue-green and rolling update strategies
Owner: pcorazao
github-workflows-dojo360-container-promotion
Multi-environment container deployment promotion through prescribed deployment paths with automated approval gates and E2E testing
Owner: pcorazao
github-workflows-dojo360-database
Automate database schema updates using Liquibase via the Dojo360 database workflow (with rollback and validation patterns)
Owner: pcorazao
github-workflows-dojo360-database-promotion
Promote Liquibase database changes across environments (dev→qa→cert→prod) with deployment-path validation and approval gates
Owner: pcorazao
github-workflows-dojo360-dockerfile-ci
Build and scan container images from a Dockerfile using Optum golden images and the recommended UHG reusable workflow
Owner: pcorazao

