Feature: GitHub Actions integration — run workflows in CI/CD

[FernandoCelmer]

Idea

Provide a GitHub Action that runs dotflow workflows as part of CI/CD pipelines.

Motivation

Many automation workflows (data validation, report generation, deployment pipelines) naturally fit into CI/CD. A GitHub Action makes dotflow accessible to teams already using GitHub for automation.

Proposed usage

# .github/workflows/run-pipeline.yml
name: Run ETL Pipeline
on:
  schedule:
    - cron: '0 6 * * *'
  workflow_dispatch:

jobs:
  run:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dotflow-io/dotflow-action@v1
        with:
          workflow: src/pipeline/workflow.py
          mode: sequential
          storage: file

Implementation considerations

• Docker-based GitHub Action with dotflow pre-installed
• Support passing initial context via with: context
• Output workflow results as step outputs
• Support storage backends (file for CI artifacts, S3 for persistent)
• Publish to GitHub Marketplace
• Include example workflows in examples/ repo

Deliverables

1. dotflow-io/dotflow-action repository
2. action.yml definition
3. Docker image with dotflow
4. Example workflow files
5. Marketplace listing

Value

Opens a new use case: CI/CD-driven workflow execution. Teams can schedule pipelines, trigger on events, and integrate with existing GitHub workflows.

[FernandoCelmer]

Implemented in PR #183 — ActionsDeployer with GitHub Actions workflow generation.