Bazel과 Go lang을 사용한 간단한 hello world 프로그램-Golang-php.cn

Simple hello world program using Bazel and Go lang

"Bazel, Gazelle 및 bzlmod를 사용하여 모노레포에서 Go로 빌드하기"에 대한 게시물을 작성하고 동료들과 공유한 후 모노레포 개발에 대한 관심이 점점 커지는 것을 보았습니다. 나는 그것이 가져올 수 있는 이점을 이해할 만큼 충분한 경험을 가진 사람이 아직 많지 않다는 것을 배웠습니다. 그래서 Bazel과 Go lang을 이용한 Simple hello world 프로그램 포스팅을 시작으로 시리즈로 전환하기로 결정했습니다

이번 게시물에서는 누군가가 즉시 작업을 시작할 수 있도록 코드 조각과 함께 Bazel의 매우 기본적인 몇 가지 개념을 다루려고 합니다.

바젤이란 무엇입니까?

공식 문서에 따르면

Bazel은 Make, Maven, Gradle과 유사한 오픈 소스 빌드 및 테스트 도구입니다. 사람이 읽을 수 있는 고급 빌드 언어를 사용합니다. Bazel은 여러 언어로 프로젝트를 지원하고 여러 플랫폼에 대한 출력을 빌드합니다. Bazel은 여러 저장소와 다수의 사용자에 걸쳐 대규모 코드베이스를 지원합니다.

Google에서 수십 년 동안 사용해 왔으며 철저한 실전 테스트를 거쳤습니다. 제가 이 사실을 어떻게 알게 되었는지 자세한 내용은 위에 링크된 게시물에서 확인하실 수 있습니다.

1단계: 저장소 설정

이 시리즈의 목적을 위해 저는 github.com/nixclix/basil에 시간이 지남에 따라 발전할 저장소를 만들었습니다. 이 게시물을 작성하는 시점에서 최신 커밋은 https://github.com/nixclix/basil/tree/d8af2aea6fb8b692f735f9959429df9fcd28422b

입니다.

그러므로 선택하려는 공급자에 대해 새로운 git 저장소를 생성하세요

.gitignore의 경우 커밋에 불필요한 파일을 포함하지 않도록 다음을 추가하는 것이 좋습니다

# If you prefer the allow list template instead of the deny list, see community template:
# https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore
#
bazel-*
/.ijwb
/.clwb
/.idea
/.project
*.swp
/.bazelrc.user

# macOS-specific excludes
.DS_Store

# Binaries for programs and plugins
*.exe
*.exe~
*.dll
*.so
*.dylib

# Test binary, built with `go test -c`
*.test

# Output of the go coverage tool, specifically when used with LiteIDE
*.out

# Dependency directories (remove the comment below to include it)
# vendor/

# Go workspace file
go.work
go.work.sum

# env file
.env

로그인 후 복사

2단계: Bazel 상용구 추가

Bazel 6.3부터는 더 이상 WORKSPACE 파일이 필요하지 않습니다. 따라서 저장소 루트에서 다음을 생성하는 것부터 시작하겠습니다

MODULE.bazel

"""Building go applications in a monorepo environment"""

module(name = "basil", version = "0.0.0")
http_file = use_repo_rule(
    "@bazel_tools//tools/build_defs/repo:http.bzl", "http_file"
)
http_archive = use_repo_rule(
    "@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive"
)

# https://github.com/bazelbuild/rules_go/blob/master/docs/go/core/bzlmod.md
bazel_dep(name = "rules_go", version = "0.50.1")
bazel_dep(name = "gazelle", version = "0.39.1")

GO_VERSION = "1.23.2"

go_sdk = use_extension("@rules_go//go:extensions.bzl", "go_sdk")
go_sdk.download(version = GO_VERSION)

go_deps = use_extension("@gazelle//:extensions.bzl", "go_deps")
go_deps.from_file(go_mod = "//:go.mod")

로그인 후 복사

여기에서 사용하려는 Go 버전과 Gazelle 및 Rules_go 버전을 설정합니다.

BUILD 파일 관리를 위해 Gazelle을 사용할 예정입니다. Gazelle을 사용하면 빌드 파일 생성이 매우 편리해집니다. 자세한 내용은 여기에서 확인하세요

BUILD.bazel

load("@gazelle//:def.bzl", "gazelle")

gazelle(name = "gazelle")

gazelle(
    name = "gazelle-update-repos",
    args = [
        "-from_file=go.mod",
        "-to_macro=deps.bzl%go_dependencies",
        "-prune",
    ],
    command = "update-repos",
)

로그인 후 복사

이것은 저장소의 루트에 있어야 합니다. 이는 go mod 파일의 소스와 기타 프로세스 실행에 대해 Gazel에게 지시합니다

다음으로 해당 콘텐츠가 포함된 파일을 3개 더 만듭니다. 지금은 이것이 무엇을 하는지 걱정하지 마세요.

.bazeignore

runfiles/
bzlmod/

로그인 후 복사

.bazelrc

# Enable Bzlmod for every Bazel command
common --enable_bzlmod

로그인 후 복사

.bazel버전

# If you prefer the allow list template instead of the deny list, see community template:
# https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore
#
bazel-*
/.ijwb
/.clwb
/.idea
/.project
*.swp
/.bazelrc.user

# macOS-specific excludes
.DS_Store

# Binaries for programs and plugins
*.exe
*.exe~
*.dll
*.so
*.dylib

# Test binary, built with `go test -c`
*.test

# Output of the go coverage tool, specifically when used with LiteIDE
*.out

# Dependency directories (remove the comment below to include it)
# vendor/

# Go workspace file
go.work
go.work.sum

# env file
.env

로그인 후 복사

좋아요. 이제 몇 가지 기본 사항을 작동하는 데 필요한 모든 것이 갖추어져 있을 것입니다. 이제 루트에서 bazel build //...를 실행하면 bazel은 저장소를 통과하여 발견한 모든 패키지를 빌드할 수 있습니다. Bazel은 이전 빌드의 패키지 출력을 캐시하므로 이후 빌드는 매우 빠릅니다.

다음으로 실제 Hello World 프로그램을 살펴보겠습니다.

3단계: helloworld 패키지 작성

기본적인 코드 구성을 위해 /packages라는 디렉토리에 모든 Go 코드를 작성하겠습니다. 이렇게 하면 코드의 다른 부분에 있는 모든 참조가 이를 //packages/...

로 참조할 수 있습니다.

packages 디렉토리에 helloworld라는 디렉토리를 생성하고 다음을 추가해보겠습니다

helloworld.go

"""Building go applications in a monorepo environment"""

module(name = "basil", version = "0.0.0")
http_file = use_repo_rule(
    "@bazel_tools//tools/build_defs/repo:http.bzl", "http_file"
)
http_archive = use_repo_rule(
    "@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive"
)

# https://github.com/bazelbuild/rules_go/blob/master/docs/go/core/bzlmod.md
bazel_dep(name = "rules_go", version = "0.50.1")
bazel_dep(name = "gazelle", version = "0.39.1")

GO_VERSION = "1.23.2"

go_sdk = use_extension("@rules_go//go:extensions.bzl", "go_sdk")
go_sdk.download(version = GO_VERSION)

go_deps = use_extension("@gazelle//:extensions.bzl", "go_deps")
go_deps.from_file(go_mod = "//:go.mod")

로그인 후 복사

BUILD.bazel

load("@gazelle//:def.bzl", "gazelle")

gazelle(name = "gazelle")

gazelle(
    name = "gazelle-update-repos",
    args = [
        "-from_file=go.mod",
        "-to_macro=deps.bzl%go_dependencies",
        "-prune",
    ],
    command = "update-repos",
)

로그인 후 복사

go 프로그램은 상당히 간단합니다. Hello World 메시지를 간단하게 인쇄하는 간단한 주요 기능이 있습니다.

우리가 관심을 갖는 부분은 BUILD.bazel 파일입니다. 이 블록을 블록별로 살펴보고 이것이 무엇을 의미하는지 이해해 봅시다.

첫 번째 줄은 rule_go에서 go_binary 및 go_library 매크로를 로드합니다. 나중에 코드에서 이러한 항목이 사용되는 것을 확인할 수 있습니다.

10번째 줄에서는 helloworld_lib라는 라이브러리를 정의하고 라이브러리 소스를 helloworld.go로 지정합니다. 이 패키지를 가져올 수 있도록 만들어야 하는 경우 Basil/packages/helloworld_lib에서 사용할 수 있는 경로를 지정할 수도 있습니다. 그런 다음 가시성이 나오며 여기서는 라이브러리가 이 패키지 내에서만 볼 수 있는 비공개임을 지정합니다. 향후 게시물에서는 다른 패키지의 종속성을 사용하기 위해 이러한 매개변수를 변경하는 방법을 살펴볼 수 있습니다.

3번째 줄에서는 rule_go의 go_binary 매크로를 사용하여 프로그램에 대한 바이너리를 생성합니다. 여기서는 이전에 embed 매개변수에서 정의한 라이브러리를 지정합니다. 패키지 가시성은 바이너리에도 적용됩니다.