操作场景
服务扩展点是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账号,连接成功后可以在构建、流水线等服务中获取该账号下的仓库、分支等信息。 |
前提条件
- 在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。获取方法请参考。
|
- 授权成功,关闭弹窗后页面中显示新建的扩展点名称。
新建iam账户服务扩展点
- 进入codearts九游平台首页。
- 登录控制台,单击,选择区域。
- 单击,在服务列表中选择“开发与运维 > 软件开发生产线”。
- 单击“立即使用”。
- 在codearts九游平台首页中单击目标项目名称。
- 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
- 单击“新建服务扩展点”,在下拉列表中选择“iam账户”。
- 在弹框中配置以下信息,单击“确定”。
表9 新建iam账户服务扩展点
配置项 |
是否必填 |
说明 |
连接名称 |
是 |
自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。 |
access key id |
是 |
输入通过“我的凭证”页面获取的ak。获取方法请参考。 |
secret access key |
是 |
输入通过“我的凭证”页面获取的sk。获取方法请参考。 |
- 新建成功,页面中显示新建的扩展点名称。
新建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获取的个人访问密钥。获取方法请参考。 |
- 授权成功,关闭弹窗后页面中显示新建的扩展点名称。