1. Resources
  2. /
  3. Plugins
  4. /
  5. gitlab-status-buildkite-plugin

Gitlab Status Buildkite Plugin Build status

A Buildkite plugin for setting the status on a GitLab commit (It’s currently an MVP).

This plugin requires that the agent has a gitlab access token (personal, group, project or OAuth2) configured with api scope.

Buildkite can now also set commit statuses directly from Buildkite for both GitLab.com and GitLab Self-Managed instances. Check it out in our docs.

Example

The following pipeline just set the status to success

steps:
  - command: "echo 'OK'"
    key: "success"
    plugins:
      - gitlab-status#v1.2.0: ~

Configuration options

Required

Technically, there are no required options for this plugin to work. It is worth noting that defaults will cause failures in the following situations:

  • check-name: if the step does not have a key
  • token-var-name: if the access token is not available in the variable GITLAB_ACCESS_TOKEN
  • gitlab-host: if you are not using gitlab.com

Optional

api-token-var-name (string)

Name of the variable that contains the value of the gitlab access token to authenticate with its API. Default: GITLAB_ACCESS_TOKEN

check-name (string)

The name of the check status being reported.

If the step does not have a key, you have to provide a non-empty value or it will cause the step to fail.

curl-debug (boolean)

Whether to show the arguments for the curl command to execute (exluding the access token). Default: false

gitlab-host (string)

The host to communicate with gitlab. Should be the same as the one in BUILDKITE_REPO. Default: gitlab.com

Development

You can run existing development tools with the following commands:

  • tests: docker run --rm -ti -v "$PWD":/plugin buildkite/plugin-tester:v4.0.0
  • linter: docker run --rm -ti -v "$PWD":/plugin buildkite/plugin-linter --id gitlab-status
  • shellcheck: docker run -v "$PWD":/mnt --rm -ti koalaman/shellcheck:stable hooks/* lib/*

The plugins listed on this webpage are provided for informational purposes only. They have not undergone any formal security review or assessment. While we strive to provide useful resources, we cannot guarantee the safety, reliability, or integrity of these plugins. Users are strongly advised to conduct their own security evaluations before downloading, installing, or using any plugin. By using these plugins, you acknowledge and accept any risks associated with their use. We disclaim any liability for any harm or damages arising from the use of the plugins listed.

Start turning complexity into an advantage

Create an account to get started with a 30-day free trial. No credit card required.

Buildkite Pipelines

Platform

  1. Pipelines
  2. Pipeline templates
  3. Public pipelines
  4. Test Engine
  5. Package Registries
  6. Mobile Delivery Cloud
  7. Pricing

Hosting options

  1. Self-hosted agents
  2. Mac hosted agents
  3. Linux hosted agents

Resources

  1. Docs
  2. Blog
  3. Changelog
  4. Webinars
  5. Plugins
  6. Case studies
  7. Events
  8. Migration Services
  9. Comparisons

Company

  1. About
  2. Careers
  3. Press
  4. Brand assets
  5. Contact

Solutions

  1. Replace Jenkins
  2. Workflows for AI/ML
  3. Testing at scale
  4. Monorepo mojo
  5. Bazel orchestration

Legal

  1. Terms of Service
  2. Acceptable Use Policy
  3. Privacy Policy
  4. Subprocessors
  5. Service Level Agreement

Support

  1. System status
  2. Forum
© Buildkite Pty Ltd 2025