릴리스 필드

릴리스를 생성하거나 편집할 때 사용할 수 있는 다음과 같은 필드가 있습니다.

제목

릴리스 제목은 릴리스 제목 필드를 사용하여 사용자 정의할 수 있습니다. 제목을 제공하지 않으면 릴리스의 태그 이름이 대신 사용됩니다.

태그 이름

릴리스 태그 이름은 릴리스 버전을 포함해야 합니다. GitLab은 릴리스에 시맨틱 버전을 사용하며, 권장하는 방식입니다. (주 버전).(부 버전).(수정 버전)으로 사용하며, 버전 정책에서 자세히 설명되어 있습니다.

예를 들어, GitLab 버전 16.1.1의 경우:

  • 16은 주 버전을 나타냅니다. 주 릴리스는 16.0.0이었지만 종종 16.0으로 언급됩니다.
  • 1은 부 버전을 나타냅니다. 부 릴리스는 16.1.0이었지만 종종 16.1로 언급됩니다.
  • 1은 수정 번호를 나타냅니다.

버전 번호의 어떤 부분이든 여러 자릿수일 수 있습니다. 예를 들어, 16.10.11입니다.

릴리스 노트 설명

모든 릴리스에는 설명이 있습니다. 사용자가 원하는 텍스트를 추가할 수 있지만, 릴리스의 내용을 설명하는 변경 로그를 포함하는 것이 좋습니다. 이렇게 하면 사용자들이 게시하는 각 릴리스 간의 차이를 빠르게 스캔할 수 있습니다.

Git에서 태그 메시지 태깅은 릴리스 노트 설명에 포함될 수 있으며, 릴리스 노트에 태그 메시지 포함을 선택하여 이를 포함할 수 있습니다.

설명은 마크다운을 지원합니다.

릴리스 자산

릴리스에는 다음 유형의 자산이 포함됩니다.

소스 코드

GitLab은 주어진 Git 태그로부터 zip, tar.gz, tar.bz2, tar 아카이브된 소스 코드를 자동으로 생성합니다. 이러한 자산은 읽기 전용이며 리포지터리에서 코드를 다운로드할 수 있습니다.

링크

링크는 문서, 빌드된 이진 파일 또는 관련 자료와 같은 원하는 모든 URL입니다. 이러한 링크는 GitLab 인스턴스의 내부 링크 또는 외부 링크 모두 될 수 있습니다. 각 링크는 다음과 같은 속성을 갖습니다.

속성 설명 필수 여부
name 링크의 이름입니다. 예
url 파일을 다운로드할 URL입니다. 예
filepath url로의 리디렉트 링크입니다. 반드시 슬래시(/)로 시작해야 합니다. 자세한 내용은 이 섹션을 참조하세요. 아니요
link_type url을 통해 사용자가 다운로드할 내용의 콘텐츠 유형입니다. 자세한 내용은 이 섹션을 참조하세요. 아니요

릴리스 자산의 영구적인 링크

  • GitLab 15.9에서 소개된 것처럼, 비공개 릴리스에 대한 링크는 개인 액세스 토큰을 사용하여 접근할 수 있습니다.

릴리스와 관련된 자산은 영구적인 URL을 통해 접근할 수 있습니다. GitLab은 항상 이 URL을 실제 자산 위치로 리디렉션하므로 자산이 다른 위치로 이동하더라도 동일한 URL을 계속 사용할 수 있습니다. 이는 filepath API 속성을 사용하여 링크 생성이나 업데이트하는 동안 정의됩니다.

URL의 형식은 다음과 같습니다. 

https://host/namespace/project/-/releases/:release/downloads:filepath

예를 들어, gitlab-org 네임스페이스와 gitlab-runner 프로젝트에서 gitlab.com에서 v16.9.0-rc2 릴리스를 위한 자산을 가지고 있는 경우: 

{
  "name": "linux amd64",
  "filepath": "/binaries/gitlab-runner-linux-amd64",
  "url": "https://gitlab-runner-downloads.s3.amazonaws.com/v16.9.0-rc2/binaries/gitlab-runner-linux-amd64",
  "link_type": "other"
}

이 자산은 다음과 같은 직접 링크를 갖습니다. 

https://gitlab.com/gitlab-org/gitlab-runner/-/releases/v16.9.0-rc2/downloads/binaries/gitlab-runner-linux-amd64

자산의 물리적 위치는 언제든지 변경될 수 있으며 직접 링크는 변하지 않습니다.

릴리스가 비공개인 경우, 요청을 할 때 private_token 쿼리 매개변수나 HTTP_PRIVATE_TOKEN 헤더를 사용하여 api 또는 read_api 스코프 중 하나를 가진 개인 액세스 토큰을 제공해야 합니다. 예를 들어: 

curl --location --output filename "https://gitlab.example.com/my-group/my-project/-/releases/myrelease/downloads</path-to-file>?private_token=<your_access_token>"
curl --location --output filename --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/my-group/my-project/-/releases/myrelease/downloads</path-to-file>

최신 릴리스 자산에 대한 영구적인 링크

릴리스 자산의 영구적인 링크의 filepath를 최신 릴리스에 대한 영구적인 링크와 조합하여 사용할 수 있습니다. filepath는 반드시 슬래시(/)로 시작해야 합니다.

URL의 형식은 다음과 같습니다. 

https://host/namespace/project/-/releases/permalink/latest/downloads:filepath

이 형식은 최신 릴리스로부터 자산에 대한 영구적인 링크를 제공하기 위해 사용할 수 있습니다.

예를 들어, gitlab-org 네임스페이스와 gitlab-runner 프로젝트에서 gitlab.com에서 v16.9.0-rc2 최신 릴리스에 대한 filepath가 있는 경우: 

{
  "name": "linux amd64",
  "filepath": "/binaries/gitlab-runner-linux-amd64",
  "url": "https://gitlab-runner-downloads.s3.amazonaws.com/v16.9.0-rc2/binaries/gitlab-runner-linux-amd64",
  "link_type": "other"
}

이 자산은 다음과 같은 직접 링크를 갖습니다. 

https://gitlab.com/gitlab-org/gitlab-runner/-/releases/permalink/latest/downloads/binaries/gitlab-runner-linux-amd64

링크 유형

링크 유형으로 “Runbook,” “Package,” “Image,” “Other” 네 가지 유형이 있습니다. link_type 매개변수는 다음 네 가지 값 중 하나를 허용합니다.

  • runbook
  • package
  • image
  • other (기본값)

이 필드는 URL에는 영향을 주지 않으며 프로젝트의 릴리스 페이지에서 시각적 목적으로만 사용됩니다.

바이너리 첨부를 위한 일반적인 패키지 사용

일반 패키지를 사용하여 릴리스나 태그 파이프라인에서 생성된 아무 아티팩트를 저장하고, 개별 릴리스 항목에 바이너리 파일을 첨부하는 데 사용할 수 있습니다. 기본적으로 다음 단계를 수행해야합니다.

  1. 일반 패키지 레지스트리로 아티팩트를 푸시합니다.
  2. 패키지 링크를 릴리스에 첨부합니다.

다음 예제는 릴리스 자산을 생성하여 일반 패키지로 게시하고, 릴리스를 만드는 내용입니다. 

stages:
  - build
  - upload
  - release

variables:
  # 패키지 버전은 숫자(0-9)와 점(.)만 포함할 수 있습니다.
  # X.Y.Z 형식이어야 합니다. (예. /\A\d+\.\d+\.\d+\z/ 정규식과 일치해야 함).
  # https://docs.gitlab.com/ee/user/packages/generic_packages/#publish-a-package-file 참조
  PACKAGE_VERSION: "1.2.3"
  DARWIN_AMD64_BINARY: "myawesomerelease-darwin-amd64-${PACKAGE_VERSION}"
  LINUX_AMD64_BINARY: "myawesomerelease-linux-amd64-${PACKAGE_VERSION}"
  PACKAGE_REGISTRY_URL: "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/myawesomerelease/${PACKAGE_VERSION}"

build:
  stage: build
  image: alpine:latest
  rules:
    - if: $CI_COMMIT_TAG
  script:
    - mkdir bin
    - echo "Mock binary for ${DARWIN_AMD64_BINARY}" > bin/${DARWIN_AMD64_BINARY}
    - echo "Mock binary for ${LINUX_AMD64_BINARY}" > bin/${LINUX_AMD64_BINARY}
  artifacts:
    paths:
      - bin/

upload:
  stage: upload
  image: curlimages/curl:latest
  rules:
    - if: $CI_COMMIT_TAG
  script:
    - |
      curl --header "JOB-TOKEN: ${CI_JOB_TOKEN}" --upload-file bin/${DARWIN_AMD64_BINARY} "${PACKAGE_REGISTRY_URL}/${DARWIN_AMD64_BINARY}"
    - |
      curl --header "JOB-TOKEN: ${CI_JOB_TOKEN}" --upload-file bin/${LINUX_AMD64_BINARY} "${PACKAGE_REGISTRY_URL}/${LINUX_AMD64_BINARY}"

release:
  # 주의: 2021-02-02 기준으로 이러한 자산 링크는 로그인이 필요합니다. 자세한 내용은 다음을 참조하세요.
  # https://gitlab.com/gitlab-org/gitlab/-/issues/299384
  stage: release
  image: registry.gitlab.com/gitlab-org/release-cli:latest
  rules:
    - if: $CI_COMMIT_TAG
  script:
    - |
      release-cli create --name "릴리스 $CI_COMMIT_TAG" --tag-name $CI_COMMIT_TAG \
        --assets-link "{\"name\":\"${DARWIN_AMD64_BINARY}\",\"url\":\"${PACKAGE_REGISTRY_URL}/${DARWIN_AMD64_BINARY}\"}" \
        --assets-link "{\"name\":\"${LINUX_AMD64_BINARY}\",\"url\":\"${PACKAGE_REGISTRY_URL}/${LINUX_AMD64_BINARY}\"}"

PowerShell 사용자는 release-cli에 전달하기 전에 --assets-link 및 ConvertTo-Json에서 JSON 문자열 내의 이중 인용 부호 "를 ` (백틱)으로 이스케이핑해야 할 수 있습니다. 예를 들어: 

release:
  script:
    - $env:asset = "{`"name`":`"MyFooAsset`",`"url`":`"https://gitlab.com/upack/artifacts/download/$env:UPACK_GROUP/$env:UPACK_NAME/$($env:GitVersion_SemVer)?contentOnly=zip`"}"
    - $env:assetjson = $env:asset | ConvertTo-Json
    - release-cli create --name $CI_COMMIT_TAG --description "릴리스 $CI_COMMIT_TAG" --ref $CI_COMMIT_TAG --tag-name $CI_COMMIT_TAG --assets-link=$env:assetjson
note
작업 아티팩트를 직접 릴리스에 첨부하는 것은 권장되지 않습니다. 아티팩트는 유동적이며 동일 파이프라인에서 데이터를 전달하는 데 사용됩니다. 이는 만료되거나 누군가가 매뉴얼으로 삭제할 가능성이 있음을 의미합니다.

새로운 기능 및 총 기능 수

Tier: Free, Premium, Ultimate Offering: GitLab.com

GitLab.com에서 프로젝트의 새로운 기능 및 총 기능 수를 확인할 수 있습니다.

기능 수

총 수는 shields에 표시되며, 이는 www-gitlab-com 리포지터리의 Rake 작업에 의해 릴리스당 생성됩니다.

항목 공식
새로운 기능 프로젝트의 단일 릴리스에 대한 모든 티어의 릴리스 게시물 총 수.
총 기능 프로젝트의 모든 릴리스에 대한 릴리스 게시물의 역순 총 수.

또한, 라이선스 티어별로 수량도 표시됩니다.

항목 공식
새로운 기능 프로젝트의 단일 릴리스에 대한 단일 티어의 릴리스 게시물 총 수.
총 기능 프로젝트의 모든 릴리스에 대한 역순의 단일 티어의 릴리스 게시물 총 수.