集成工具

在软件开发流程中，工具链（Toolchain）是每一个大型开源项目背后默默支撑的力量，它是一系列工具的组合，在业务需求、架构设计、代码开发、产品测试、应用部署、环境监控、产品安全、性能指标等各领域中都少不了工具链的存在，小到编译和调试脚本工具，大到任何复杂的工程项目，在每一个流程步骤中工具链都贯穿其中，承担着无可替代的角色。

使用须知

平台具有完备的工具链集成体系，并致力于丰富开发者生态，从生产端到应用端，助力开发流程敏捷化，通过搭建可扩展、开放、丰富的工具链集成体系，帮助企业更快更好地进行应用开发与服务创新。平台支持集成多种类型工具链，如：持续集成、代码管理、制品仓库、代码质量分析、测试管理和项目管理工具等。

通过平台的集成功能，可将项目上正在使用的工具链集成至平台，集成后在页面中会以卡片的形式展示，并分配至指定项目中供项目成员使用，您可通过以下方式将工具链集成至平台中：

• 集成已有工具链：若您正在使用的工具链在 已支持集成的工具列表 内，可根据本文档 直接集成 至平台。

• 插件集成工具链：若平台现有工具链列表中没有您正在使用的工具链，可通过 插件集成 的方式添加至平台工具链列表中并集成，例如：Jira、禅道。若使用插件功能时，请联系技术人员获取支持。

• 自定义工具链插件：若以上两种方式并未满足您的集成需求，可根据联系技术人员获取 平台工具链插件开发规范，自定义工具链插件，真正实现工具链的灵活扩展。

提示：

• 为方便统一管理，当工具的类型和 API 地址相同时，将自动合并至同一文件夹中。

• 除平台默认支持的工具链之外，还支持使用插件的方式集成工具链，请联系技术人员获取支持。

操作步骤

1. 在左侧导航栏中，单击 工具链管理 > 工具链集成。

2. 单击 集成，平台支持集成的工具如下表所示：

   工具类型	工具名称	说明	提供方式
   持续集成	Jenkins	Jenkins 是基于 Java 开发的一种持续集成工具，用于监控持续重复的工作，旨在提供一个开放易用的软件平台，使软件的持续集成变成可能。	直接集成
   代码管理	GitLab	GitLab 是一个用于仓库管理系统的开源项目，采用 Git 作为分布式版本控制系统。
   制品仓库	Docker Registry	Docker Registry 是可以用来搭建私人 Docker 镜像的镜像仓库，可以在无法访问 Docker hub 的场景下使用 Docker 镜像。
   	Harbor	Harbor 是由 VMware 公司中国团队为企业用户设计的 Registry server 开源项目，包括了权限管理(RBAC)、LDAP、审计、管理界面、自我注册、HA 等企业必需的功能，同时针对中国用户的特点，设计镜像复制和中文支持等功能。
   	Nexus	Nexus 是一个强大的 Maven 仓库管理器，它极大地简化了自己内部仓库的维护和外部仓库的访问。利用 Nexus 您可以只在一个地方就能够完全控制访问和部署在你所维护仓库中的每个 Artifact。Nexus 是一套“开箱即用”的系统不需要数据库，它使用文件系统加 Lucene 来组织数据。Nexus 使用 ExtJS 来开发界面，利用 Restlet 来提供完整的 REST APIs，通过 m2eclipse 与 Eclipse 集成使用。Nexus 支持 WebDAV 与 LDAP 安全身份认证。
   	HCS SWR	容器镜像服务（SoftWare Repository for Container，简称 SWR）是一种支持镜像全生命周期管理的镜像仓库，提供简单易用、安全可靠的镜像管理功能。	插件集成
   代码质量分析	SonarQube	SonarQube 是一个用于代码质量管理的开源平台，用于管理源代码的质量。	直接集成
   项目管理	JIRA	JIRA 是 Atlassian 公司出品的项目与事务跟踪工具，被广泛应用于缺陷跟踪、客户服务、需求收集、流程审批、任务跟踪、项目跟踪和敏捷管理等工作领域。	插件集成
   	Zentao	禅道是一款国产开源项目管理软件。它集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体，是一款专业的研发项目管理软件，

3. 选择一个工具后，参考以下说明，配置相关参数：

   参数	说明
   集成名称	输入集成工具的名称，该名称不可与已有工具集成名称重复。
   访问地址	输入工具的访问地址。
   API 地址	输入集成工具的服务地址。服务地址的格式是：HTTP/HTTPS 协议 + IP + 端口号或 HTTP/HTTPS 协议 + 域名。公有代码仓库不支持修改默认的 API 地址。
   凭据	选择一个已创建的凭据或 创建凭据 。 提示： 集成 GitLab 时，请确保在 GitLab 侧生成的 Token 中勾选了 api 和 write_repository 权限。 集成 Jenkins 时不需填写此项，可在分配项目时添加凭据。

4. 单击 集成。集成工具后可以将工具资源分配至项目中，参考文档 分配项目 。

后续操作

GitLab

为了便于您使用代码仓库触发器，平台集成 GitLab 时，默认允许了 Webhook 和服务对本地网络的请求。然而，由于 Webhook 使用方式的特殊性 ，如果您不需要配置代码仓库触发器，或者需要满足更严格的安全要求，可 禁止 Webhook 和服务对本地网络的请求 。禁止后，将无法使用代码仓库触发器。

Nexus

对于 Nexus 中已有的 raw 仓库，如果仓库中开启了 Strict Content Type Validation 配置，可能会因为过于严格的文件校验规则，导致您在 DevOps 中无法正常往这个仓库上传文件。例如，在持续构建流水线中使用 文件上传 任务时，任务执行失败并提示 400 错误码。

如果希望往此 raw 仓库中上传文件，建议集成 Nexus 的同时取消 raw 仓库的 Strict Content Type Validation 配置：在 Nexus 中单击 raw 仓库名称，在 Storage 区域下，取消勾选该配置。