릴리스 필드

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

타이틀

릴리스 타이틀은 생성하거나 편집할 때 릴리스 타이틀 필드를 사용하여 사용자 정의할 수 있습니다. 타이틀을 제공하지 않으면 릴리스의 태그 이름이 대신 사용됩니다.

태그 이름

릴리스 태그 이름은 릴리스 버전을 포함해야 합니다. GitLab은 릴리스에 Semantic Versioning을 사용하고 이를 권장합니다. (Major).(Minor).(Patch)를 사용하여 버전을 나타냅니다. 자세한 내용은 GitLab 버전 관리 정책을 참조하세요.

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

  • 10은 메이저 버전을 나타냅니다. 메이저 릴리스는 10.0.0이지만 종종 10.0으로 언급됩니다.
  • 5는 마이너 버전을 나타냅니다. 마이너 릴리스는 10.5.0이지만 종종 10.5로 언급됩니다.
  • 7은 패치 번호를 나타냅니다.

버전 번호의 각 부분은 다중 자릿수일 수 있습니다. 예를 들어 13.10.11입니다.

릴리스 노트 설명

모든 릴리스에는 설명이 있습니다. 원하는 어떤 텍스트든 추가할 수 있지만, 릴리스의 내용을 설명하는 변경 로그를 포함하는 것을 권장합니다. 이렇게 하면 사용자가 발행하는 각 릴리스 간의 차이를 빠르게 살펴볼 수 있습니다.

Git에서 태깅 메시지는 릴리스 노트 설명에 포함할 수 있습니다. 이는 릴리스 노트에 태그 메시지 포함을 선택함으로써 가능합니다.

설명은 Markdown을 지원합니다.

릴리스에 포함된 자산

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

소스 코드

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.com에서 gitlab-org 네임스페이스와 gitlab-runner 프로젝트에서 v11.9.0-rc2 릴리스에 대한 자산이 있는 경우: 

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

이 자산의 직접적인 링크는 다음과 같습니다: 

https://gitlab.com/gitlab-org/gitlab-runner/-/releases/v11.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.com의 gitlab-org 네임스페이스와 gitlab-runner 프로젝트에서 v11.9.0-rc2 최신 릴리스에 대한 filepath가 있는 경우: 

{
  "name": "linux amd64",
  "filepath": "/binaries/gitlab-runner-linux-amd64",
  "url": "https://gitlab-runner-downloads.s3.amazonaws.com/v11.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.Y 형식이어야 하며 /\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 사용자는 --assets-link 및 ConvertTo-Json에서 JSON 문자열 내의 이중 인용부호 "를 ` (백틱)로 이스케이프해야 할 수 있으며 이후 release-cli로 전달하기 전에 ConvertTo-Json을 사용해야 합니다. 예를 들면: 

릴리스:
  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

참고: 작업 아티팩트를 직접적으로 릴리스에 첨부하는 것은 권장되지 않습니다. 왜냐하면 아티팩트는 일시적이며 동일한 파이프라인에서 데이터를 전달하는 데 사용되기 때문에 만료될 수 있거나 누군가가 수동으로 삭제할 수 있는 위험이 있기 때문입니다.

새로운 기능 및 총 기능 수

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

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

기능 수

총 개수는 shields에 표시되며 www-gitlab-com 저장소의 Rake 작업에 의해 릴리스별로 생성됩니다.

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

이러한 수는 라이선스 티어별로도 표시됩니다.

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