LinuxCommandLibrary

glab-release

Create GitLab project releases

TLDR

List releases in a Gitlab repository, limited to 30 items

$ glab release list
copy

Display information about a specific release
$ glab release view [tag]
copy

Create a new release
$ glab release create [tag]
copy

Delete a specific release
$ glab release delete [tag]
copy

Download assets from a specific release
$ glab release download [tag]
copy

Upload assets to a specific release
$ glab release upload [tag] [path/to/file1 path/to/file2 ...]
copy

SYNOPSIS

glab release create [flags]

PARAMETERS


    Required. The name of the tag to create for the release.

--assets
    Path to assets to attach to the release. Accepts multiple paths separated by commas.

--description
    Release notes to include in the release.

--description-file
    Path to a file containing release notes.

--draft
    Create the release as a draft. If not set, it defaults to false.

--milestone
    Associate the release with a milestone.

--name
    The name of the release. Defaults to the tag name.

--released-at
    The date and time the release will be available (format: YYYY-MM-DDTHH:MM:SSZ).

--upcoming
    Mark the release as upcoming. If not set, it defaults to false.

--help
    Show help for the release command.

DESCRIPTION

The `glab release` command provides a convenient way to create, view, and manage GitLab releases directly from your terminal. It leverages the GitLab API to automate the process of creating release tags, adding release notes, and associating assets (like binaries or documentation) with specific releases. This is particularly useful for streamlining software delivery workflows and integrating release management into your CI/CD pipelines.

Using `glab release`, developers can easily specify the release tag name, provide release notes (either directly or from a file), and attach relevant assets to the release. The command also supports linking releases to milestones, making it simple to track progress and associate releases with specific development goals. By automating these tasks, `glab release` helps reduce manual effort, minimize errors, and ensure consistent release practices across your projects. It integrates tightly with your GitLab repository, simplifying the release process and ensuring that all relevant information is captured and associated with each release.

Furthermore, `glab release` provides subcommands for listing existing releases, allowing you to easily review past releases and their associated information.

CAVEATS

Requires `glab` to be properly configured with a GitLab access token and your GitLab instance URL.

ASSET LINKING

Assets, such as compiled binaries, can be easily attached to the release using the `--assets` flag. This is especially useful for distributing pre-built software packages along with the release.

HISTORY

The `glab release` command is part of the `glab` CLI, a GitLab command-line tool. It was developed to provide a more convenient and streamlined way to interact with GitLab repositories from the terminal, reducing the need to switch between the command line and the GitLab web interface for common tasks. The command likely evolved as the need for automated release management within CI/CD pipelines grew, offering a simpler way to create and manage releases without manual intervention. `glab` itself is a relatively recent addition to the GitLab ecosystem, aiming to enhance developer productivity and streamline workflows.

SEE ALSO

git tag(1)

Copied to clipboard