操作场景
服务扩展点是CodeArts的一种扩展插件，为CodeArts提供连接第三方服务的能力。
当CodeArts中的一些任务需要连接到远程第三方服务，进行一些获取数据操作时，例如连接第三方GitHub仓库获取项目源码、连接第三方Jenkins服务执行Jenkins任务等，可以通过新建扩展点来实现与相应服务的连接。
CodeArts支持以下扩展点。
表1 服务扩展点 类型 | 使用场景 |
|---|
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账号。连接成功后，可以在流水线、构建等服务中获取该账号的仓库、分支等信息。 |
AGC | 用于连接AGC Connect API。连接成功后，可以在流水线中使用该服务。 |
新建服务扩展点
- 进入CodeArts首页。
- 登录CodeArts控制台，单击
，根据需要选择已开通CodeArts的区域。 - 单击“前往工作台”。
如果当前账号采用的是历史计费模式（详情请参考历史计费模式说明），则单击“立即使用”。
- 单击目标项目名称，进入项目。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”，在弹框中选择类型。
- 完成扩展点信息的配置。
新建成功后，页面中显示新建的扩展点名称。
各类服务扩展点的配置参数如下。
Docker repository
表2 新建Docker repository服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
仓库地址 | 待连接的Docker仓库的地址，支持HTTP、HTTPS协议地址。 |
用户名 | 待连接的Docker仓库的用户名。 |
密码 | 待连接的Docker仓库的密码。 |
Jenkins
表3 新建Jenkins服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
Server URL | 待连接的Jenkins服务的地址。支持输入格式为“http://IP:端口号”或“https://IP:端口号”的地址。 |
用户名 | 待连接的Jenkins服务的用户名。 |
密码 | 待连接的Jenkins服务的密码。 |
Kubernetes
表4 新建Kubernetes服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
Kubernetes URL | 待连接集群的server地址，可通过在集群配置文件“kubeconfig.json”中搜索“server”获取。 |
Kubeconfig | 待连接集群的配置信息，可输入集群配置文件“kubeconfig.json”的全部内容。 |
nexus repository
表5 新建nexus repository服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
仓库地址 | 待连接的Nexus仓库的地址，支持HTTP、HTTPS协议地址。 |
用户名 | 待连接的Nexus仓库的用户名。 |
密码 | 待连接的Nexus仓库的密码。 |
通用Git
表6 新建通用Git服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
Git仓库Url | 待连接的Git仓库的HTTPS地址，例如：https://*.*.*.*/user/repo.git。 |
用户名 | 待连接的Git仓库的用户名。 该参数为可选参数，当仓库需要验证用户名时配置。 |
密码或Access Token | 待连接的Git仓库的密码或Access Token。 该参数为可选参数，当仓库需要验证密码或Access Token时配置。 |
码云Git
表7 新建码云Git服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
验证方式 | 支持两种验证方式。 - OAuth认证：选择此方式，单击“授权并确定”后，需要登录码云进行手动授权。
- AccessToken认证：选择此方式，需要输入通过码云获取的私人令牌。获取方法请参考码云官网。
|
GitHub服务
表8 新建GitHub服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
验证方式 | 支持两种验证方式。 - OAuth认证：选择此方式，单击“授权并确定”后，需要登录GitHub进行手动授权。
- AccessToken认证：选择此方式，需要输入通过GitHub获取的access token。获取方法请参考GitHub官网。
|
IAM账户
表9 新建IAM账户服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
Access Key Id | 待连接IAM用户的AK。通过“我的凭证”页面获取，获取方法请参考新增访问密钥。 |
Secret Access Key | 待连接IAM用户的SK。通过“我的凭证”页面获取，获取方法请参考新增访问密钥。 |
CodeArts Repo HTTPS
表10 新建CodeArts Repo HTTPS服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
CodeArts Repo地址 | 待连接的CodeArts Repo仓库的HTTPS地址。 进入目标仓库，单击“克隆/下载”，在弹框中选择“用HTTPS克隆”，即可获取仓库地址。 |
用户名 | 待连接的CodeArts Repo仓库的HTTPS用户名，格式为“租户名/IAM用户名”。 在导航栏中单击用户名 ，选择“个人设置”。在“代码托管 > HTTPS密码”页面可以获取用户名。 |
密码 | 待连接的CodeArts Repo仓库的HTTPS密码，不超过300个字符。 在导航栏中单击用户名 ，选择“个人设置”。在“代码托管 > HTTPS密码”页面可以获取密码。 |
Gerrit
表11 新建Gerrit服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
Gerrit地址 | 待连接的Gerrit仓库的地址，支持HTTPS协议地址。 |
用户名 | 待连接的Gerrit仓库的用户名。 |
密码 | 待连接的Gerrit仓库的密码。 |
GitCode
表12 新建GitCode服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
Token | GitCode的个人访问密钥。获取方法请参考GitCode官网。 |
AGC
表13 新建AGC服务扩展点 参数 | 说明 |
|---|
连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。 |
客户端id | 待连接的AppGallery Connect API客户端的客户端ID，获取方法请参考AppGallery Connect官网。 |
密钥 | 待连接的AppGallery Connect API客户端的密钥，获取方法请参考AppGallery Connect官网。 |
管理服务扩展点
- 进入CodeArts首页。
- 登录CodeArts控制台，单击，根据需要选择已开通CodeArts的区域。
- 单击“前往工作台”。
如果当前账号采用的是历史计费模式（详情请参考历史计费模式说明），则单击“立即使用”。
- 单击目标项目名称，进入项目。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 在列表中单击目标服务扩展点，根据需要完成以下管理操作。
表14 管理服务扩展点 操作 | 说明 |
|---|
编辑 | 单击“编辑”，在弹框中编辑各项参数值，单击“保存”。 修改成功后，页面中将显示修改后的信息。 |
删除 | 单击“删除”，在弹框中单击“确定”。 删除成功后，页面中将不显示已删除的服务扩展点。 |
