# 管理CodeArts服务扩展点 #### 操作场景 服务扩展点是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。连接成功后，可以在流水线中使用该服务。 | #### 前提条件 - 拥有"插件市场 \> 扩展点 \> 创建"权限的用户可以新建服务扩展点。[项目成员如何查看/获取需要的操作权限？](https://support.huaweicloud.com/devcloud_faq/devcloud_faq_0010.html) - 待接入的第三方服务能通过公网环境无限制地访问。 #### 新建服务扩展点 1. 进入CodeArts首页。 1. 登录[CodeArts控制台](https://console.huaweicloud.com/devcloud)，单击![](https://support.huaweicloud.com/usermanual-pipeline/zh-cn_image_0000001917408514.png)，根据需要选择已开通CodeArts的区域。 2. 单击"前往工作台"。 如果当前账号采用的是历史计费模式（详情请参考[历史计费模式说明](https://support.huaweicloud.com/price-devcloud/codearts_29_0031.html)），则单击"立即使用"。 2. 单击目标项目名称，进入项目。 3. 在导航中依次选择"设置 \> 通用设置 \> 服务扩展点管理"。 4. 单击"新建服务扩展点"，在弹框中选择类型。 5. 完成扩展点信息的配置。 新建成功后，页面中显示新建的扩展点名称。 各类服务扩展点的配置参数如下。 #### Docker repository 表2新建Docker repository服务扩展点 | 参数 | 说明 | |:---|:---| | 连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、"-"、"_"、"."、空格，不超过256个字符。 | | 仓库地址 | 待连接的Docker仓库的地址，支持HTTP、HTTPS协议地址。 | | 用户名 | 待连接的Docker仓库的用户名。 | | 密码 | 待连接的Docker仓库的密码。 | #### Jenkins 表3新建Jenkins服务扩展点 | 参数 | 说明 | |:---|:---| | 连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、"-"、"_"、"."、空格，不超过256个字符。 | | Server URL | 待连接的Jenkins服务的地址。支持HTTP、HTTPS协议地址。 | | 用户名 | 待连接的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认证：选择此方式，需要输入通过码云获取的私人令牌。获取方法请参考[码云官网](https://gitee.com/help/articles/4336#article-header13)。 | #### GitHub服务 表8新建GitHub服务扩展点 | 参数 | 说明 | |:---|:---| | 连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、"-"、"_"、"."、空格，不超过256个字符。 | | 验证方式 | 支持两种验证方式。 - OAuth认证：选择此方式，单击"授权并确定"后，需要登录GitHub进行手动授权。 - AccessToken认证：选择此方式，需要输入通过GitHub获取的access token。获取方法请参考[GitHub官网](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)。 | #### IAM账户 表9新建IAM账户服务扩展点 | 参数 | 说明 | |:---|:---| | 连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、"-"、"_"、"."、空格，不超过256个字符。 | | Access Key Id | 待连接IAM用户的AK。通过"我的凭证"页面获取，获取方法请参考[新增访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html#section1)。 | | Secret Access Key | 待连接IAM用户的SK。通过"我的凭证"页面获取，获取方法请参考[新增访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html#section1)。 | #### CodeArts Repo HTTPS 表10新建CodeArts Repo HTTPS服务扩展点 | 参数 | 说明 | |:---|:---| | 连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、"-"、"_"、"."、空格，不超过256个字符。 | | CodeArts Repo地址 | 待连接的CodeArts Repo仓库的HTTPS地址。 进入目标仓库，单击"克隆/下载"，在弹框中选择"用HTTPS克隆"，即可获取仓库地址。 | | 用户名 | 待连接的CodeArts Repo仓库的HTTPS用户名，格式为"租户名/IAM用户名"。 在导航栏中单击用户名![](https://support.huaweicloud.com/usermanual-pipeline/zh-cn_image_0000002128093925.png "点击放大")，选择"个人设置"。在"代码托管 \> HTTPS密码"页面可以获取用户名。 | | 密码 | 待连接的CodeArts Repo仓库的HTTPS密码，不超过300个字符。 在导航栏中单击用户名![](https://support.huaweicloud.com/usermanual-pipeline/zh-cn_image_0000002092334422.png "点击放大")，选择"个人设置"。在"代码托管 \> HTTPS密码"页面可以获取密码。 | #### Gerrit 表11新建Gerrit服务扩展点 | 参数 | 说明 | |:---|:---| | 连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、"-"、"_"、"."、空格，不超过256个字符。 | | Gerrit地址 | 待连接的Gerrit仓库的地址，支持HTTPS协议地址。 | | 用户名 | 待连接的Gerrit仓库的用户名。 | | 密码 | 待连接的Gerrit仓库的密码。 | #### GitCode 表12新建GitCode服务扩展点 | 参数 | 说明 | |:---|:---| | 连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、"-"、"_"、"."、空格，不超过256个字符。 | | Token | GitCode的个人访问密钥。获取方法请参考[GitCode官网](https://docs.gitcode.com/docs/help/home/user_center/security_management/user_pat)。 | #### AGC 表13新建AGC服务扩展点 | 参数 | 说明 | |:---|:---| | 连接名称 | 服务扩展点的连接名称，支持中文、英文、数字、"-"、"_"、"."、空格，不超过256个字符。 | | 客户端id | 待连接的AppGallery Connect API客户端的客户端ID，获取方法请参考[AppGallery Connect官网](https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agcapi-getstarted-0000001111845114)。 | | 密钥 | 待连接的AppGallery Connect API客户端的密钥，获取方法请参考[AppGallery Connect官网](https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agcapi-getstarted-0000001111845114)。 | #### 管理服务扩展点 1. 进入CodeArts首页。 1. 登录[CodeArts控制台](https://console.huaweicloud.com/devcloud)，单击![](https://support.huaweicloud.com/usermanual-pipeline/zh-cn_image_0000001917408514.png)，根据需要选择已开通CodeArts的区域。 2. 单击"前往工作台"。 如果当前账号采用的是历史计费模式（详情请参考[历史计费模式说明](https://support.huaweicloud.com/price-devcloud/codearts_29_0031.html)），则单击"立即使用"。 2. 单击目标项目名称，进入项目。 3. 在导航中依次选择"设置 \> 通用设置 \> 服务扩展点管理"。 4. 在列表中单击目标服务扩展点，根据需要完成以下管理操作。 表14管理服务扩展点 | 操作 | 说明 | |:---|:---| | 编辑 | 单击"编辑"，在弹框中编辑各项参数值，单击"保存"。 修改成功后，页面中将显示修改后的信息。 | | 删除 | 警告： 删除后，将无法恢复，请谨慎操作。 单击"删除"，在弹框中单击"确定"。 删除成功后，页面中将不显示已删除的服务扩展点。 |