文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

怎么使用Bazel构建Golang程序

2023-07-05 00:55

关注

本篇内容介绍了“怎么使用Bazel构建Golang程序”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!

从头开始一个 Golang 项目

让我们从将 Go 与 Bazel 结合使用的基础知识开始。

为此,我们需要从 github.com/bazelbuild/… 获取 Go 语言的官方构建规则。

在配置部分,您会发现:我们需要将以下这段 Starlark 语言代码,放入名为 WORKSPACE 的配置文件里面:

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")http_archive(    name = "io_bazel_rules_go",    sha256 = "8e968b5fcea1d2d64071872b12737bbb5514524ee5f0a4f54f5920266c261acb",    urls = [        "https://mirror.bazel.build/github.com/bazelbuild/rules_go/releases/download/v0.28.0/rules_go-v0.28.0.zip",        "https://github.com/bazelbuild/rules_go/releases/download/v0.28.0/rules_go-v0.28.0.zip",    ],)load("@io_bazel_rules_go//go:deps.bzl", "go_register_toolchains", "go_rules_dependencies")go_rules_dependencies()go_register_toolchains(version = "1.16.5")

让我们逐步了解这段代码所做的事情。

首先,我们使用load指令来加载并提取新功能,以在 Bazel 文件当中能够使用该功能。我们调用了两次load指令,第一次用于导入下载 HTTP 代码库的能力,第二次则是从刚下载的代码库中加载特定于 Go 的命令。

对于导入本身,我们需要提供一个导入名称。通常的命名方案是:逆反域名,后面跟命名空间和项目名称;并需将/.全部都转换为下划线_。例如:github.com/user/project变成com_github_user_projectio_bazel_rules_go这个项目由于是Bazel官方项目中的一部分,所以它使用的是bazel.io而不是github.com

如果您并不熟悉 Bazel,那么,您需要了解到:实际的构建配置是通过BUILD文件完成的。我们可以将 Go 视为任何其他语言,并使用遵循相同结构的规则:go_binarygo_librarygo_test。我在我的 Github 上准备了一个最小化的例子:github.com/HappyCerber…。您会注意到,我们需要从导入的io_bazel_rules_go代码库中加载这些规则,以使其在BUILD文件中可用。

将现有项目转换为 Bazel 构建

现在我们知道,从头全新开始是很容易。但是,如果您已经有一个 Golang 项目,并且需要将其转换为 使用 Bazel 构建怎么办?为此,我们需要使用 Bazel 官方项目中提供的另一个工具 Gazelle

为了演示,我将使用一个第三方项目,我目前正在为即将到来的系统设计课程修改该项目。

首先,我们需要创建一个WORKSPACE文件,并从 Gazelle 代码库的设置部分复制粘贴代码。

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")http_archive(    name = "io_bazel_rules_go",    sha256 = "8e968b5fcea1d2d64071872b12737bbb5514524ee5f0a4f54f5920266c261acb",    urls = [        "https://mirror.bazel.build/github.com/bazelbuild/rules_go/releases/download/v0.28.0/rules_go-v0.28.0.zip",        "https://github.com/bazelbuild/rules_go/releases/download/v0.28.0/rules_go-v0.28.0.zip",    ],)http_archive(    name = "bazel_gazelle",    sha256 = "62ca106be173579c0a167deb23358fdfe71ffa1e4cfdddf5582af26520f1c66f",    urls = [        "https://mirror.bazel.build/github.com/bazelbuild/bazel-gazelle/releases/download/v0.23.0/bazel-gazelle-v0.23.0.tar.gz",        "https://github.com/bazelbuild/bazel-gazelle/releases/download/v0.23.0/bazel-gazelle-v0.23.0.tar.gz",    ],)load("@io_bazel_rules_go//go:deps.bzl", "go_register_toolchains", "go_rules_dependencies")load("@bazel_gazelle//:deps.bzl", "gazelle_dependencies")go_rules_dependencies()go_register_toolchains(version = "1.16.5")gazelle_dependencies()

您会注意到,上述代码也导入了上一节中所提到的规则。

现在,要真正运行 Gazelle,我们需要将以下代码添加到我们的主BUILD文件中:

load("@bazel_gazelle//:def.bzl", "gazelle")# gazelle:prefix github.com/aler9/rtsp-simple-server gazelle(name = "gazelle")

gazelle:prefix注释后面的路径是整个项目所使用的 Go 导入路径。例如,main.go中有以下包的导入:

import (    "os"    "github.com/aler9/rtsp-simple-server/internal/core")

至此,我们终于可以真正运行Gazelle,让它BUILD为我们的项目生成文件了。

bazel run //:gazelle

之后,我们应该BUILD自动生成项目的所有文件:

git statusOn branch mainYour branch is up to date with 'origin/main'.Untracked files:  (use "git add <file>..." to include in what will be committed) BUILD WORKSPACE bazel-bin bazel-out bazel-test bazel-testlogs internal/aac/BUILD.bazel internal/conf/BUILD.bazel internal/confenv/BUILD.bazel internal/confwatcher/BUILD.bazel internal/core/BUILD.bazel internal/externalcmd/BUILD.bazel internal/h364/BUILD.bazel internal/hls/BUILD.bazel internal/logger/BUILD.bazel internal/rlimit/BUILD.bazel internal/rtcpsenderset/BUILD.bazel internal/rtmp/BUILD.bazelnothing added to commit but untracked files present (use "git add" to track)

但是,如果您尝试使用bazel build //...命令构建项目,实际上您会看到许多关于未定义代码库的错误。这是因为我们仍然缺少项目依赖项的定义。然而,Gazelle 连这件事也可以为我们办好(to_macro参数是可选的):

bazel run //:gazelle -- update-repos -from_file=go.mod -to_macro=deps.bzl%go_dependencies

此命令将生成一个文件名为deps.bzl的新文件(如果我们在WORKSPACE中有使用repository_macro指令定义过,那么我们省略该to_macro指令),加载该文件,以导入构建项目所需的所有代码库。

load("@bazel_gazelle//:deps.bzl", "go_repository")def go_dependencies():    go_repository(        name = "com_github_alecthomas_template",        importpath = "github.com/alecthomas/template",        sum = "h2:JYp7IbQjafoB+tBA3gMyHYHrpOtNuDiK/uB5uXxq5wM=",        version = "v0.0.0-20190718012654-fb15b899a751",    )    go_repository(        name = "com_github_alecthomas_units",        importpath = "github.com/alecthomas/units",        sum = "h2:UQZhZ2O0vMHr2cI+DC1Mbh0TJxzA3RcLoMsFw+aXw7E=",        version = "v0.0.0-20190924025748-f65c72e2690d",    )    go_repository(        name = "com_github_aler9_gortsplib",        importpath = "github.com/aler9/gortsplib",        sum = "h2:Bf0hzdN1jUWsb5Mzezq1pd18EIBeKXxk5clIpHZJ1Lk=",        version = "v0.0.0-20210724151831-dae5a1f04033",    )    go_repository(...

在这个代码库里,我实际上遇到了一个小问题。构建仍然是失败的,因为它导入的org_golang_x_tools被错误地推断为依赖项(通过从deps.bzl中删除它来修复这个问题)。您可以在我的项目分支:github.com/HappyCerber&hellip;上看到rtsp-simple-server的最终结果。

您可以在后续继续使用 Gazelle 来管理依赖项,这也是您可以将代码库引入基于 Bazel 的项目而无需实际转换它的方法:

bazel run //:gazelle -- update-repos github.com/some/repo

密封测试(Hermetic tests)

您可能会遇到的最后一个问题是密封测试。如果您看到测试因访问被拒绝、文件未找到或操作不允许失败而失败,那是因为 Bazel 强制执行密封测试。这意味着每个测试都必须完全独立并且独立于任何其他测试。

对于单元测试,任何文件都需要作为测试的依赖项提供并通过运行文件机制访问。

环境变量中提供了每个测试的临时目录,您将使用TEST_TMPDIR而不是传统的os.TempDir()函数。

密封集成和系统测试需要从一开始就仔细设计,因此转换现有的此类测试可能很棘手。遗憾的是,我在这里没有放之四海而皆准的建议。虽然将您的测试转换为密封测试可能很烦人,但这是一项值得的努力,它将为您带来更好的测试可重复性和更低的易碎性。

“怎么使用Bazel构建Golang程序”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识可以关注编程网网站,小编将为大家输出更多高质量的实用文章!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯