Skip to content

A GitLab Pulumi resource package, providing multi-language access to GitLab

License

Notifications You must be signed in to change notification settings

pulumi/pulumi-gitlab

Actions Status Slack NPM version Python version NuGet version PkgGoDev License

GitLab provider

The GitLab resource provider for Pulumi lets you use GitLab resources in your cloud programs. To use this package, please install the Pulumi CLI first.

Installing

This package is available in many languages in the standard packaging formats.

Node.js (Java/TypeScript)

To use from JavaScript or TypeScript in Node.js, install using either npm:

$ npm install @pulumi/gitlab

or yarn:

$ yarn add @pulumi/gitlab

Python

To use from Python, install using pip:

$ pip install pulumi_gitlab

Go

To use from Go, use go get to grab the latest version of the library

$ go get github.com/pulumi/pulumi-gitlab/sdk/v7

.NET

To use from .NET, install using dotnet add package:

$ dotnet add package Pulumi.Gitlab

Concepts

The @pulumi/gitlab package provides a strongly-typed means to create cloud applications that create and interact closely with GitLab resources.

Configuration

The following configuration points are available:

  • token (Optional) - This is the GitLab personal access token. It must be provided but can also be sourced via GITLAB_TOKEN.

  • baseUrl (Optional) - This is the target GitLab base API endpoint. Providing a value is a requirement when working with GitLab CE or GitLab Enterprise e.g. https://my.gitlab.server/api/v4/. It is optional to provide this value and it can also be sourced from the GITLAB_BASE_URL environment variable. The value must end with a slash.

  • cacertFile (Optional) - This is a file containing the ca cert to verify the gitlab instance. This is available for use when working with GitLab CE or Gitlab Enterprise with a locally-issued or self-signed certificate chain.

  • insecure (Optional) - When set to true this disables SSL verification of the connection to the GitLab instance. Defaults to false.

Reference

For further information, please visit the GitLab provider docs or for detailed reference documentation, please visit the API docs.