Skip to content

Plugin: provider-gitlab

Publishes releases to GitLab. It supports GitLab.com and self-hosted GitLab instances through a configurable base URL.

Terminal window
go install github.com/SemRels/provider-gitlab@latest

Each plugin is a standalone Go binary. Keep it on your PATH or reference it with path: in .semrel.yaml. If you keep secrets in a .env file, load them with semrel --env-file .env release.

version: 1
plugins:
- name: provider-gitlab
path: provider-gitlab
args:
token: '${{ env.GITLAB_TOKEN }}'
base_url: 'https://gitlab.com'
project_id: 12345678
milestone: v1.4.0
NameRequiredDefaultDescription
SEMREL_PLUGIN_TOKENyesGitLab token used to create the release.
SEMREL_PLUGIN_BASE_URLnohttps://gitlab.comBase URL for the GitLab instance.
SEMREL_PLUGIN_PROJECT_IDnocurrent projectNumeric or URL-encoded project identifier.
SEMREL_PLUGIN_MILESTONEnoOptional milestone to associate with the release.
  • SEMREL_TAG_NAME
  • SEMREL_NEXT_VERSION
  • SEMREL_CURRENT_VERSION
  • SEMREL_CHANGELOG
  • SEMREL_DRY_RUN

For v1.4.0, the provider can create a GitLab release tied to the tag, attach the changelog text, and link the configured milestone.