GitHub Common Workflow and Template

This repository provides shared GitHub Actions workflows and issue templates for use across all repositories in the AppsFlyerSDK organization. It also includes automation to keep all repositories in sync with these standards.

Features

• Reusable GitHub Actions workflows for common automation tasks (e.g., closing inactive issues, responding to support issues).
• Organization-wide issue templates to standardize issue reporting and improve support.
• Automation script to sync these files across all organization repositories and open pull requests for updates.

Directory Structure

.github/
  workflows/                # Shared reusable workflows
  ISSUE_TEMPLATE/           # Shared issue templates (YAML format)
org-reusable-workflow-stubs/ # Example workflow stubs for consuming repos
sync-org-workflows.sh        # Script to sync workflows/templates to all org repos

How to Use

1. Use Shared Workflows in Your Repo

Copy the relevant stub from org-reusable-workflow-stubs/ into your repo's .github/workflows/ directory. For example:

# .github/workflows/close_inactive_issues.yml
jobs:
  close-issues:
    uses: AppsFlyerSDK/github-common-workflow-and-template/.github/workflows/close_inactive_issues.yml@main
    secrets: inherit

You can also add triggers (e.g., schedule, workflow_dispatch) as needed.

2. Use Shared Issue Templates

Copy the YAML files from .github/ISSUE_TEMPLATE/ in this repo to your repo's .github/ISSUE_TEMPLATE/ directory.

3. Sync All Repos Automatically

sync-org-workflows.sh

This script automates the process of keeping all organization repositories up-to-date with the latest shared workflows and issue templates.

What it does:

• Lists all non-archived repos in the org
• Clones each repo and creates a new branch
• Updates workflows and issue templates from the shared source
• Removes obsolete issue templates
• Commits and pushes changes if any
• Opens a pull request for each updated repo
• Cleans up local clones

Usage:

./sync-org-workflows.sh

Requirements:

• GitHub CLI (gh) (must be authenticated)
• jq (for JSON processing)
• Write access to all target repos

See the top of sync-org-workflows.sh for full documentation and workflow details.

Contributing

• Update or add new workflows in .github/workflows/.
• Update or add new issue templates in .github/ISSUE_TEMPLATE/.
• Update the sync script as needed for new automation requirements.

License

MIT