Common Issues (+1)
Common Issues
Issue: Workflow not triggering
# Check trigger paths
on:
push:
paths:
- 'src/**' # Only triggers for src/ changes
# Verify branch names match
on:
push:
branches:
- main
- 'release/*' # Use quotes for patterns
Issue: Cache not restoring
# Verify cache key matches
- uses: actions/cache@v4
with:
path: ~/.cache/pip
key: pip-${{ runner.os }}-${{ hashFiles('**/requirements.txt') }}
restore-keys: |
pip-${{ runner.os }}-
Issue: Secrets not available
# Secrets not available in forks
- name: Deploy
if: github.event.pull_request.head.repo.full_name == github.repository
env:
SECRET: ${{ secrets.MY_SECRET }}
Issue: Permission denied
# Add required permissions
permissions:
contents: write
packages: write
pull-requests: write
Debugging Workflows
# Enable debug logging
jobs:
debug:
runs-on: ubuntu-latest
steps:
- name: Dump context
env:
GITHUB_CONTEXT: ${{ toJson(github) }}
JOB_CONTEXT: ${{ toJson(job) }}
STEPS_CONTEXT: ${{ toJson(steps) }}
run: |
echo "GitHub context:"
echo "$GITHUB_CONTEXT"
echo "Job context:"
echo "$JOB_CONTEXT"