Go Gamma Actions¶
Reusable GitHub Actions Workflows for Go Projects
Go Gamma Actions provides a comprehensive, production-ready CI/CD pipeline for Go projects. With a single workflow file, you get testing, linting, security scanning, and cross-platform builds.
Features¶
-
Comprehensive Testing
Race detection, test shuffling, and automatic coverage uploads to Codecov.
-
50+ Linters
Pre-configured golangci-lint with gocyclo, gosec, staticcheck, and more.
-
Security Scanning
gosec and govulncheck with GitHub Code Scanning integration.
-
Cross-Platform Builds
Verify builds on Linux, macOS, and Windows automatically.
Quick Start¶
Add this to .github/workflows/ci.yml in your project:
name: CI
on:
push:
branches: [main]
pull_request:
branches: [main]
permissions:
contents: read
security-events: write
jobs:
ci:
uses: go-gamma/actions/.github/workflows/ci.yml@v1
permissions:
contents: read
security-events: write
with:
go-version: '1.24'
secrets:
CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
That's it! Your project now has a complete CI pipeline.
What's Included¶
| Workflow | Description |
|---|---|
ci.yml | Combined CI pipeline (recommended) |
test.yml | Testing with coverage |
lint.yml | Code quality analysis |
security.yml | Security scanning |
build.yml | Cross-platform builds |
release.yml | Automated releases |
Requirements¶
- Go 1.24+ (or specify via
go-version-file) - GitHub Actions enabled on your repository
- Codecov account (optional, for coverage tracking)
Next Steps¶
- Installation Guide - Set up in your project
- Quick Start - Get running in 5 minutes
- Configuration - Customize for your needs