在企业内部创建一个公共的Golang模块工程可以帮助提高代码复用性和开发效率。本文将从如何创建一个公共的Golang工程开始,指导你一步步创建它、并引入到你的工程中。
1、公共模块规范
下面是一个简单的步骤指南来创建这样一个公共模块项目。
创建版本控制仓库:使用版本控制工具(如Git)创建一个新的代码仓库,用于管理该公共模块工程的代码。
项目结构:定义好项目的结构,使其易于理解和使用。一个常见的Golang项目结构如下:
my-module/
|- README.md # 项目文档和说明
|- go.mod # Go模块定义文件
|- go.sum # Go模块的依赖版本文件
|- cmd/ # 命令行应用程序目录(如果有的话)
|- pkg/ # 项目的库代码目录
|- internal/ # 内部库代码目录,不对外公开
|- examples/ # 示例代码目录
|- tests/ # 单元测试和集成测试目录
-
Go模块初始化:进入项目根目录,运行
go mod init <module-name>
来初始化 Go 模块。模块名称应该是该模块工程的唯一标识符。 -
编写代码:在
pkg/
目录下编写公共的Golang库代码。这些代码应该是可复用的,不与具体应用逻辑绑定。 -
文档和注释:对于公共模块,清晰的文档和注释是非常重要的。确保每个公共函数和类型都有良好的注释,方便其他开发人员理解和使用。
-
示例代码:在
examples/
目录下提供一些简单的示例代码,展示如何使用这个公共模块。 -
单元测试:编写完整的单元测试和集成测试,保证模块的正确性和稳定性。测试代码放在
tests/
目录下。 -
版本管理:在Go中,版本管理使用Go Modules。当你的模块准备发布新版本时,确保适当地更新go.mod文件,并通过
go get <module-name>@<version>
或go mod tidy
来更新依赖关系。 -
持续集成:将公共模块纳入到企业的持续集成流程中,确保每次修改都通过了测试,并符合质量标准。
-
发布和文档:根据企业内部的发布流程,发布新的版本,并及时更新项目文档,方便其他开发人员使用。
以上是一个基本的指南来创建企业内部的Golang公共模块工程,可根据实现项目灵活调整。记得在开发过程中关注代码质量和安全性,并积极倾听来自其他开发人员的反馈,不断改进和优化模块。
2、如何引入公共模块
在Go中引入私有Git仓库的包可以通过在 go.mod
文件中添加 replace
或 require
语句来实现,具体取决于你的使用场景。以下是引入私有Git仓库包的三种常见方法。
在下述前两种方法中,你需要将 github.com/yourusername/yourprivatepkg
替换为你私有Git仓库的实际路径,然后根据需要设置路径或版本号。
完成后,运行 go mod tidy
命令来更新依赖。Go会自动下载和管理你的私有Git仓库包。
2.1 私有项目的路径替换
使用 replace
语句实现。
如果你希望在开发过程中使用本地路径或其他方式替代私有Git仓库,可以使用 replace
语句。这样可以方便地在不同环境中进行开发和测试。
如果私有项目 A 依赖另一个私有项目 B,且通过 go get
无法获取权限,可以采用 replace
方式。
在你的项目的 go.mod
文件中添加类似如下的 replace
语句,将私有Git仓库的路径替换为本地路径或其他路径:
replace github.com/yourusername/yourprivatepkg => /path/to/local/repo
或者,你可以使用相对路径:
replace github.com/yourusername/yourprivatepkg => ../path/to/local/repo
2.2 go mod私有项目的访问
使用 require
语句实现。
如果你想直接从私有Git仓库获取包并将其添加到项目依赖中,可以使用 require
语句。
在你的项目的 go.mod
文件中添加类似如下的 require
语句,将私有Git仓库的路径和版本号添加到依赖中:
require github.com/yourusername/yourprivatepkg v1.0.0
要实现上述方式,需要额外的配置,确保能够正常 go get
私有Git仓库的工程。
-
设置 Go GOPRIVATE 变量
# 配置多个私有项目地址 go env -w GOPRIVATE="gitlab.example.com" # 其中gitee.com/user 是你的个人账户所在地址
-
默认情况下,如果设置GOPRIVATE,会自动设置GONOPROXY和GONOSUMDB配置;
-
Golang项目非代理NOPROXY配置
如果设置GONOPROXY和GONOSUMDB均为none,意味着所有module,不管是公共的还是私有的,都要经过proxy下载,经过sumdb验证。
-
-
私有仓库的请求认证
方法一:在请求URL中嵌入认证信息
git config --global url."https://${user}:${password}@gitlab.example.com".insteadOf "https://gitlab.example.com"
Git全局配置查看和删除:
#查看git全局配置 git config --global -l # 删除url路径替换, 或是修改${GitProject}/.git/config文件中对应url git config --global --unset url."git@gitlab.example.com".insteadOf
方法二:使用SSH替换HTTPS进行认证
git config --global url."git@gitlab.example.com".insteadOf "https://gitlab.example.com"
-
Golang私有项目的http访问
如果私有库不支持https协议,会报如下的错误。这是因为Go更新依赖时,会强制校验CA证书来确保依赖库的安全性。
go: gitee.com/modules/project@v0.0.0-20200320063051-28c4ad7fe2ea: unrecognized import path "gitee.com/modules/project": https fetch: Get "https://gitee.com/modules/project?go-get=1": dial tcp 123.123.123:443: connect: connection refused
如果私有库不支持https协议,还需要go配置参数或环境变量,使其使用http方式访问。
方法一:go get -insecure
使用
go get -insecure
,这种方式不推荐,原因如下:-
添加 `-insecure`` 参数,即表示更新依赖时可以不去校验CA证书,但是这会带来一个问题:范围无法界定(overkill),所有与要更新依赖相关联的依赖,均不会去做校验,可能会意外更新到不安全的依赖。
-
-insecure
仅支持 go get 命令,不支持 go mod 命令,因此使用 go mod 命令时是无法更新不支持https协议的私有库的。
方法二:GOINSECURE
添加
GOINSECURE
参数,推荐这种方式。-
在Go 1.14 中增加了新的环境变量,用于指定哪些域名下的仓库不去校验 CA 证书。
-
使用方式同
GOINSECURE
类似go env -w GOINSECURE=gitlab.example.com
。
-
2.3 git 子模块(推荐)
在 Go 中,你可以使用 Git 子模块的方式引用私有的公共模块工程,以便在你的项目中使用。
-
创建 Git 子模块
在你的项目中,使用以下命令添加 Git 子模块,将私有的公共模块工程作为子模块引入:
git submodule add <repository-url> path/to/submodule
其中
<repository-url>
是你私有模块工程的 Git 仓库 URL,path/to/submodule
是子模块在你的项目中的路径。 -
配置认证
如果你的私有模块工程需要身份验证,你可能需要在执行
go get
或go mod
时提供适当的认证凭证。这可能包括用户名、密码、Personal Access Token(如果使用 GitLab)等。 -
使用子模块的包
在你的项目中,可以通过
import
语句引入子模块的包,然后在代码中使用这些包。import ( "your/repo/path/to/submodule/package" ) func main() { // 使用子模块的包 submodulepackage.DoSomething() }
-
使用 Go Modules 进行版本管理
确保你的项目启用了 Go Modules,并在
go.mod
文件中添加了子模块的引用。go mod edit -replace=example.com/submodule=path/to/submodule
-
更新子模块
如果子模块的工程代码发生变化,你可以进入子模块目录,使用
git pull
更新子模块的代码。然后在你的项目根目录使用go mod tidy
更新模块依赖。
3、总结
条条道路通罗马,技术更是如此。
具体选择那种取决于你的实际环境、实际场景,这里只提供一个思路、方向供大家参考。文章来源:https://www.toymoban.com/news/detail-647672.html
参考文章:文章来源地址https://www.toymoban.com/news/detail-647672.html
- Go Mod引用私有库
- 怎么让Go Modules使用私有依赖模块
- Git: submodule 子模块简明教程
到了这里,关于Golang项目中如何轻松实现私有仓库pkg包的引入的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!