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

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

前提条件

已有可用项目。如果没有项目，请先新建项目。
已创建Go格式私有依赖库。
请添加当前账号对当前私有库的权限，请参考管理用户权限。

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

下载私有依赖库配置文件。
1. 登录软件开发生产线，进入Go私有依赖库。单击页面右侧“操作指导”。
2. 在弹框中单击“下载配置文件”。
配置代码仓库。
1. 进入代码托管服务。创建Go语言代码仓库（操作步骤请参考创建云端仓库）。本文中使用仓库模板“Go Web Demo”创建代码仓库。
2. 准备“go.mod”文件，并上传至代码仓库的根目录中。本文中使用的“go.mod”文件如下所示：
配置并执行编译构建任务。
1. 在代码仓库中，单击页面右上角“设置构建”，页面跳转至“新建编译构建任务”页面。
  在页面中选择“空白构建模板”，单击“下一步”。
2. 添加步骤“Go语言构建”。
3. 编辑步骤“Go语言构建”。
  - 工具版本按照实际选择，本文中选择“go-1.13.1”。
  - 删除已有命令行，打开在步骤1中下载的配置文件，将文件中的“LINUX下配置go环境变量命令”复制到命令框中。
  - 将配置文件中go上传命令代码段复制到命令框中，并参考Go Modules打包方式简介替换命令行中的参数信息（本文打包版本为“v1.0.0”）。
4. 单击“新建并执行”，启动构建任务执行。
  待页面提示“构建成功”时，进入私有依赖库，可找到通过构建任务上传的Go私有组件。

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

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

参考发布私有组件到Go私有依赖库，下载私有依赖库配置文件。
进入代码托管服务，创建Go语言代码仓库（操作步骤请参考创建云端仓库）。本文中使用仓库模板“GoWebDemo”创建代码仓库。
配置并执行编译构建任务。
1. 在代码仓库中，单击页面右上角“设置构建”，页面跳转至“新建编译构建任务”页面。
  在页面中选择“空白构建模板”，单击“下一步”。
2. 添加步骤“Go语言构建”。
3. 编辑步骤“Go语言构建”。
  - 工具版本按照实际选择，本文中选择“go-1.13.1”。
  - 删除已有命令行，打开已下载的私有依赖库配置文件，将文件中的“LINUX下配置go环境变量命令”代码段复制到命令框中。
  - 根据下载版本，选择配置文件中“go下载命令”相应的命令行复制到命令框中，并将“<modulename>”参数值。（本文中为“example.com/demo”）。
单击“新建并执行”，启动构建任务执行。
待页面提示“构建成功”时，查看构建任务详情，在日志中找到类似如下内容，说明编译构建任务从私有依赖库完成了依赖包下载并构建成功。

Go Modules打包方式简介

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

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

在工作目录中创建源文件夹。
```
mkdir -p {module}@{version}
```
将代码源拷贝至源文件夹下。
```
cp -rf . {module}@{version}
```
压缩组件zip包。
```
zip -D -r [包名] [包根目录名称]
```

上传组件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
```