适用于极狐GitLab 的 Go 代理
- 引入于 13.1 版本。
- 存在功能标志,默认禁用。
- 在 SaaS 上禁用。
- 要在私有化部署实例中使用它,请让极狐GitLab 管理员启用它。
- 从旗舰版移动到免费版于 13.3 版本。
使用适用于极狐GitLab 的 Go 代理,可以使用 Go 代理协议 获取极狐GitLab 中的每个项目。
启用 Go 代理
有权访问 Rails 控制台的极狐GitLab 管理员可以为您的实例启用它。
启用:
Feature.enable(:go_proxy) # or
禁用:
Feature.disable(:go_proxy)
为特定项目启用或禁用:
Feature.enable(:go_proxy, Project.find(1))
Feature.disable(:go_proxy, Project.find(2))
将极狐GitLab 添加为 Go 代理
要将极狐GitLab 用作 Go 代理,您必须使用 Go 1.13 或更高版本。
可用的代理端点用于按项目获取模块:/api/v4/projects/:id/packages/go
要从极狐GitLab 获取 Go 模块,请将特定于项目的端点添加到 GOPROXY
。
Go 查询端点并回退到默认行为:
go env -w GOPROXY='https://gitlab.example.com/api/v4/projects/1234/packages/go,https://proxy.golang.org,direct'
使用此配置,Go 按以下顺序获取依赖项:
- Go 尝试从项目特定的 Go 代理中获取。
- Go 尝试从 proxy.golang.org 获取。
- Go 直接使用版本控制系统操作(如
git clone
、svn checkout
等)获取。
如果没有指定 GOPROXY
,Go 会执行第 2 步和第 3 步,这对应于将 GOPROXY
设置为 https://proxy.golang.org,direct
。如果 GOPROXY
仅包含特定于项目的端点,则 Go 仅查询该端点。
关于如何设置 Go 环境变量的详细信息,请参见设置环境变量。
从私有项目中获取模块
go
不支持通过不安全的连接传输凭据。以下步骤仅在为 HTTPS 配置极狐GitLab 时有效:
- 配置 Go,在从极狐GitLab 的 Go 代理获取时包含 HTTP 基本身份验证凭据。
- 配置 Go,跳过从公共校验和数据库下载私有极狐GitLab 项目的校验和。
启用请求身份验证
创建一个 个人访问令牌,范围设置为 api
或 read_api
。
打开您的 ~/.netrc
文件并添加以下文本。将 < >
中的变量替换为您的值。
NETRC
的环境变量,Go 将使用其值作为文件名并忽略 ~/.netrc
。如果您打算在 CI 中使用 ~/.netrc
,请勿使用 NETRC
作为环境变量名称。machine <url> login <username> password <token>
-
<url>
:极狐GitLab URL,例如jihulab.com
。 -
<用户名>
:您的用户名。 -
<token>
:您的个人访问令牌。
禁用校验和数据库查询
当使用 Go 1.13 及更高版本下载依赖项时,获取的源将根据校验和数据库 sum.golang.org
进行验证。
如果获取的源的校验和与数据库中的校验和不匹配,Go 不会构建依赖项。
私有模块无法构建,因为 sum.golang.org
无法获取私有模块的来源,因此无法提供校验和。
要解决此问题,请将 GONOSUMDB
设置为以逗号分隔的私有项目列表。有关设置 Go 环境变量的详细信息,请参阅设置环境变量。
例如,要禁用 gitlab.com/my/project
的校验和查询,请设置 GONOSUMDB
:
go env -w GONOSUMDB='gitlab.com/my/project,<previous value>'
使用 Go
如果您不熟悉在 Go 中管理依赖项,或者一般来说不熟悉 Go,请查看以下文档:
设置环境变量
Go 使用环境变量来控制各种功能。您可以通过所有常用方式管理这些变量。然而,Go 1.14 默认从一个特殊的 Go 环境文件 ~/.go/env
读取和写入 Go 环境变量。
- 如果
GOENV
设置为一个文件,Go 会改为读取和写入该文件。 - 如果
GOENV
未设置但GOPATH
已设置,Go 会读取和写入$GOPATH/env
。
Go 环境变量可以使用 go env <var>
读取,并且在 Go 1.14 及更高版本中,可以使用go env -w <var>=<value>
编写。例如,go env GOPATH
或 go env -w GOPATH=/go
。
发布一个模块
Go 模块和模块版本由源仓库定义,例如 Git、SVN 和 Mercurial。模块是包含 go.mod
和 Go 文件的仓库。模块版本由版本控制系统 (VCS) 标签定义。
要发布模块,请将 go.mod 和源文件推送到 VCS 仓库。要发布模块版本,请推送 VCS 标签。