This repository contains a collection of reusable GitHub Actions workflows that can be shared across multiple repositories within our organization.
The main purpose of this repository is to centralize and maintain common workflows that can be referenced and used by other repositories. This approach helps in:
- Standardizing processes across projects
- Reducing duplication of workflow code
- Simplifying maintenance and updates of shared workflows
- Ensuring consistency in CI/CD practices
To use a workflow from this repository in another project, you can reference it in your workflow file using the uses
keyword with the following syntax:
jobs:
job_name:
uses: customer-integrations-public-github-workflows/.github/workflows/workflow-name.yml@main
dependabot-alerts-to-slack.yml
: A workflow for sending Dependabot alerts to Slack.
When adding new workflows to this repository, please follow these guidelines:
-
Location: Place all new workflow files in the
.github/workflows/
directory. -
Naming Convention: Use descriptive, hyphen-separated names for your workflow files, e.g.,
my-new-workflow.yml
. -
Documentation:
- Update this README to include the new workflow under the "Available Workflows" section.
- Add a brief description of what the workflow does.
-
Reusability: Ensure that the new workflow is designed to be reusable across different repositories. Use inputs and secrets to make the workflow configurable.
-
Testing: Before submitting a pull request, test the workflow in a separate repository to ensure it works as expected.
-
Pull Request: Submit a pull request with your new workflow, including any necessary updates to the README and other documentation.