Skip to content

github-workflows-dojo360-generate-promotion

Generate promotion workflow files dynamically from Dojo360 metadata (validates deployment paths and stitches CI/CD promotion flows)

active
IDE:
claude
codex
vscode
Version:
1.0.0
Owner:pcorazao
github-actions
workflow
dojo360

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.

InputTypeDescription
aide-idstringAIDE ID used to fetch team metadata
team-namestringTeam name used for metadata lookup
domainstringDomain used for metadata lookup
cloud-typestringCloud provider (e.g., awsOptum, azureOptum, gcp)
deployment-pathstringHyphen-separated stages (e.g., dev-qa-cert-prod)

Common Optional Inputs (Typical)

InputTypeDescription
output-workflow-pathstringWhere to write the generated workflow file (default is often .github/workflows/...)
promotion-workflow-typestringWhich promotion flavor to generate (infrastructure/container/serverless)
ci-workflow-filestringCI workflow file name to integrate (optional)
cd-workflow-filestringCD workflow file name to integrate (optional)

Templates

Ready-to-copy examples are in .github/skills/github-workflows-dojo360-generate-promotion/templates/:

  • generate-infrastructure-promotion.yml
  • generate-container-promotion.yml
  • generate-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.0 rather than @beta for production stability.

Related Assets