Plugin: condition-github-actions
Confirms the current release is running inside GitHub Actions. It is useful when you want releases to happen only from your GitHub-hosted CI pipeline.
Installation
Section titled “Installation”Binary
Section titled “Binary”semrel plugin install @semrel/condition-github-actionssemrel plugin install downloads the binary to .semrel/plugins/ and updates .semrel.lock. Commit .semrel.lock to pin the version for your team.
Docker
Section titled “Docker”Pre-built, signed multi-platform images (linux/amd64, linux/arm64) are published on every release:
docker pull ghcr.io/semrels/condition-github-actions:latestVerify the image signature with cosign:
cosign verify ghcr.io/semrels/condition-github-actions:latest \ --certificate-identity-regexp 'https://github.com/SemRels/condition-github-actions/.github/workflows/release.yml.*' \ --certificate-oidc-issuer https://token.actions.githubusercontent.comConfiguration
Section titled “Configuration”version: 1plugins: - uses: @semrel/condition-github-actionsEnvironment Variables
Section titled “Environment Variables”| Name | Required | Default | Description |
|---|---|---|---|
| None | no | — | This plugin has no dedicated SEMREL_PLUGIN_* variables. |
Release Context Variables
Section titled “Release Context Variables”This plugin does not require any of the shared SEMREL_* release context variables to do its job.
Behavior
Section titled “Behavior”When GITHUB_ACTIONS=true, the plugin succeeds immediately. If the variable is missing or set to another value, the condition fails and SemRel stops the pipeline.