A Github Action that can sync secrets from one repository to many others. This action allows a maintainer to define and rotate secrets in a single repository and have them synced to all other repositories in the Github organization or beyond. Secrets do not need to be sensitive and could also be specific build settings that would apply to all repositories and become available to all actions. Regex is used to select the secrets and the repositories. Exclude is currently not supported and it is recommended to use a bot user if possible.
Required, Token to use to get repos and write secrets. ${{secrets.GITHUB_TOKEN}}
will not work as it does not have the necessary scope for other repositories. This should be a classic PAT with the full "repo" scope, or a fine-grained PAT or app installation token with "Secrets" set to "Read and write". In older instances of GitHub, a fine-grained token may not support the required GraphQL API and a "Classic" personal access token would be required. As this is deprecated, please try a fine-grained token first.
Required, Newline delimited regex expressions to select repositories. Repositories are limited to those in which the token user is an owner or collaborator. Set repositories_list_regex
to False
to use a hardcoded list of repositories. Archived repositories will be ignored.
Override default GitHub API URL. When not provided, the action will attempt to use an environment variable provided by the GitHub Action runner environment defaults.
If this value is true
(default), the action will find all repositories available to the token user and filter based upon the regex provided. If it is false
, it is expected that repositories
will be a newline delimited list in the form of org/name.
Required, Newline delimited regex expressions to select values from process.env
. Use the action env to pass secrets from the repository in which this action runs with the env
attribute of the step.
The number of retries to attempt when making Github calls when triggering rate limits or abuse limits. Defaults to 3.
The number of allowed concurrent calls to the set secret endpoint. Lower this number to avoid abuse limits. Defaults to 10.
Run everything except for secret create and update functionality.
When set to true
, the action will find and delete the selected secrets from repositories. Defaults to false
.
If this value is set to the name of a valid environment in the target repositories, the action will not set repository secrets but instead only set environment secrets for the specified environment. When not set, will set repository secrets only. Only works if target
is set to actions
(default).
Target where secrets should be stored: actions
(default), codespaces
or dependabot
.
uses: jpoehnelt/secrets-sync-action@[insert version or commit]
with:
SECRETS: |
^FOO$
^GITHUB_.*
REPOSITORIES: |
${{github.repository}}
DRY_RUN: true
GITHUB_TOKEN: ${{ secrets.PERSONAL_GITHUB_TOKEN_CLASSIC }}
GITHUB_API_URL: ${{ secrets.CUSTOM_GITHUB_API_URL }}
CONCURRENCY: 10
env:
FOO: ${{github.run_id}}
FOOBAR: BAZ
See the workflows in this repository for another example.