릴리스 CI/CD 예제

GitLab 릴리스 기능은 유연하여 워크플로에 맞게 구성할 수 있습니다. 이 페이지에는 릴리스 작업의 예제 CI/CD가 포함되어 있습니다. 각 예제는 CI/CD 파이프라인에서 릴리스를 생성하는 방법을 보여줍니다.

Git 태그가 생성될 때 릴리스 생성

이 CI/CD 예제에서 릴리스는 다음 중 하나의 이벤트로 트리거됩니다.

  • 리포지토리에 Git 태그를 푸시하는 경우
  • UI에서 Git 태그를 생성하는 경우

이 방법은 Git 태그를 수동으로 만들고 그 결과로 릴리스를 생성하려는 경우 사용할 수 있습니다.

참고: UI에서 Git 태그를 생성할 때 릴리스 노트를 제공하지 마세요. 릴리스 노트를 제공하면 파이프라인이 실패합니다.

다음은 예제 .gitlab-ci.yml 파일의 _추출_에서 주요 포인트입니다. - rules stanza는 작업이 파이프라인에 추가되는 조건을 정의합니다. - Git 태그는 릴리스의 이름과 설명에 사용됩니다. 

release_job:
  stage: release
  image: registry.gitlab.com/gitlab-org/release-cli:latest
  rules:
    - if: $CI_COMMIT_TAG                 # 태그가 생성될 때 이 작업을 실행합니다.
  script:
    - echo "running release_job"
  release:                               # 사용 가능한 속성에 대해서는 https://docs.gitlab.com/ee/ci/yaml/#release를 참조하세요
    tag_name: '$CI_COMMIT_TAG'
    description: '$CI_COMMIT_TAG'

기본 브랜치로 커밋이 병합될 때 릴리스 생성

이 CI/CD 예제에서 릴리스는 기본 브랜치에 커밋이 병합될 때 트리거됩니다. 이 방법은 릴리스 워크플로가 수동으로 태그를 만들지 않는 경우 사용할 수 있습니다.

다음 예제 .gitlab-ci.yml 파일의 _추출_에서 주요 포인트입니다. - Git 태그, 설명 및 참조가 파이프라인에서 자동으로 생성됩니다. - 수동으로 태그를 만든 경우 release_job 작업은 실행되지 않습니다. 

release_job:
  stage: release
  image: registry.gitlab.com/gitlab-org/release-cli:latest
  rules:
    - if: $CI_COMMIT_TAG
      when: never                                  # 수동으로 태그를 생성할 때는 이 작업을 실행하지 마세요
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH  # 커밋이 푸시되거나 기본 브랜치로 병합될 때 이 작업을 실행하세요
  script:
    - echo "running release_job for $TAG"
  release:                                         # 사용 가능한 속성에 대해서는 https://docs.gitlab.com/ee/ci/yaml/#release를 참조하세요
    tag_name: 'v0.$CI_PIPELINE_IID'                # 버전은 파이프라인마다 증가합니다.
    description: 'v0.$CI_PIPELINE_IID'
    ref: '$CI_COMMIT_SHA'                          # 태그는 파이프라인 SHA에서 생성됩니다.

참고: before_script 또는 script에서 설정된 환경 변수는 동일한 작업에서 확장할 수 없습니다. 애초에 확장할 수 있도록 변수를 설정하는 방법을 자세히 읽어보세요.

사용자 정의 스크립트에서 릴리스 메타데이터 생성

이 CI/CD 예제에서 릴리스 준비 작업은 유연성을 높이기 위해 별도의 작업으로 분할됩니다.

  • prepare_job 작업은 릴리스 메타데이터를 생성합니다. 사용자 정의 이미지를 포함한 모든 이미지를 사용하여 작업을 실행할 수 있습니다. 생성된 메타데이터는 변수 파일 variables.env에 저장됩니다. 이 메타데이터는 하향 작업으로 전달됩니다.
  • release_job은 변수 파일에 저장된 메타데이터를 사용하여 릴리스를 생성합니다. 해당 변수가 준비된 변수 파일로 전달됩니다. 이 작업은 릴리스 CLI를 포함하고 있기 때문에 registry.gitlab.com/gitlab-org/release-cli:latest 이미지를 사용해야 합니다. 
prepare_job:
  stage: prepare                                              # 이 스테이지는 릴리스 스테이지보다 먼저 실행되어야 합니다.
  rules:
    - if: $CI_COMMIT_TAG
      when: never                                             # 수동으로 태그를 생성할 때는 이 작업을 실행하지 마세요
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH             # 커밋이 푸시되거나 기본 브랜치로 병합될 때 이 작업을 실행하세요
  script:
    - echo "EXTRA_DESCRIPTION=some message" >> variables.env  # EXTRA_DESCRIPTION 및 TAG 환경 변수를 생성하고 variables.env 파일에 추가합니다
    - echo "TAG=v$(cat VERSION)" >> variables.env             # 그리고 variables.env 파일에 추가합니다
  artifacts:
    reports:
      dotenv: variables.env                                   # 변수를 다른 작업에서 노출하려면 artifacts:reports:dotenv를 사용하세요

release_job:
  stage: release
  image: registry.gitlab.com/gitlab-org/release-cli:latest
  needs:
    - job: prepare_job
      artifacts: true
  rules:
    - if: $CI_COMMIT_TAG
      when: never                                  # 수동으로 태그를 생성할 때는 이 작업을 실행하지 마세요
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH  # 커밋이 푸시되거나 기본 브랜치로 병합될 때 이 작업을 실행하세요
  script:
    - echo "running release_job for $TAG"
  release:
    name: '릴리스 $TAG'
    description: '릴리스 CLI를 사용하여 생성된 $EXTRA_DESCRIPTION'  # $EXTRA_DESCRIPTION 및 $TAG 환경 변수는 다른 곳에서 정의되어야 합니다
    tag_name: '$TAG'                                                 # 예를 들어, prepare_job에서 정의됩니다
    ref: '$CI_COMMIT_SHA'                                            # 파이프라인에서 생성됩니다
    milestones:                                                      # prepare_job에 예를 들어 정의될 수 있습니다
      - 'm1'
      - 'm2'
      - 'm3'
    released_at: '2020-07-15T08:00:00Z'  # 선택 사항, 정의되지 않은 경우 자동으로 생성되거나 변수를 사용할 수 있습니다.
    assets:
      links:
        - name: 'asset1'
          url: 'https://example.com/assets/1'
        - name: 'asset2'
          url: 'https://example.com/assets/2'
          filepath: '/pretty/url/1' # 선택 사항
          link_type: 'other' # 선택 사항

릴리스 생성 시 여러 파이프라인 건너뛰기

CI/CD 작업을 사용하여 릴리스를 생성하는 경우 해당 태그가 이미 존재하지 않는 경우 여러 파이프라인을 트리거할 수 있습니다. 이것이 어떻게 발생할 수 있는지 이해하려면 다음 워크플로를 고려해 보세요.

  • 먼저 태그, 나중에 릴리스:
    1. UI를 통해 태그가 생성됩니다.
    2. 태그 파이프라인이 트리거되고 릴리스 작업이 실행됩니다.
    3. 릴리스가 생성됩니다.
  • 먼저 릴리스, 나중에 태그:
    1. 커밋이 기본 브랜치에 푸시되거나 병합될 때 파이프라인이 트리거됩니다. 파이프라인은 릴리스 작업을 실행합니다.
    2. 릴리스가 생성됩니다.
    3. 태그가 생성됩니다.
    4. 태그 파이프라인이 트리거됩니다. 파이프라인은 릴리스 작업을 실행합니다.

두 번째 워크플로에서 릴리스 작업은 여러 파이프라인에서 실행됩니다. 이를 방지하려면 태그 파이프라인에서 릴리스 작업이 실행되어야 하는지 여부를 결정하는 workflow:rules 키워드를 사용할 수 있습니다. 

release_job:
  rules:
    - if: $CI_COMMIT_TAG
      when: never                                  # 태그 파이프라인에서 이 작업을 실행하지 마세요
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH  # 커밋이 푸시되거나 기본 브랜치로 병합될 때 이 작업을 실행하세요
  script:
    - echo "릴리스 생성"
  release:
    name: '내 멋진 릴리스'
    tag_name: '$CI_COMMIT_TAG'