文档首页> 发布 CloudRelease> 快速入门> 通过编译构建任务发布/获取Go私有组件
更新时间:2022-06-23 GMT+08:00
分享

通过编译构建任务发布/获取Go私有组件

本文档介绍如何通过编译构建任务发布私有组件到Go私有依赖库、如何从Go私有依赖库获取依赖包完成编译构建任务。

前提条件

  1. 已有可用项目。如果没有项目,请先新建项目
  2. 已创建Go格式私有依赖库。

发布私有组件到Go私有依赖库

  1. 下载私有依赖库配置文件。

    1. 登录软件开发平台,进入Go私有依赖库。单击页面右侧“操作指导”

    2. 在弹框中单击“下载配置文件”

  2. 配置代码仓库。

    1. 进入代码托管服务。创建Go语言代码仓库(操作步骤请参考创建云端仓库)。本文中使用仓库模板“GoWebDemo”创建代码仓库。
    2. 准备“go.mod”文件,并上传至代码仓库的根目录中。本文中使用的“go.mod”文件如下所示:

  3. 配置并执行编译构建任务。

    1. 在代码仓库中,单击页面右上角“设置构建”,页面跳转至“新建编译构建任务”页面。

      在页面中选择“空白构建模板”,单击“确定”

    2. 添加步骤“Go语言构建”

    3. 编辑步骤“Go语言构建”
      • 工具版本按照实际选择,本文中选择“go-1.13.1”
      • 删除已有命令行,打开在步骤1中下载的配置文件,将文件中的“LINUX下配置go环境变量命令”复制到命令框中。
      • 将配置文件中“go上传命令”代码段复制到命令框中,并参考Go Modules打包方式简介替换命令行中的参数信息(本文打包版本为“v1.0.0”)。

    4. 单击“新建并执行”,启动构建任务执行。

      待页面提示“构建成功”时,进入私有依赖库,可找到通过构建任务上传的Go私有组件。

从Go私有依赖库获取依赖包

发布私有组件到Go私有依赖库中发布的Go私有组件为例,介绍如何从Go私有依赖库中获取依赖包。

  1. 参考发布私有组件到Go私有依赖库,下载私有依赖库配置文件。
  2. 进入代码托管服务,创建Go语言代码仓库(操作步骤请参考创建云端仓库)。本文中使用仓库模板“GoWebDemo”创建代码仓库。
  3. 配置并执行编译构建任务。

    1. 在代码仓库中,单击页面右上角“设置构建”,页面跳转至“新建编译构建任务”页面。

      在页面中选择“空白构建模板”,单击“确定”

    2. 添加步骤“Go语言构建”

    3. 编辑步骤“Go语言构建”
      • 工具版本按照实际选择,本文中选择“go-1.13.1”
      • 删除已有命令行,打开已下载的私有依赖库配置文件,将文件中的“LINUX下配置go环境变量命令”代码段复制到命令框中。
      • 根据下载版本,选择配置文件中“go下载命令”相应的命令行复制到命令框中,并将“<moudlename>”参数值。(本文中为“example.com/demo”)。

  4. 单击“新建并执行”,启动构建任务执行。

    待页面提示“构建成功”时,查看构建任务详情,在日志中找到类似如下内容,说明编译构建任务从私有依赖库完成了依赖包下载并构建成功。

Go Modules打包方式简介

本文采用Go Modules打包方式完成Go组件的构建与上传。

打包命令主要包括以下几部分:

  1. 在工作目录中创建源文件夹。
    mkdir -p {module}@{version}
  2. 将代码源拷贝至源文件夹下。
    cp -rf . {module}@{version}
  3. 压缩组件zip包。
    zip -D -r [包名] [包根目录名称]
  4. 上传组件zip包与“go.mod”文件到私有依赖库中。
    curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/{filePath} -T {{localFile}}

根据打包的版本不同,组件目录结构有以下几种情况:

  • v2.0以下版本:目录结构与“go.mod”文件路径相同,无需附加特殊目录结构。
  • v2.0以上(包括v2.0)版本:
    • “go.mod”文件中第一行以“/vX”结尾:目录结构需要包含“/vX”。例如,版本为v2.0.1,目录需要增加“v2”
    • “go.mod”文件中第一行不以“/vN”结尾:目录结构不变,上传文件名需要增加“+incompatible”

下面分别对不同的版本举例说明:

  • v2.0以下版本打包

    以下图所示“go.mod”文件为例。

    1. 在工作目录中创建源文件夹。
      命令行中,参数“module”的值为“example.com/demo”,参数“version”自定义为1.0.0。因此命令如下:
      mkdir -p ~/example.com/demo@v1.0.0
    2. 将代码源拷贝至源文件夹下。

      参数值与上一步一致,命令行如下:

      cp -rf . ~/example.com/demo@v1.0.0/
    3. 压缩组件zip包。

      首先,使用以下命令,进入组件zip包所在根目录的上层目录。

      cd ~

      然后,使用zip命令将代码压缩成组件包。命令行中,“包根目录名称”“example.com”“包名”自定义为“v1.0.0.zip”,因此命令如下:

      zip -D -r v1.0.0.zip  example.com/
    4. 上传组件zip包与“go.mod”文件到私有依赖库中。

      命令行中,参数“username”“password”“repoUrl”均可通过私有依赖库配置文件获取。

      • 对于zip包,参数“filePath”“example.com/demo/@v/v1.0.0.zip”“localFile”“v1.0.0.zip”
      • 对于“go.mod”文件,参数“filePath”“example.com/demo/@v/v1.0.0.mod”“localFile”“example.com/demo@v1.0.0/go.mod”

      因此命令如下(参数username、password、repoUrl请参照私有依赖库配置文件自行修改):

      curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/@v/v1.0.0.zip -T v1.0.0.zip
      curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/@v/v1.0.0.mod -T example.com/demo@v1.0.0/go.mod
  • v2.0以上版本打包,且“go.mod”文件中第一行以“/vX”结尾

    以下图所示“go.mod”文件为例。

    1. 在工作目录中创建源文件夹。
      命令行中,参数“module”的值为“example.com/demo/v2”,参数“version”自定义为“2.0.0”。因此命令如下:
      mkdir -p ~/example.com/demo/v2@v2.0.0
    2. 将代码源拷贝至源文件夹下。

      参数值与上一步一致,命令行如下:

      cp -rf . ~/example.com/demo/v2@v2.0.0/
    3. 压缩组件zip包。

      首先,使用以下命令,进入组件zip包所在根目录的上层目录。

      cd ~

      然后,使用zip命令将代码压缩成组件包。命令行中,“包根目录名称”“example.com”“包名”自定义为“v2.0.0.zip”,因此命令如下:

      zip -D -r v2.0.0.zip  example.com/
    4. 上传组件zip包与“go.mod”文件到私有依赖库中。

      命令行中,参数“username”“password”“repoUrl”均可通过私有依赖库配置文件获取。

      • 对于zip包,参数“filePath”“example.com/demo/v2/@v/v2.0.0.zip”“localFile”“v2.0.0.zip”
      • 对于“go.mod”文件,参数“filePath”“example.com/demo/v2/@v/v2.0.0.mod”“localFile”“example.com/demo/v2@v2.0.0/go.mod”

      因此命令如下(参数username、password、repoUrl请参照私有依赖库配置文件自行修改):

      curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/v2/@v/v2.0.0.zip -T v2.0.0.zip
      curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/v2/@v/v2.0.0.mod -T example.com/demo/v2@v2.0.0/go.mod
  • v2.0以上版本打包,且“go.mod”文件中第一行不以“/vX”结尾

    以下图所示“go.mod”文件为例。

    1. 在工作目录中创建源文件夹。
      命令行中,参数“module”的值为“example.com/demo”,参数“version”自定义为“3.0.0”。因此命令如下:
      mkdir -p ~/example.com/demo@v3.0.0+incompatible
    2. 将代码源拷贝至源文件夹下。

      参数值与上一步一致,命令行如下:

      cp -rf . ~/example.com/demo@v3.0.0+incompatible/
    3. 压缩组件zip包。

      首先,使用以下命令,进入组件zip包所在根目录的上层目录。

      cd ~

      然后,使用zip命令将代码压缩成组件包。命令行中,“包根目录名称”“example.com”“包名”自定义为“v3.0.0.zip”,因此命令如下:

      zip -D -r v3.0.0.zip  example.com/
    4. 上传组件zip包与“go.mod”文件到私有依赖库中。

      命令行中,参数“username”“password”“repoUrl”均可通过私有依赖库配置文件获取。

      • 对于zip包,参数“filePath”“example.com/demo/@v/v3.0.0+incompatible.zip”“localFile”“v3.0.0.zip”
      • 对于“go.mod”文件,参数“filePath”“example.com/demo/@v/v3.0.0+incompatible.mod”“localFile”“example.com/demo@v3.0.0+incompatible/go.mod”

      因此命令如下(参数username、password、repoUrl请参照私有依赖库配置文件自行修改):

      curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/@v/v3.0.0+incompatible.zip -T v3.0.0.zip
      curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/@v/v3.0.0+incompatible.mod -T example.com/demo@v3.0.0+incompatible/go.mod

分享:

    相关文档

    相关产品

close