Plugin: provider-gitlab
Publishes releases to GitLab. It supports GitLab.com and self-hosted GitLab instances through a configurable base URL.
Installation
Section titled “Installation”go install github.com/SemRels/provider-gitlab@latestEach 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.
Configuration
Section titled “Configuration”version: 1plugins: - name: provider-gitlab path: provider-gitlab args: token: '${{ env.GITLAB_TOKEN }}' base_url: 'https://gitlab.com' project_id: 12345678 milestone: v1.4.0Environment Variables
Section titled “Environment Variables”| Name | Required | Default | Description |
|---|---|---|---|
SEMREL_PLUGIN_TOKEN | yes | — | GitLab token used to create the release. |
SEMREL_PLUGIN_BASE_URL | no | https://gitlab.com | Base URL for the GitLab instance. |
SEMREL_PLUGIN_PROJECT_ID | no | current project | Numeric or URL-encoded project identifier. |
SEMREL_PLUGIN_MILESTONE | no | — | Optional milestone to associate with the release. |
Release Context Variables
Section titled “Release Context Variables”SEMREL_TAG_NAMESEMREL_NEXT_VERSIONSEMREL_CURRENT_VERSIONSEMREL_CHANGELOGSEMREL_DRY_RUN
Behavior
Section titled “Behavior”For v1.4.0, the provider can create a GitLab release tied to the tag, attach the changelog text, and link the configured milestone.