新建CodeArts服务扩展点
服务扩展点是CodeArts的一种扩展插件,为CodeArts提供连接第三方服务的能力。
用户典型使用场景:在项目的流水线配置中,如果用户需要远程连接第三方服务,如:连接第三方GitHub、码云的Git仓库获取项目源码,连接第三方Jenkins服务执行Jenkins任务,连接Kubernetes集群进行部署,连接nexus repository用于添加用户的私有Maven仓库信息,Docker repository用于连接Docker镜像仓库,IAM账户扩展点用于委托自己账号的AK/SK给需要执行任务的账号等,均可以使用服务扩展点实现。
前提条件
- 项目经理和项目创建者默认拥有服务扩展点的所有权限,其他角色默认只有读取权限。
- 确保服务扩展点中配置的第三方服务能通过公网环境无限制地访问。
新建Docker repository服务扩展点
Docker repository扩展点用于连接Docker镜像仓库,连接成功后可对Docker镜像进行相应操作。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“Docker repository”。
- 弹出“新建服务扩展点”对话框,请填写相应参数。
表1 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
仓库地址
待连接的Docker镜像仓库的地址(http或者https协议地址)。
用户名
连接镜像仓库的用户名。
密码
连接镜像仓库的密码。
- 信息填写完成,单击“确定”。
新建Jenkins服务扩展点
Jenkins扩展点用于连接Jenkins服务,连接成功后可以对Jenkins服务中所包含的任务进行操作。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“Jenkins”。
- 弹出“新建服务扩展点”对话框,请填写相应参数。
表2 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
Server URL
待连接的Jenkins服务的地址,当前仅支持“http://ip:端口号”和“https://ip:端口号”这类公网地址。
用户名
登录Jenkins服务的用户名称。
密码
登录Jenkins服务的用户密码。
可通过单击“验证并确定”来验证用户名和用户密码是否可以连接到所填写的Jenkins服务器上。
- 信息填写完成,单击“确定”。
新建Kubernetes服务扩展点
Kubernetes扩展点用于连接Kubernetes集群,连接成功后可对Kubernetes集群下发部署任务。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“Kubernetes部署接入点”。
- 弹出“新建服务扩展点”对话框,请填写相应参数。
表3 参数说明 字段
说明
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
Kubernetes URL
待连接的Kubernetes集群的apiserver地址(http或者https协议地址)。
Kubeconfig
Kubeconfig文件包含了集群、用户、Namespace和认证机制信息。Kubectl命令使用Kubeconfig选择需要连接的一个集群并且跟K8s api通信。该文件支持多个集群、用户和认证机制。 参考链接:使用kubeconfig文件组织集群访问。
说明:如果使用的是CCE集群,可以参考通过kubectl连接集群中“使用kubectl连接集群”章节获取Kubeconfig文件。
- 信息填写完成,单击“确定”。
新建nexus repository服务扩展点
nexus repository扩展点用于添加用户的私有Maven仓库信息。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“nexus repository”。
- 弹出“新建服务扩展点”对话框,请填写相应参数。
表4 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
仓库地址
nexus仓库公网地址(http或者https协议地址)。
用户名
nexus仓库访问用户名。
密码
nexus仓库访问密码。
- 信息填写完成,单击“确定”。
新建GitHub服务扩展点
连接到Github账号后可以获取该账号下的仓库、分支等信息。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“GitHub”。
- 弹出“新建服务扩展点”对话框,根据需要选择对应验证方式,并填写相应参数。
- 验证方式一:OAuth认证
表5 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
验证方式
OAuth认证方式,需要登录GitHub账号进行手动授权。
- 验证方式二:Access Token认证
表6 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
验证方式
Access Token认证。
Access Token
请获取Github Access Token,并填入此处认证。
- 验证方式一:OAuth认证
- 信息填写完成,单击“确定”。
新建通用Git服务扩展点
连接到通用Git账号后可以获取该账号下的仓库、分支等信息。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“通用Git”。
- 弹出“新建服务扩展点”对话框,请填写相应参数。
表7 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
Git仓库Url
Git具体某个仓库的web url(https协议地址)。
用户名
Git仓库用户名。
密码或Access Token
Git仓库密码或Access Token。
- 信息填写完成,单击“确定”。
新建码云Git服务扩展点
连接到码云账号之后可以获取该账号下的仓库、分支等信息。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“码云Git”。
- 弹出“新建服务扩展点”对话框,根据需要选择对应验证方式,并填写相应参数。
- 验证方式一:OAuth认证
表8 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
验证方式
OAuth认证方式,需要登录码云账号进行手动授权。
- 验证方式二:Access Token认证
表9 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
验证方式
Access Token认证。
Access Token
请获取码云Access Token,并填入此处认证。
- 验证方式一:OAuth认证
- 信息填写完成,单击“确定”。
新建IAM账户服务扩展点
IAM账户扩展点用于委托自己账号的AK/SK给需要执行任务的账号,这样在该账号执行部署任务的时候就可以通过AK/SK获得被委托的账号的token执行更高权限的任务。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“IAM账户”。
- 弹出“新建服务扩展点”对话框,填写相应参数。
表10 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
Access Key Id
访问密钥ID(AK),获取访问密钥AK/SK。
Secret Access Key
秘密访问密钥(SK),获取访问密钥AK/SK。
- 信息填写完成,单击“确定”。
新建CodeArts Repo HTTPS服务扩展点
CodeArts Repo HTTPS服务扩展点用于授权CodeArts服务对托管的Repo仓库进行代码下载、分支创建、分支合并、代码提交等操作。当前主要用于流水线服务的微服务变更功能模块及其相关插件。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“CodeArts Repo HTTPS”。
- 弹出“新建服务扩展点”对话框,填写相应参数。
表11 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
CodeArts Repo地址
CodeArts Repo仓库克隆地址前缀,可在代码托管服务查看获取。
- 进入项目下任意代码仓库。
- 获取代码仓库的HTTPS克隆地址,截取地址中“https://example.com”部分填入即可。
说明:在流水线服务页面创建该扩展点时,无需填写该信息。
用户名
操作CodeArts Repo仓库使用的HTTPS用户名,格式为“租户名/IAM用户名”,请完整输入并避免前后空格。
密码
操作CodeArts Repo仓库使用的HTTPS密码凭证。
单击右上角用户名,前往“个人设置 > 代码托管 > HTTPS密码管理”可以查看和设置用户名密码信息。
- 信息填写完成,单击“确定”。
新建Gerrit服务扩展点
用于连接第三方Gerrit仓库,连接成功后可以在构建、流水线等服务中获取该仓库代码。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“Gerrit”。
- 弹出“新建服务扩展点”对话框,填写相应参数。
表12 新建Gerrit服务扩展点 配置项
是否必填
说明
连接名称
是
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
Gerrit地址
是
待连接的Gerrit仓库的地址。支持https协议地址。
用户名
否
待连接的Gerrit仓库的用户名。不超过300个字符。
密码
否
待连接的Gerrit仓库的密码。不超过300个字符。
- 信息填写完成,单击“确定”。
新建GitCode服务扩展点
连接到通用Gitcode账号后可以获取该账号下的仓库、分支等信息。
- 进入项目,单击“设置 > 通用设置 > 服务扩展点管理”。
- 进入“服务扩展点管理”页面,单击“新建服务扩展点”,选择“GitCode”。
- 弹出“新建服务扩展点”对话框,填写相应参数。
表13 参数说明 参数名称
功能描述
连接名称
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
token
请获取Gitcode的AccessToken,并填写入此处认证。
- 信息填写完成,单击“确定”。
编辑/删除服务扩展点
在“服务扩展点管理”页面,单击服务扩展点列表中的服务扩展点名称,可查看服务扩展点基本信息和详细信息,具有权限的用户可根据需要编辑和删除服务扩展点。
编辑已被引用的扩展点后,需手动更新关联的流水线任务。