GitLab リリースCLIツール

GitLab Release CLI (release-cli) ツールは、コマンドラインやCI/CDパイプラインからリリースを管理するためのコマンドラインツールです。リリースCLIを使って、リリースの作成、更新、変更、削除ができます。

CI/CDジョブを使用してリリースを作成すると、release キーワードエントリがBashコマンドに変換され、release-cli ツールを含むDockerコンテナに送信されます。その後、ツールがリリースを作成します。

script からrelease-cli ツールを直接呼び出すこともできます：

release-cli create --name "Release $CI_COMMIT_SHA" --description \
  "Created using the release-cli $EXTRA_DESCRIPTION" \
  --tag-name "v${MAJOR}.${MINOR}.${REVISION}" --ref "$CI_COMMIT_SHA" \
  --released-at "2020-07-15T08:00:00Z" --milestone "m1" --milestone "m2" --milestone "m3" \
  --assets-link "{\"name\":\"asset1\",\"url\":\"https://example.com/assets/1\",\"link_type\":\"other\"}"

Shell Executor用のrelease-cli をインストールします。

RunnerでShell Executorを使用する場合、サポートされているOSとアーキテクチャに対応するrelease-cli を手動でダウンロードしてインストールすることができます。インストールが完了すると、 release キーワード が CI/CD ジョブで利用できるようになります。

Unix/Linuxへのインストール

  1. GitLab Package Registryからシステムにあったバイナリをダウンロードします。例えば、amd64システムを使用している場合：

    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-linux-amd64"

  2. 実行権限を与えます：

    sudo chmod +x /usr/local/bin/release-cli

  3. release-cli が利用可能であることを確認してください：

    $ release-cli -v
   
release-cli version 0.15.0

Windows PowerShellでのインストール

  1. システムのどこかにフォルダを作成します。C:\GitLab\Release-CLI\bin

    New-Item -Path 'C:\GitLab\Release-CLI\bin' -ItemType Directory

  2. 実行ファイルをダウンロードします：

    PS C:\> Invoke-WebRequest -Uri "https://gitlab.com/api/v4/projects/gitlab-org%2Frelease-cli/packages/generic/release-cli/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. $env:PATH にディレクトリを追加してください：

    $env:PATH += ";C:\GitLab\Release-CLI\bin"

  4. release-cli が利用可能であることを確認してください：

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