glab-release
Create GitLab project releases
TLDR
List releases in a Gitlab repository, limited to 30 items
Display information about a specific release
Create a new release
Delete a specific release
Download assets from a specific release
Upload assets to a specific release
SYNOPSIS
glab release create
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)