gitlab-ci.yml

# 自定义默认配置
default:
  # 基础镜像
  image: wener/node:docker
  cache:
    # 缓存仓库里所有 untracked 文件
    untracked: true
    # 缓存按分支划分 - 如果有 tag 这个会是 tag 名字
    key: '$CI_COMMIT_REF_NAME'
    # 常见的缓存目录
    paths:
      - node_modules/
      - .yarn/
      - .cache/
      - .next/
      - packages/server/.next/cache/

docker login -u "$CI_REGISTRY_USER" -p "$CI_REGISTRY_PASSWORD" $CI_REGISTRY
# 常用 $CI_REGISTRY_IMAGE:$CI_COMMIT_REF_SLUG
docker build --pull -t "$CI_REGISTRY_IMAGE:$CI_COMMIT_REF_SLUG" ./build
docker push "$CI_REGISTRY_IMAGE:$CI_COMMIT_REF_SLUG"

build:
  script: npm run build
  only:
    # 简单配置 - refs
    # 完整匹配 - master 分支运行
    - master
    # 支持正则 匹配 tag 或 branch - 如果 排除了 branches 则是匹配 tag
    - /^issue-.*$/i

    # 高级配置
    # 不指定默认则是 refs 匹配
    refs:
      - master
      - schedules
    # 变量匹配
    variables:
      - $CI_COMMIT_MESSAGE =~ /run-end-to-end-tests/ # 匹配变量
      - $RELEASE == "staging" # 变量满足
      - $STAGING # 有变量
      # 复杂条件变量
      - ($CI_COMMIT_BRANCH == "master" || $CI_COMMIT_BRANCH == "develop") && $MY_VARIABLE
    # 匹配变化文件
    # 只有在 branches external_pull_requests merge_requests 有效
    changes:
      - README.md
      - "*.md" # 例如 从新生成文档
      - base/Dockerfile # 例如 重构基础镜像
      - "**/*.sql" # 例如 数据库迁移
    # 要求开启了 k8s 服务
    kubernetes: active
  except:
    # 支持使用关键词 - 分支不触发
    - branches
    # 可包含仓库信息匹配 - 用于 fork 场景
    - /^release/.*$/@gitlab-org/gitlab

build:
  script: npm run build
  rules:
    - if: '$CI_COMMIT_BRANCH == "master"'
      when: delayed
      start_in: '3 hours'
      allow_failure: true
    # 要求有变化文件
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
      changes:
        - Dockerfile
      when: manual
      allow_failure: true
build:
  script: npm run build
  rules:
    # 前两个条件不满足才运行
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
      when: never
    - if: '$CI_PIPELINE_SOURCE == "schedule"'
      when: never
    - when: on_success

build:
  script: npm run build
  rules:
    # 常见
    - if: $CI_COMMIT_TAG # 有 tag
    - if: $CI_COMMIT_BRANCH # 分支推送
    - if: '$CI_COMMIT_BRANCH == "main"' # 主分支
    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH' # 默认分支
    - if: '$CI_COMMIT_BRANCH =~ /regex-expression/' # 分支匹配

cache:
  paths:
    - my/files

rspec:
  script: test
  cache:
    key: rspec
    paths:
      - binaries/

workflow:
  rules:
    - if: $CI_COMMIT_MESSAGE =~ /-draft$/
      when: never
    - if: $CI_COMMIT_REF_NAME =~ /feature/
      variables:
        IS_A_FEATURE: 'true' # 覆盖变量
    - when: always #

# AlpineLinux
apk add gitlab-release-cli -X https://mirrors.aliyun.com/alpine/edge/testing

# shell executor 需要安装命令行根据
curl --location --output /usr/local/bin/release-cli "https://release-cli-downloads.s3.amazonaws.com/latest/release-cli-linux-amd64"
chmod +x /usr/local/bin/release-cli

# 确保可用
release-cli -v

# 基于 tag release
job:
  release:
    tag_name: $CI_COMMIT_TAG
    description: 'Release description'
    # name - 默认为 tag_name
    # ref - 如果没有 tag_name 可以通过 ref 创建
    # milestones - 关联里程碑
    # released_at: '2021-03-15T08:00:00Z' # 不指定会自动生成

---
# 直接调用命令行 - 可以添加 assets-link
# gitlab 内置 artifact https://gitlab.com/org/proj/-/jobs/<JOB_ID>/artifacts/browse
release:
  stage: release
  image: registry.gitlab.com/gitlab-org/release-cli:v0.4.0
  # 手动触发
  when: manual
  rules:
    - if: $CI_COMMIT_TAG
      when: never

  script:
    - >
      release-cli create --name release-branch-$CI_JOB_ID --description release-branch-$CI_COMMIT_REF_NAME-$CI_JOB_ID
      --tag-name job-$CI_JOB_ID --ref $CI_COMMIT_SHA
      --assets-link '{"name":"Asset1","url":"https://<domain>/some/location/1","link_type":"other","filepath":"xzy"}'
      --assets-link '{"name":"Asset2","url":"https://<domain>/some/location/2"}'
      --milestone "v1.0.0" --milestone "v1.0.0-rc"
      --released-at "2020-06-30T07:00:00Z"

---
release_job:
  stage: release
  image: registry.gitlab.com/gitlab-org/release-cli:latest
  rules:
    - if: $CI_COMMIT_TAG # Run this job when a tag is created manually
  script:
    - echo 'running release_job'
  release:
    name: 'Release $CI_COMMIT_TAG'
    description: 'Created using the release-cli $EXTRA_DESCRIPTION' # $EXTRA_DESCRIPTION must be defined
    tag_name: '$CI_COMMIT_TAG' # elsewhere in the pipeline.
    ref: '$CI_COMMIT_TAG'
    milestones:
      - 'm1'
      - 'm2'
      - 'm3'
    released_at: '2020-07-15T08:00:00Z' # Optional, is auto generated if not defined, or can use a variable.
---
prepare_job:
  stage: prepare # This stage must run before the release stage
  rules:
    - if: $CI_COMMIT_TAG
      when: never # Do not run this job when a tag is created manually
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH # Run this job when commits are pushed or merged to the default branch
  script:
    - echo "EXTRA_DESCRIPTION=some message" >> variables.env # Generate the EXTRA_DESCRIPTION and TAG environment variables
    - echo "TAG=v$(cat VERSION)" >> variables.env # and append to the variables.env file
  artifacts:
    reports:
      dotenv: variables.env # Use artifacts:reports:dotenv to expose the variables to other jobs

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 # Do not run this job when a tag is created manually
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH # Run this job when commits are pushed or merged to the default branch
  script:
    - echo 'running release_job for $TAG'
  release:
    name: 'Release $TAG'
    description: 'Created using the release-cli $EXTRA_DESCRIPTION' # $EXTRA_DESCRIPTION and the $TAG
    tag_name: '$TAG' # variables must be defined elsewhere
    ref: '$CI_COMMIT_SHA' # in the pipeline. For example, in the
    milestones: # prepare_job
      - 'm1'
      - 'm2'
      - 'm3'
    released_at: '2020-07-15T08:00:00Z' # Optional, is auto generated if not defined, or can use a variable.

pages:
  script:
    - yarn
    - yarn build:public
  artifacts:
    # 必须是 public 目录
    paths:
      - public
  only:
    - master

build-tag:
  only:
    # 指定分支
    - master
    # 必须有 tag
    - tags

rules:
  # 没有 tag 的时候才执行
  - if: $CI_COMMIT_TAG != ""
    when: on_success
  - when: never

only:
  variables:
    - $CI_DEFAULT_BRANCH == $CI_COMMIT_REF_NAME