新建CodeArts服务扩展点

操作场景

服务扩展点是CodeArts的一种扩展插件，为CodeArts提供连接第三方服务的能力。

当CodeArts中的一些任务需要连接到远程第三方服务，进行一些获取数据操作时，例如连接第三方GitHub仓库获取项目源码、连接第三方Jenkins服务执行Jenkins任务等，可以通过新建扩展点来实现与相应服务的连接。

CodeArts支持以下扩展点。

表1 服务扩展点
类型	使用场景
Docker repository	用于连接Docker镜像仓库，连接成功后可以通过部署服获取仓库中的Docker镜像。
Jenkins	用于连接Jenkins服务，连接成功后可以在流水线中调用并执行Jenkins服务中所包含的任务。
Kubernetes	用于连接Kubernetes集群，连接成功后可对Kubernetes集群下发部署任务。
nexus repository	用于连接第三方私有Maven仓库，连接成功后可以通过构建任务获取该仓库中文件信息。
通用Git	用于连接第三方Git仓库，连接成功后可以在流水线、构建等服务中获取该仓库的分支等信息。
GitHub	用于连接Github账号，连接成功后可以在流水线、构建等服务中获取该账号的仓库、分支等信息。
IAM账户	用于委托自己账号的AK/SK给需要执行任务的账号，在该账号执行部署任务的时候可以通过AK/SK获得被委托的账号的token执行更高权限的任务。
CodeArts Repo HTTPS	用于授权CodeArts服务对托管的Repo仓库进行代码下载、分支创建、分支合并、代码提交等操作。当前主要用于流水线服务的微服务变更功能模块及其相关插件。
GitLab	用于连接GitLab仓库，连接成功后可以在流水线、构建等服务中获取该仓库的分支等信息。

前提条件

在CodeArts项目中拥有扩展点的编辑权限。
待接入的第三方服务能通过公网环境无限制地访问。

新建Docker repository服务扩展点

进入CodeArts首页。
1. 登录CodeArts控制台，单击，选择区域。
2. 单击“立即使用”。
单击目标项目名称，进入项目。
在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
单击“新建服务扩展点”，在下拉列表中选择“Docker repository”。

在弹框中配置以下信息，单击“确定”。

表2 新建Docker repository服务扩展点
配置项	是否必填	说明
连接名称	是	自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
仓库地址	是	输入待连接的Docker仓库的地址。支持http、https协议地址。
用户名	是	输入待连接的Docker仓库的用户名。不超过256个字符。
密码	是	输入待连接的Docker仓库的密码。不超过256个字符。

新建成功，页面中显示新建的扩展点名称。

新建Jenkins服务扩展点

“拉美-圣地亚哥”、“土耳其-伊斯坦布尔”暂不支持新建Jenkins服务扩展点。

进入CodeArts首页。
1. 登录CodeArts控制台，单击，选择区域。
2. 单击“立即使用”。
在CodeArts首页中单击目标项目名称。
在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
单击“新建服务扩展点”，在下拉列表中选择“Jenkins”。

在弹框中配置以下信息，单击“确定”。

表3 新建Jenkins服务扩展点
配置项	是否必填	说明
连接名称	是	自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
Server URL	是	输入待连接的Jenkins服务的地址。支持输入格式为“http://ip:端口号”或者“https://ip:端口号”的地址。
用户名	是	输入待连接的Jenkins服务的用户名。不超过300个字符。
密码	是	输入待连接的Jenkins服务的密码。不超过300个字符。

新建成功，页面中显示新建的扩展点名称。

新建Kubernetes服务扩展点

进入CodeArts首页。
1. 登录CodeArts控制台，单击，选择区域。
2. 单击“立即使用”。
在CodeArts首页中单击目标项目名称。
在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
单击“新建服务扩展点”，在下拉列表中选择“Kubernetes”。

在弹框中配置以下信息，单击“验证并确定”。

表4 新建Kubernetes服务扩展点
配置项	是否必填	说明
连接名称	是	自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
Kubernetes URL	是	输入待连接的集群的server地址，可通过“kubeconfig.json”中搜索“server”获取。
Kubeconfig	是	输入待连接的集群的“kubeconfig.json”文件的全部内容。

验证成功，关闭弹窗后页面中显示新建的扩展点名称。

新建nexus repository服务扩展点

“拉美-圣地亚哥”、“土耳其-伊斯坦布尔”暂不支持新建nexus repository服务扩展点。

进入CodeArts首页。
1. 登录CodeArts控制台，单击，选择区域。
2. 单击“立即使用”。
在CodeArts首页中单击目标项目名称。
在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
单击“新建服务扩展点”，在下拉列表中选择“nexus repository”。

在弹框中配置以下信息，单击“确定”。

表5 新建nexus repository服务扩展点
配置项	是否必填	说明
连接名称	是	自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
仓库地址	是	输入待连接的nexus仓库的地址。支持http、https协议地址。
用户名	是	输入待连接的nexus仓库的用户名。不超过300个字符。
密码	是	输入待连接的nexus仓库的密码。不超过300个字符。

新建成功，页面中显示新建的扩展点名称。

新建通用Git服务扩展点

进入CodeArts首页。
1. 登录CodeArts控制台，单击，选择区域。
2. 单击“立即使用”。
在CodeArts首页中单击目标项目名称。
在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
单击“新建服务扩展点”，在下拉列表中选择“通用Git”。

在弹框中配置以下信息，单击“确定”。

表6 新建通用Git服务扩展点
配置项	是否必填	说明
连接名称	是	自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
Git仓库Url	是	输入待连接的Git仓库的HTTPS地址。
用户名	否	输入待连接的Git仓库的用户名。不超过300个字符。
密码或Access Token	否	输入待连接的Git仓库的密码。不超过300个字符。

新建成功，页面中显示新建的扩展点名称。

新建GitHub服务扩展点

“拉美-圣地亚哥”暂不支持新建GitHub服务扩展点。

进入CodeArts首页。
1. 登录CodeArts控制台，单击，选择区域。
2. 单击“立即使用”。
在CodeArts首页中单击目标项目名称。
在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
单击“新建服务扩展点”，在下拉列表中选择“GitHub”。

在弹框中配置以下信息，单击“授权并确定”。

表7 新建GitHub服务扩展点
配置项	是否必填	说明
连接名称	是	自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
验证方式	是	支持两种验证方式。 OAuth认证：选择此方式，单击“授权并确定”后，需要登录GitHub进行手动授权。 AccessToken认证：选择此方式，需要输入通过GitHub获取的AccessToken。获取方法请参考GitHub官网。

授权成功，关闭弹窗后页面中显示新建的扩展点名称。

新建IAM账户服务扩展点

进入CodeArts首页。
1. 登录CodeArts控制台，单击，选择区域。
2. 单击“立即使用”。
在CodeArts首页中单击目标项目名称。
在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
单击“新建服务扩展点”，在下拉列表中选择“IAM账户”。

在弹框中配置以下信息，单击“确定”。

表8 新建IAM账户服务扩展点
配置项	是否必填	说明
连接名称	是	自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
Access Key Id	是	输入通过“我的凭证”页面获取的AK。获取方法请参考新增访问密钥。
Secret Access Key	是	输入通过“我的凭证”页面获取的SK。获取方法请参考新增访问密钥。

新建成功，页面中显示新建的扩展点名称。

新建CodeArts Repo HTTPS服务扩展点

进入CodeArts首页。
1. 登录CodeArts控制台，单击，选择区域。
2. 单击“立即使用”。
在CodeArts首页中单击目标项目名称。
在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
单击“新建服务扩展点”，在下拉列表中选择“CodeArts Repo HTTPS”。

在弹框中配置以下信息，单击“确定”。

表9 新建CodeArts Repo HTTPS服务扩展点
配置项	是否必填	说明
连接名称	是	自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
CodeArts Repo地址	是	输入待连接的CodeArts Repo仓库的HTTPS地址。进入目标仓库，单击“克隆/下载”，在弹框中选择“用HTTPS克隆”，即可获取仓库地址。
用户名	否	输入待连接的CodeArts Repo仓库的HTTPS用户名。在导航栏中单击用户名，选择“个人设置”。在“代码托管 > HTTPS密码”页面可以获取用户名。
密码	否	输入待连接的CodeArts Repo仓库的HTTPS密码。在导航栏中单击用户名，选择“个人设置”。在“代码托管 > HTTPS密码”页面可以获取密码。

新建成功，页面中显示新建的扩展点名称。

新建GitLab服务扩展点

进入CodeArts首页。
1. 登录CodeArts控制台，单击，选择区域。
2. 单击“立即使用”。
在CodeArts首页中单击目标项目名称。
在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
单击“新建服务扩展点”，在下拉列表中选择“GitLab”。

在弹框中配置以下信息，单击“确定”。

**表10** 新建GitLab服务扩展点
配置项	是否必填	说明
连接名称	是	自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
GitLab地址	是	输入待连接的GitLab仓库的HTTPS地址。
用户名	否	输入待连接的GitLab仓库的用户名。
Access Token	否	输入待连接的GitLab仓库的Access Token。获取方法请参考GitLab官网。