文档首页/ 流水线 CodeArts Pipeline/ 用户指南/ 新建CodeArts服务扩展点
更新时间：2024-10-15 GMT+08:00
查看PDF
分享

新建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服务扩展点

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台，单击，选择区域。
    2. 单击“立即使用”。

  2. 在CodeArts首页中单击目标项目名称，进入项目。
  3. 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
  4. 单击“新建服务扩展点”，在下拉列表中选择“Docker repository”。
  5. 在弹框中配置以下信息，单击“确定”。

    表2 新建Docker repository服务扩展点

    配置项

    是否必填

    说明

    连接名称

    是

    自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。

    仓库地址

    是

    输入待连接的Docker仓库的地址。支持http、https协议地址。

    用户名

    是

    输入待连接的Docker仓库的用户名。不超过256个字符。

    密码

    是

    输入待连接的Docker仓库的密码。不超过256个字符。

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

新建Jenkins服务扩展点

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

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台，单击，选择区域。
    2. 单击“立即使用”。

  2. 在CodeArts首页中单击目标项目名称。
  3. 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
  4. 单击“新建服务扩展点”，在下拉列表中选择“Jenkins”。
  5. 在弹框中配置以下信息，单击“确定”。

    表3 新建Jenkins服务扩展点

    配置项

    是否必填

    说明

    连接名称

    是

    自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。

    Server URL

    是

    输入待连接的Jenkins服务的地址。支持输入格式为“http://ip:端口号”或者“https://ip:端口号”的地址。

    用户名

    是

    输入待连接的Jenkins服务的用户名。不超过300个字符。

    密码

    是

    输入待连接的Jenkins服务的密码。不超过300个字符。

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

新建Kubernetes服务扩展点

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台，单击，选择区域。
    2. 单击“立即使用”。

  2. 在CodeArts首页中单击目标项目名称。
  3. 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
  4. 单击“新建服务扩展点”，在下拉列表中选择“Kubernetes”。
  5. 在弹框中配置以下信息，单击“验证并确定”。

    表4 新建Kubernetes服务扩展点

    配置项

    是否必填

    说明

    连接名称

    是

    自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。

    Kubernetes URL

    是

    输入待连接的集群的server地址，可通过“kubeconfig.json”中搜索“server”获取。

    Kubeconfig

    是

    输入待连接的集群的“kubeconfig.json”文件的全部内容。

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

新建nexus repository服务扩展点

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

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台，单击，选择区域。
    2. 单击“立即使用”。

  2. 在CodeArts首页中单击目标项目名称。
  3. 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
  4. 单击“新建服务扩展点”，在下拉列表中选择“nexus repository”。
  5. 在弹框中配置以下信息，单击“确定”。

    表5 新建nexus repository服务扩展点

    配置项

    是否必填

    说明

    连接名称

    是

    自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。

    仓库地址

    是

    输入待连接的nexus仓库的地址。支持http、https协议地址。

    用户名

    是

    输入待连接的nexus仓库的用户名。不超过300个字符。

    密码

    是

    输入待连接的nexus仓库的密码。不超过300个字符。

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

新建通用Git服务扩展点

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台，单击，选择区域。
    2. 单击“立即使用”。

  2. 在CodeArts首页中单击目标项目名称。
  3. 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
  4. 单击“新建服务扩展点”，在下拉列表中选择“通用Git”。
  5. 在弹框中配置以下信息，单击“确定”。

    表6 新建通用Git服务扩展点

    配置项

    是否必填

    说明

    连接名称

    是

    自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。

    Git仓库Url

    是

    输入待连接的Git仓库的HTTPS地址。

    用户名

    否

    输入待连接的Git仓库的用户名。不超过300个字符。

    密码或Access Token

    否

    输入待连接的Git仓库的密码。不超过300个字符。

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

新建GitHub服务扩展点

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

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台，单击，选择区域。
    2. 单击“立即使用”。

  2. 在CodeArts首页中单击目标项目名称。
  3. 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
  4. 单击“新建服务扩展点”，在下拉列表中选择“GitHub”。
  5. 在弹框中配置以下信息，单击“授权并确定”。

    表7 新建GitHub服务扩展点

    配置项

    是否必填

    说明

    连接名称

    是

    自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。

    验证方式

    是

    支持两种验证方式。

    • OAuth认证：选择此方式，单击“授权并确定”后，需要登录GitHub进行手动授权。
    • AccessToken认证：选择此方式，需要输入通过GitHub获取的AccessToken。获取方法请参考GitHub官网。

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

新建IAM账户服务扩展点

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台，单击，选择区域。
    2. 单击“立即使用”。

  2. 在CodeArts首页中单击目标项目名称。
  3. 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
  4. 单击“新建服务扩展点”，在下拉列表中选择“IAM账户”。
  5. 在弹框中配置以下信息，单击“确定”。

    表8 新建IAM账户服务扩展点

    配置项

    是否必填

    说明

    连接名称

    是

    自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。

    Access Key Id

    是

    输入通过“我的凭证”页面获取的AK。获取方法请参考新增访问密钥。

    Secret Access Key

    是

    输入通过“我的凭证”页面获取的SK。获取方法请参考新增访问密钥。

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

新建CodeArts Repo HTTPS服务扩展点

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台，单击，选择区域。
    2. 单击“立即使用”。

  2. 在CodeArts首页中单击目标项目名称。
  3. 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
  4. 单击“新建服务扩展点”，在下拉列表中选择“CodeArts Repo HTTPS”。
  5. 在弹框中配置以下信息，单击“确定”。

    表9 新建CodeArts Repo HTTPS服务扩展点

    配置项

    是否必填

    说明

    连接名称

    是

    自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。

    CodeArts Repo地址

    是

    输入待连接的CodeArts Repo仓库的HTTPS地址。

    进入目标仓库，单击“克隆/下载”，在弹框中选择“用HTTPS克隆”，即可获取仓库地址。

    用户名

    否

    输入待连接的CodeArts Repo仓库的HTTPS用户名。

    在导航栏中单击用户名，选择“个人设置”。在“代码托管 > HTTPS密码”页面可以获取用户名。

    密码

    否

    输入待连接的CodeArts Repo仓库的HTTPS密码。

    在导航栏中单击用户名，选择“个人设置”。在“代码托管 > HTTPS密码”页面可以获取密码。

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

新建GitLab服务扩展点

  1. 进入CodeArts首页。

    1. 登录CodeArts控制台，单击，选择区域。
    2. 单击“立即使用”。

  2. 在CodeArts首页中单击目标项目名称。
  3. 在导航中依次选择“设置 > 通用设置 > 服务扩展点管理”。
  4. 单击“新建服务扩展点”，在下拉列表中选择“GitLab”。
  5. 在弹框中配置以下信息，单击“确定”。

    表10 新建GitLab服务扩展点

    配置项

    是否必填

    说明

    连接名称

    是

    自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。

    GitLab地址

    是

    输入待连接的GitLab仓库的HTTPS地址。

    用户名

    否

    输入待连接的GitLab仓库的用户名。

    Access Token

    否

    输入待连接的GitLab仓库的Access Token。获取方法请参考GitLab官网。

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