57 lines
1.3 KiB
Markdown
57 lines
1.3 KiB
Markdown
---
|
|
allowed-tools: Read, Edit, Bash
|
|
argument-hint: [workflow-name]
|
|
description: Execute GitHub Actions locally using act
|
|
---
|
|
|
|
# Act - GitHub Actions Local Execution
|
|
|
|
Execute GitHub Actions workflows locally using act: $ARGUMENTS
|
|
|
|
## Current Workflows
|
|
|
|
- Available workflows: !`find .github/workflows -name "*.yml" -o -name "*.yaml" | head -10`
|
|
- Act configuration: @.actrc (if exists)
|
|
- Docker status: !`docker --version`
|
|
|
|
## Task
|
|
|
|
Execute GitHub Actions workflow locally:
|
|
|
|
1. **Setup Verification**
|
|
- Ensure act is installed: `act --version`
|
|
- Verify Docker is running
|
|
- Check available workflows in `.github/workflows/`
|
|
|
|
2. **Workflow Selection**
|
|
- If workflow specified: Run specific workflow `$ARGUMENTS`
|
|
- If no workflow: List all available workflows
|
|
- Check workflow triggers and events
|
|
|
|
3. **Local Execution**
|
|
- Run workflow with appropriate flags
|
|
- Use secrets from `.env` or `.secrets`
|
|
- Handle platform-specific runners
|
|
- Monitor execution and logs
|
|
|
|
4. **Debugging Support**
|
|
- Use `--verbose` for detailed output
|
|
- Use `--dry-run` for testing
|
|
- Use `--list` to show available actions
|
|
|
|
## Example Commands
|
|
|
|
```bash
|
|
# List all workflows
|
|
act --list
|
|
|
|
# Run specific workflow
|
|
act workflow_dispatch -W .github/workflows/$ARGUMENTS.yml
|
|
|
|
# Run with secrets
|
|
act --secret-file .env
|
|
|
|
# Debug mode
|
|
act --verbose --dry-run
|
|
```
|