程序员之家 服务器常用软件
快捷导航
您的位置：首页 → 脚本专栏 → Golang → Bazel构建Golang程序

详解如何使用Bazel构建Golang程序

 更新时间：2023年01月26日 12:37:53   作者：喵个咪  
这篇文章主要为大家介绍了如何使用Bazel构建Golang程序实例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
（福利推荐：【腾讯云】服务器最新限时优惠活动，云服务器1核2G仅99元/年、2核4G仅768元/3年，立即抢购>>>：9i0i.cn/qcloud）

（福利推荐：你还在原价购买阿里云服务器？现在阿里云0.8折限时抢购活动来啦！4核8G企业云服务器仅2998元/3年，立即抢购>>>：9i0i.cn/aliyun）

使用Bazel构建Golang程序

在这篇简短的文章中，我们将介绍如何将 Golang 与 Bazel 构建系统结合使用。

具体来说，我们将讨论三个场景：

  • 从头开始一个 Golang 项目；
  • 将一个现有的 Golang 项目转换为 Bazel 构建；
  • 以及将一个第三方 Golang 项目引入到您的 Bazel 构建系统。

从头开始一个 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_project。io_bazel_rules_go这个项目由于是Bazel官方项目中的一部分，所以它使用的是bazel.io而不是github.com。

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

将现有项目转换为 Bazel 构建

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

为了演示，我将使用一个第三方项目 ( github.com/aler9/rtsp-… )，我目前正在为即将到来的系统设计课程修改该项目。

首先，我们需要创建一个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 status
On branch main
Your 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/h264/BUILD.bazel
 internal/hls/BUILD.bazel
 internal/logger/BUILD.bazel
 internal/rlimit/BUILD.bazel
 internal/rtcpsenderset/BUILD.bazel
 internal/rtmp/BUILD.bazel
nothing 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 = "h1:JYp7IbQjafoB+tBA3gMyHYHrpOtNuDiK/uB5uXxq5wM=",
        version = "v0.0.0-20190718012654-fb15b899a751",
    )
    go_repository(
        name = "com_github_alecthomas_units",
        importpath = "github.com/alecthomas/units",
        sum = "h1:UQZhZ2O0vMHr2cI+DC1Mbh0TJxzA3RcLoMsFw+aXw7E=",
        version = "v0.0.0-20190924025748-f65c72e2690d",
    )
    go_repository(
        name = "com_github_aler9_gortsplib",
        importpath = "github.com/aler9/gortsplib",
        sum = "h1:Bf0hzdN1jUWsb5Mzezq1pd18EIBeKXxk5clIpHZJ1Lk=",
        version = "v0.0.0-20210724151831-dae5a1f04033",
    )
    go_repository(
...

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

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

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

密封测试（Hermetic tests）

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

对于单元测试，任何文件都需要作为测试的依赖项提供并通过运行文件机制访问（github.com/bazelbuild/…）。

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

密封集成和系统测试需要从一开始就仔细设计，因此转换现有的此类测试可能很棘手。遗憾的是，我在这里没有放之四海而皆准的建议。

虽然将您的测试转换为密封测试可能很烦人，但这是一项值得的努力，它将为您带来更好的测试可重复性和更低的易碎性。

原文 翻译自：Golang With Bazel

以上就是详解如何使用Bazel构建Golang程序的详细内容，更多关于Bazel构建Golang程序的资料请关注程序员之家其它相关文章！

您可能感兴趣的文章:

相关文章

  • go语言实现两个协程交替打印

    go语言实现两个协程交替打印

    这篇文章主要介绍了go语言实现两个协程交替打印，文章主要分享了两种方法使用两个channel和使用一个channel，内容介绍详细具有一定的参考价值，需要的小伙伴可以参考一下
    2022-03-03
  • Golang通脉之方法详情

    Golang通脉之方法详情

    这篇文章主要介绍了Golang通脉方法，Go语言中的方法（Method）是一种作用于特定类型变量的函数。这种特定类型变量叫做接收者（Receiver）。接收者的概念就类似于，其他语言中的this或者 self，具体内容请和小编一起来学习下面文章内容吧
    2021-10-10
  • golang利用unsafe操作未导出变量-Pointer使用详解

    golang利用unsafe操作未导出变量-Pointer使用详解

    这篇文章主要给大家介绍了关于golang利用unsafe操作未导出变量-Pointer使用的相关资料，文中通过示例代码介绍的非常详细，需要的朋友可以参考借鉴，下面随着小编来一起学习学习吧
    2018-08-08
  • Golang中的panic之避免和处理程序中的异常情况

    Golang中的panic之避免和处理程序中的异常情况

    Golang中的panic是一种异常处理机制，可以在程序出现异常情况时终止程序并打印错误信息。为了避免panic对程序的影响，开发者可以采用一系列技巧，如defer+recover、编写可重入的代码、使用错误返回值等。这些技巧可以帮助开发者优雅地处理程序中的异常情况
    2023-04-04
  • 在Go网络请求中配置代理的方法详解

    在Go网络请求中配置代理的方法详解

    这篇文章主要给大家介绍了如何在Go网络请求中配置代理的方法,文章通过代码示例介绍的非常详细,对大家的学习或工作有一定的帮助,需要的朋友可以参考下
    2023-09-09
  • golang?用msgpack高效序列化的案例

    golang?用msgpack高效序列化的案例

    msgpack是一个非常受欢迎的Go序列化库,具有很好的跨语言支持，这篇文章主要介绍了golang?用msgpack高效序列化的相关知识,需要的朋友可以参考下
    2023-05-05
  • golang并发执行的几种方式小结

    golang并发执行的几种方式小结

    本文主要介绍了golang并发执行的几种方式小结，主要包括了Channel，WaitGroup ，Context，使用这三种机制中的一种或者多种可以达到并发控制很好的效果，具有一定的参考价值，感兴趣的可以了解一下
    2023-08-08
  • 浅析golang开发Error的使用详解

    浅析golang开发Error的使用详解

    Error是Go语言开发中最基础也是最重要的部分，很多朋友不明白goland error的一些基本使用方法，今天通过本文给大家详细介绍下，需要的朋友参考下吧
    2021-07-07
  • golang模板template自定义函数用法示例

    golang模板template自定义函数用法示例

    这篇文章主要介绍了golang模板template自定义函数用法,结合实例形式分析了Go语言模板自定义函数的基本定义与使用方法,需要的朋友可以参考下
    2016-07-07
  • golang 进度条功能实现示例

    golang 进度条功能实现示例

    这篇文章主要介绍了golang 进度条功能实现示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2020-08-08

最新评论

?


http://www.vxiaotou.com