You need to enable JavaScript to run this app.
导航

创建代码源

最近更新时间2024.03.08 11:11:08

首次发布时间2023.10.23 11:22:01

创建代码源,即关联您的代码仓库,实现代码源远程连接。创建代码源成功后,可在流水线内配置使用,作为流水线的输入源。本文为您介绍如何创建代码源。

背景信息

新建代码源保存时,系统会自动校验代码源是否可正常连接,具体包括:

  • Token 是否有效。
  • 代码源地址是否符合规则。
  • 代码源地址是否可通过公网访问。
  • 对于 Codeup 代码源,除以上校验外,还会校验 AK/SK 的有效性。

注意

  • 通用 Git 代码源较为特殊,新建代码源保存时不做以上校验,统一在流水线拉取代码源时校验。
  • 校验代码源成功后,可能存在运行流水线时无法正常拉取代码源的情况。建议对代码仓库进行排查,如无法解决,可申请工单寻求技术支持。

前提条件

  • 已创建工作区,具体操作请参考 创建工作区
  • 创建 Gitee、GitLab、GitHub、 Codeup 代码源,请确保已获取 Token。创建 Codeup 代码源,请确保已获取 Token 和 AK/SK。具体可参考 代码源常见问题
  • 创建 Gerrit 代码源,请提前准备好登录 Gerrit 代码仓库的用户名和密码。
  • 创建通用 Git 或 BitbucketCloud 代码源,请提前准备好 Token 或用户名密码。获取 Token 可参考 代码源常见问题

操作步骤

  1. 登录 持续交付控制台

  2. 在左侧导航栏选择 工作区

  3. 单击目标工作区名称,进入当前工作区。

  4. 在左侧导航栏选择 代码源

  5. 在代码源页面,单击 创建代码源

  6. 在创建代码源对话框,配置代码源信息。

    • Gitee/GitLab/GitHub

      配置项说明
      名称自定义代码源名称。工作区内名称唯一,关联流水线后不允许修改。
      类型代码仓库类型。此处选择的代码仓库类型需与您业务实际使用的代码仓库一致。
      代码仓库输入待接入代码仓库 Project 的服务地址,目前支持 HTTP 和 HTTPS 协议。
      为避免手输地址出错,建议在您的代码仓库 Project 主页,复制克隆选项下的 HTTPS 协议地址。
      访问凭证输入对应代码仓库的 Token,用于身份验证。支持使用 Personal Access Token 和第三方授权的 OAuth Token。
      两种 Token 的认证模型不同, Personal Access Token 认证用户的权限,OAuth Token 认证应用具有用户授予的权限,安全性和权限控制粒度更好。请根据实际需要选择使用哪种 Token 进行身份验证。
      忽略证书有效性勾选后,校验代码源及运行流水线拉取代码时将忽略 HTTPS 证书有效性校验,避免因为证书过期问题影响代码仓库接入及流水线拉取代码。
      网络加速网络加速服务用于提高流水线拉取代码源的速度。该配置仅对使用公共资源池拉取 GitHub 代码源场景生效。
    • 通用 Git

      配置项说明
      名称自定义代码源名称。为了便于区分资源,建议同一账号下不同代码源避免重名。
      类型本场景选择 通用 Git
      代码仓库输入待接入代码仓库 Project 的服务地址,目前支持 HTTP 和 HTTPS 协议。
      为避免手输地址出错,建议在您的代码仓库 Project 主页,复制克隆选项下的 HTTPS 协议地址。

      访问凭证

      支持用户名密码和 Token 两种访问凭证,请按需选择。

      • 用户名密码:通过账号/密码的方式接入仓库。
      • Token:通过 Token 的方式接入仓库。
      忽略证书有效性勾选后,校验代码源及运行流水线拉取代码时将忽略 HTTPS 证书有效性校验,避免因为证书过期问题影响代码仓库接入及流水线拉取代码。
    • BitbucketCloud

      配置项说明
      名称自定义代码源名称。为了便于区分资源,建议同一账号下不同代码源避免重名。
      类型本场景选择 BitbucketCloud
      代码仓库输入待接入代码仓库 Project 的服务地址,目前支持 HTTP 和 HTTPS 协议。
      为避免手输地址出错,建议在您的代码仓库 Project 主页,复制克隆选项下的 HTTPS 协议地址。

      访问凭证

      支持用户名密码和 Token 两种访问凭证,请按需选择。

      • 用户名密码:通过账号/密码的方式接入仓库。
      • Token:通过 Token 的方式接入仓库。
      忽略证书有效性勾选后,校验代码源及运行流水线拉取代码时将忽略 HTTPS 证书有效性校验,避免因为证书过期问题影响代码仓库接入及流水线拉取代码。
      网络加速网络加速服务用于提高流水线拉取代码源的速度。该配置仅对使用公共资源池拉取 GitHub 代码源场景生效。
    • Codeup

      配置项说明
      名称自定义代码源名称。为了便于区分资源,建议同一账号下不同代码源避免重名。
      类型本场景选择 Codeup
      代码仓库输入待接入代码仓库 Project 的服务地址,目前支持 HTTP 和 HTTPS 协议。
      为避免手输地址出错,建议在您的代码仓库 Project 主页,复制克隆选项下的 HTTPS 协议地址。

      访问凭证

      设置 Codeup 仓库的访问凭证。

      • Token:输入对应代码仓库的 Token,用于身份验证。
      • AK & SK:配置 Codeup 的 AK 和 SK,用于身份验证。
      忽略证书有效性勾选后,校验代码源及运行流水线拉取代码时将忽略 HTTPS 证书有效性校验,避免因为证书过期问题影响代码仓库接入及流水线拉取代码。
      网络加速网络加速服务用于提高流水线拉取代码源的速度。该配置仅对使用公共资源池拉取 GitHub 代码源场景生效。
    • Gerrit

      配置项说明
      名称自定义代码源名称。为了便于区分资源,建议同一账号下不同代码源避免重名。
      类型本场景选择 Gerrit
      代码仓库输入待接入代码仓库 Project 的服务地址,目前支持 HTTP 和 HTTPS 协议。
      为避免手输地址出错,建议在您的代码仓库 Project 主页,复制克隆选项下的 HTTPS 协议地址。
      访问凭证请输入 Gerrit 仓库的登录用户名和密码。
      忽略证书有效性勾选后,校验代码源及运行流水线拉取代码时将忽略 HTTPS 证书有效性校验,避免因为证书过期问题影响代码仓库接入及流水线拉取代码。
      网络加速网络加速服务用于提高流水线拉取代码源的速度。该配置仅对使用公共资源池拉取 GitHub 代码源场景生效。
  7. 单击 校验并创建 ,系统自动校验代码源是否可正常连接。校验通过后创建成功。

    注意

    若系统提示 代码仓库无法通过公网访问校验,可忽略该错误,保存代码源。该场景主要用于解决使用私有资源池运行流水线、且私有资源池和您的代码仓库网络相通的情形。其他情形下,忽略该错误可能导致流水线无法正常拉取代码,请谨慎使用。

后续操作

创建代码源成功后,可在流水线内配置使用,详情请参考 创建流水线