如何使用极狐GitLab CI/CD Component & Catalog？【下】

极狐GitLab 是 GitLab 在中国的发行版，专门面向中国程序员和企业提供企业级一体化 DevOps 平台，用来帮助用户实现需求管理、源代码托管、CI/CD、安全合规，而且所有的操作都是在一个平台上进行，省事省心省钱。可以一键安装极狐GitLab，详情可以参考极狐GitLab 下载安装官网。

GitLab 中文版学习资料

• 驭码CodeRider 官网：https://coderider.gitlab.cn/
• GitLab 中文版官网：https://gitlab.cn
• GitLab 中文文档：https://docs.gitlab.cn
• GitLab 中文下载安装：https://gitlab.cn/install

关联阅读

• 如何使用极狐GitLab CI/CD Component & Catalog？【上】
• include 语法减少 CI/CD Pipeline 代码冗余，提升构建效率
• 极狐GitLab 企业级 CI/CD 规模化落地实践指南（一）

CI/CD Catalog

“赠人玫瑰，手有余香”，好东西要学会分享。CI/CD Catalog（目录，下面统称目录）是一个集中式的 Hub，开发人员或企业/组织可以将其开发且经过验证的 CI/CD component 发布到目录中，这样其他开发人员或企业/组织就能够通过浏览/查找 CI/CD 目录来找到符合企业自身需求的 component，然后直接使用这些 component 来快速构建流水线。速构建流水线。任何人都可以创建 component 并发布到目录中，因此，CI/CD 目录解决了 CI/CD component 的三个问题：易发现性、复用性及开放性。CI/CD 目录能帮助企业打造内部的 CI/CD component 单一可信源。

极狐GitLab 自 16.1 版本开始引入目录功能（Experimental），在 16.7 版本中将其升级为 Beta 版本。

下面为大家揭秘极狐GitLab CI/CD 目录的用法。

01 将项目标记为目录资源

首先要将存放 component 的项目标记为目录资源，发布的 component 才能够被其他用户检索、使用。通过**项目 --> 通用 --> 可见性、项目功能、权限 --> CI/CD 目录资源（Beta）**来开启此功能。

注意：在创建项目的时候，一定要写清楚项目描述以及 README.md，这些是能够帮助用户快速了解此 component 功能的重要信息。

02 发布 component 到目录资源

将项目下的 component 发布到目录资源中非常简单，在.gitlab-ci.yml文件中写入如下内容即可：

create-release:
  stage: deploy
  image: registry.gitlab.com/gitlab-org/release-cli:latest
  script: echo "Creating release $CI_COMMIT_TAG"
  rules:
    - if: $CI_COMMIT_TAG
  release:
    tag_name: $CI_COMMIT_TAG
    description: "Release $CI_COMMIT_TAG of components in $CI_PROJECT_PATH"
1
2
3
4
5
6
7
8
9

上面的代码显示，当创建 tag 的时候，就会自动触发此流水线，然后发布一个同 tag 的 component 到目录资源中。比如，当创建 3.0.0 tag 的时候，就会触发流水线自动执行：

构建日志会显示，3.0.0 的 component 发布成功，同时给出了 component 对应的地址。

最后可以在下面的检索步骤中，在 CI/CD 目录中看到对应的 component。

03 检索 CI/CD 目录

一旦 component 发布成功，就可以在目录中检索到了。通过极狐GitLab 侧边栏中的搜索或转到 --> 探索 --> CI/CD目录来找到自己发布或自己所需的component。

上面的图中，在 CI/CD 目录中就有两个可用的 component：cicd-catalog（版本 1.0.0） 和 docker-image-build（版本 3.0.0）。点击想用的 component 就可以在对应的 README 文件中看到 component 对应的功能和使用方法。

使用目录资源中的 component 和单独使用一个 component 没有什么不同，只需要使用 include:component 语法即可在 CI/CD 流水线中引用。

未来可期

CI/CD component 和 CI/CD 目录当前都在 Beta 版本，还没有 GA，但是这两个功能毫无疑问将为用户加速构建 CI/CD 流水线带来极大的便利，企业如果用好这两个功能，就能进一步管理好企业内部的 CI/CD 流水线。