新建CodeArts服务扩展点
操作场景
服务扩展点是CodeArts的一种扩展插件，为CodeArts提供连接第三方服务的能力。
当CodeArts中的一些任务需要连接到远程第三方服务，进行一些获取数据操作时，例如连接第三方GitHub仓库获取项目源码、连接第三方Jenkins服务执行Jenkins任务等，可以通过新建扩展点来实现与相应服务的连接。
类型 |
使用场景 |
|---|---|
Docker repository |
用于连接Docker镜像仓库，连接成功后可以通过部署任务获取仓库中的Docker镜像。 |
Jenkins |
用于连接Jenkins服务，连接成功后可以在流水线中调用并执行Jenkins服务中所包含的任务。 |
Kubernetes |
用于连接Kubernetes集群，连接成功后可对Kubernetes集群下发部署任务。 |
nexus repository |
用于连接第三方私有Maven仓库，连接成功后可以通过构建任务获取该仓库中文件信息。 |
通用Git |
用于连接第三方Git仓库，连接成功后可以在构建、流水线等服务中获取该仓库的分支等信息。 |
码云Git |
用于连接码云Git账号，连接成功后可以在构建、流水线等服务中获取该账号下的仓库、分支等信息。 |
GitHub |
用于连接Github账号，连接成功后可以在构建、流水线等服务中获取该账号下的仓库、分支等信息。 |
IAM账户 |
用于委托自己账号的AK/SK给需要执行任务的账号，在该账号执行部署任务的时候可以通过AK/SK获得被委托的账号的token执行更高权限的任务。 |
CodeArts Repo HTTPS |
用于授权CodeArts服务对托管的Repo仓库进行代码下载、分支创建、分支合并、代码提交等操作。当前主要用于流水线服务的微服务变更功能模块及其相关插件。 |
Gerrit |
用于连接第三方Gerrit仓库，连接成功后可以在构建、流水线等服务中获取该仓库代码。 |
GitCode |
用于连接GitCode账号，连接成功后可以在构建、流水线等服务中获取该账号下的仓库、分支等信息。 |
前提条件
- 在CodeArts项目中拥有扩展点的编辑权限。
- 待接入的第三方服务能通过公网环境无限制地访问。
新建Docker repository服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击
，选择区域。 - 单击
，在服务列表中选择“开发与运维 > 软件开发生产线”。 - 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称，进入项目。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“Docker repository”。
- 在弹框中配置以下信息，单击“确定”。
表2 新建Docker repository服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
仓库地址
是
输入待连接的Docker仓库的地址。支持http、https协议地址。
用户名
是
输入待连接的Docker仓库的用户名。不超过256个字符。
密码
是
输入待连接的Docker仓库的密码。不超过256个字符。
- 新建成功，页面中显示新建的扩展点名称。
新建Jenkins服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“Jenkins”。
- 在弹框中配置以下信息，单击“确定”。
表3 新建Jenkins服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
Server URL
是
输入待连接的Jenkins服务的地址。支持输入格式为“http://ip:端口号”或者“https://ip:端口号”的地址。
用户名
是
输入待连接的Jenkins服务的用户名。不超过300个字符。
密码
是
输入待连接的Jenkins服务的密码。不超过300个字符。
- 新建成功，页面中显示新建的扩展点名称。
新建Kubernetes服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“Kubernetes”。
- 在弹框中配置以下信息，单击“验证并确定”。
表4 新建Kubernetes服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
Kubernetes URL
是
输入待连接的集群的server地址，可通过“kubeconfig.json”中搜索“server”获取。
Kubeconfig
是
输入待连接的集群的“kubeconfig.json”文件的全部内容。
- 验证成功，关闭弹窗后页面中显示新建的扩展点名称。
新建nexus repository服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“nexus repository”。
- 在弹框中配置以下信息，单击“确定”。
表5 新建nexus repository服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
仓库地址
是
输入待连接的nexus仓库的地址。支持http、https协议地址。
用户名
是
输入待连接的nexus仓库的用户名。不超过300个字符。
密码
是
输入待连接的nexus仓库的密码。不超过300个字符。
- 新建成功，页面中显示新建的扩展点名称。
新建通用Git服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“通用Git”。
- 在弹框中配置以下信息，单击“确定”。
表6 新建通用Git服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
Git仓库Url
是
输入待连接的Git仓库的HTTPS地址。
用户名
否
输入待连接的Git仓库的用户名。不超过300个字符。
密码或Access Token
否
输入待连接的Git仓库的密码。不超过300个字符。
- 新建成功，页面中显示新建的扩展点名称。
新建码云Git服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“码云Git”。
- 在弹框中配置以下信息，单击“授权并确定”。
表7 新建码云Git服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
验证方式
是
支持两种验证方式。
- OAuth认证：选择此方式，单击“授权并确定”后，需要登录码云进行手动授权。
- AccessToken认证：选择此方式，需要输入通过码云获取的私人令牌。获取方法请参考码云官网。
- 授权成功，关闭弹窗后页面中显示新建的扩展点名称。
新建GitHub服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“GitHub”。
- 在弹框中配置以下信息，单击“授权并确定”。
表8 新建GitHub服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
验证方式
是
支持两种验证方式。
- OAuth认证：选择此方式，单击“授权并确定”后，需要登录GitHub进行手动授权。
- AccessToken认证：选择此方式，需要输入通过GitHub获取的AccessToken。获取方法请参考GitHub官网。
- 授权成功，关闭弹窗后页面中显示新建的扩展点名称。
新建IAM账户服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“IAM账户”。
- 在弹框中配置以下信息，单击“确定”。
- 新建成功，页面中显示新建的扩展点名称。
新建CodeArts Repo HTTPS服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“CodeArts Repo HTTPS”。
- 在弹框中配置以下信息，单击“确定”。
表10 新建CodeArts Repo HTTPS服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
CodeArts Repo地址
是
输入待连接的CodeArts Repo仓库的HTTPS地址。
进入目标仓库，单击“克隆/下载”，在弹框中选择“用HTTPS克隆”，即可获取仓库地址。
用户名
否
输入待连接的CodeArts Repo仓库的HTTPS用户名。
在导航栏中单击用户名，选择“个人设置”。在“代码托管 > HTTPS密码”页面可以获取用户名。
密码
否
输入待连接的CodeArts Repo仓库的HTTPS密码。
在导航栏中单击用户名，选择“个人设置”。在“代码托管 > HTTPS密码”页面可以获取密码。
- 新建成功，页面中显示新建的扩展点名称。
新建Gerrit服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“Gerrit”。
- 在弹框中配置以下信息，单击“确定”。
表11 新建Gerrit服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
Gerrit地址
是
输入待连接的Gerrit仓库的地址。支持https协议地址。
用户名
否
输入待连接的Gerrit仓库的用户名。不超过300个字符。
密码
否
输入待连接的Gerrit仓库的密码。不超过300个字符。
- 新建成功，页面中显示新建的扩展点名称。
新建GitCode服务扩展点
- 进入CodeArts首页。
- 登录控制台，单击，选择区域。
- 单击，在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 登录控制台，单击
- 在CodeArts首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在下拉列表中选择“GitCode”。
- 在弹框中配置以下信息，单击“确定”。
表12 新建GitCode服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
Token
是
输入GitCode获取的个人访问密钥。获取方法请参考GitCode官网。
- 授权成功，关闭弹窗后页面中显示新建的扩展点名称。
