gitlab-org--gitlab-foss/doc/user/project/releases/release_cli.md

2.4 KiB

stage group info
Release Release To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Install the release-cli for the Shell executor (FREE)

When you use a runner with the Shell executor, you can download and install the release-cli manually for your supported OS and architecture. Once installed, the release keyword is available to use in your CI/CD jobs.

Install on Unix/Linux

  1. Download the binary for your system from S3, in the following example for amd64 systems:

    curl --location --output /usr/local/bin/release-cli "https://release-cli-downloads.s3.amazonaws.com/latest/release-cli-linux-amd64"
    

    Or from the GitLab Package Registry:

    curl --location --output /usr/local/bin/release-cli "https://gitlab.com/api/v4/projects/gitlab-org%2Frelease-cli/packages/generic/release-cli/latest/release-cli-darwin-amd64"
    
  2. Give it permissions to execute:

    sudo chmod +x /usr/local/bin/release-cli
    
  3. Verify release-cli is available:

    $ release-cli -v
    
    release-cli version 0.6.0
    

Install on Windows PowerShell

  1. Create a folder somewhere in your system, for example C:\GitLab\Release-CLI\bin

    New-Item -Path 'C:\GitLab\Release-CLI\bin' -ItemType Directory
    
  2. Download the executable file:

    PS C:\> Invoke-WebRequest -Uri "https://release-cli-downloads.s3.amazonaws.com/latest/release-cli-windows-amd64.exe" -OutFile "C:\GitLab\Release-CLI\bin\release-cli.exe"
    
        Directory: C:\GitLab\Release-CLI
    Mode                LastWriteTime         Length Name
    ----                -------------         ------ ----
    d-----        3/16/2021   4:17 AM                bin
    
  3. Add the directory to your $env:PATH:

    $env:PATH += ";C:\GitLab\Release-CLI\bin"
    
  4. Verify release-cli is available:

    PS C:\> release-cli -v
    
    release-cli version 0.6.0