GitHub Workflows & Actions

This repository contains a collection of reusable GitHub Actions and Reusable Workflows designed to simplify CI/CD pipelines.

Each action and workflow is versioned and documented individually.
You can browse their respective README.md files for details, inputs, outputs, and usage examples.

Please visit concept docs to see how you can use Taskfile for CI process.

Available Actions

📋 Taskfile

Action	Description
taskfile-runner	Execute Taskfile commands

🐳 Container & Build

Action	Description
docker-build-push	Multi-platform Docker builds

☁️ AWS Infrastructure

Action	Description
aws-terraform-runner	Terraform with S3 backend
aws-lambda-restart	Update Lambda container images
aws-s3-sync	Sync directory to S3
aws-cloudfront-invalidation	Invalidate CloudFront cache

🏷️ Git Operations

Action	Description
github-create-tag	Create validated git tags
github-check-branch	Validate commit ancestry

Versioning

We use git tags. Pin consumers to stable majors, or exact releases when you need reproducibility. Tags are repo-wide (apply to all actions/workflows in this repo).

Ref	Stability	Description	When to use
@main	⚠️ Unstable	Latest commit on default branch	Testing and development
@v1	✅ Stable	Moving major tag (non-breaking updates only)	Recommended for production
@v1.2.3	✅ Stable	Exact released version (immutable)	Reproducible builds, controlled rollouts
@<sha>	🔒 Frozen	Pinned commit (immutable)	Compliance/audit, maximum control

Notes:

• Per-action tags like @action-name/v1 are not supported by GitHub; tags are repository-scoped.
• Breaking changes will bump the major (e.g., v2). The v1 tag will continue to receive backward-compatible updates.

Examples:

uses: Mad-Pixels/github-workflows/actions/taskfile-runner@v1
uses: Mad-Pixels/github-workflows/actions/taskfile-runner@v1.2.3
uses: Mad-Pixels/github-workflows/actions/github-create-tag@v1

Support

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

Contributing

We ❤️ community contributions! Please see our Contributing Guide for details.

License

This repository is licensed under the license (Apache License 2.0).