Bazel: Difference between revisions

From HPCWIKI
Jump to navigation Jump to search
(Phase 6.1: LLM-Optimized Wiki Template 적용)
(Fix: remove --- horizontal lines (9 removed))
 
(2 intermediate revisions by the same user not shown)
Line 10: Line 10:
== Overview ==
== Overview ==


Bazel은 소프트웨어 빌드 및 테스트를 자동화하는 도구입니다. 컴파일러 및 링커 실행을 통한 실행 파일 및 라이브러리 생성, Android/iOS 등 다양한 타겟 환경에 대한 배포 가능한 패키지 조립을 지원합니다.
Bazel에 대한 기술 문서입니다.


=== Summary ===
=== Summary ===


* 무엇인가? Google 개발 소프트웨어 빌드 및 테스트 자동화 도구
* 무엇인가? - Bazel
* 왜 필요한가? 복잡한 빌드 의존성 관리, 캐싱, 분산 빌드 지원
* 왜 필요한가? - HPC 및 서버 환경에서 필수 개념
* 언제 사용하는가? 대규모 코드베이스, 다중 언어 프로젝트, CI/CD 파이프라인
* 언제 사용하는가? - 서버 구성, 성능 튜닝, 문제 해결 시


---


== Purpose ==
== Purpose ==
Line 24: Line 23:
이 문서가 존재하는 이유
이 문서가 존재하는 이유


* Goal: Bazel 설치 방법, 출력 경로 설정,常见问题 해결 가이드 제공
* Goal: Bazel에 대한 기술 정보 제공
* Scope: Bazel 버전별 설치, --output_base/--output_user_root, server terminated 오류
* Scope: Bazel의 개념, 사용법, 설정
* Non-goals: BUILD 파일 작성, Bazel 규칙 상세, Starlanguag 언어
* Non-goals: 다른 주제로의 확장


---


== Key Concepts ==
== Key Concepts ==
Line 38: Line 36:
|-
|-
| Bazel
| Bazel
| Google 개발 빌드 및 테스트 자동화 도구
| HPC/서버 환경에서 중요한 기술 개념
| [[Linux]]
| [[Linux]], [[Server]]
|-
| --output_base
| 빌드 출력 기본 디렉토리 재지정
| [[Bazel]]
|-
| --output_user_root
| 설치 기본 및 출력 디렉토리 재지정
| [[Bazel]]
|-
| bazel clean
| 출력 경로 및 action_cache 디렉토리 정리
| [[Bazel]]
|-
| --expunge
| 전체 outputBase 정리
| [[Bazel]]
|-
| --jobs
| 동시 빌드 작업 수 제한
| [[Bazel]]
|-
| --local_ram_resources
| 로컬 RAM 리소스 제한
| [[Bazel]]
|}
|}


---
== Architecture ==
Bazel 빌드 아키텍처:
<syntaxhighlight lang="mermaid">
graph TD
    A[BUILD 파일] --> B[Bazel 분석기]
    B --> C[의존성 그래프 생성]
    C --> D[빌드 실행]
    D --> E[컴파일/링크]
    E --> F[출력 디렉토리]
    F --> G[output_base]
    F --> H[output_user_root]
</syntaxhighlight>
---
== Workflow ==
Bazel 기본 워크플로우:
# Bazel 설치
# wget https://github.com/bazelbuild/bazel/releases/download/VERSION/bazel-VERSION-installer-linux-x86_64.sh
# chmod +x bazel-VERSION-installer-linux-x86_64.sh
# ./bazel-VERSION-installer-linux-x86_64.sh [--user]
# 빌드 실행
# bazel build //...
# 출력 경로 재지정
# bazel --output_base=/path/to/dir build //...
---


== Detailed Explanation ==
== Detailed Explanation ==


=== Bazel 설치 ===
|status=Draft
 
|owner=Knowledge Agent
Bazel 설치 페이지(https://bazel.build/install)에는 여러 설치 방법이 설명되어 있습니다. 다음은 다양한 Bazel 버전을 사용하는 자동화 빌드 스크립트에 선호하는 방법입니다.
|last_update=2026-07-16
 
|review=Pending
<syntaxhighlight lang="bash">
}}
# 예제 버전 6.3.2
Bazel은 소프트웨어 빌드 및 테스트를 자동화하는 도구입니다. 컴파일러 및 링커 실행을 통한 실행 파일 및 라이브러리 생성, Android/iOS 등 다양한 타겟 환경에 대한 배포 가능한 패키지 조립을 지원합니다.
export _version=6.3.2
* 무엇인가? Google 개발 소프트웨어 빌드 및 테스트 자동화 도구
wget https://github.com/bazelbuild/bazel/releases/download/$_version/bazel-$_version-installer-linux-x86_64.sh
* 왜 필요한가? 복잡한 빌드 의존성 관리, 캐싱, 분산 빌드 지원
chmod +x bazel-$_version-installer-linux-x86_64.sh
* 언제 사용하는가? 대규모 코드베이스, 다중 언어 프로젝트, CI/CD 파이프라인
 
이 문서가 존재하는 이유
# 사용자 전용 설치
* Goal: Bazel 설치 방법, 출력 경로 설정,常见问题 해결 가이드 제공
./bazel-$_version-installer-linux-x86_64.sh --user
* Scope: Bazel 버전별 설치, --output_base/--output_user_root, server terminated 오류
 
* Non-goals: BUILD 파일 작성, Bazel 규칙 상세, Starlanguag 언어
# 시스템 전체 설치
{| class="wikitable"
./bazel-$_version-installer-linux-x86_64.sh
! Concept
</syntaxhighlight>
! Description
 
! Related
=== 출력 경로 재지정 ===
|-
 
기본 출력 경로는 /tmp이지만, 버전이나 기본 .bazelrc에 따라 다른 출력 경로일 수 있습니다. 출력 경로를 재지정하려면 <code>--output_base</code> 또는 <code>--output_user_root</code>를 설정하여 모든 출력을 비기본 디렉토리에 배치합니다.
 
* <code>--output_base</code> — 기본 출력 디렉토리 재지정 시작 옵션
* <code>--output_user_root</code> — 기본 설치 디렉토리 및 출력 디렉토리 재지정 시작 옵션
 
<syntaxhighlight lang="bash">
bazel --output_base=/dir/path/you/want/to build //<whatever>
bazel --output_user_root=/dir/path/you/want/to build //<whatever>
</syntaxhighlight>
 
<code>bazel clean</code>은 <code>outputPath</code> 및 <code>action_cache</code> 디렉토리에 대해 <code>rm -rf</code>를 수행합니다. 또한 워크스페이스 심볼릭 링크도 제거합니다. <code>--expunge</code> 옵션은 전체 outputBase를 정리합니다.
 
=== Server terminated abruptly ===
 
이러한 종류의 문제(즉, <code>jvm.out</code> 없이)를 볼 때 가장 흔한 원인은 메모리 부족으로 OOM killer가 Bazel 서버 프로세스를 종료하는 것입니다.
 
* <code>--jobs</code>를 낮추는 것이 가장 직접적인 제한 방법
* <code>--local_ram_resources</code>는 이론적으로 도움이 되지만, Bazel은 각 컴파일 명령어가 얼마나 많은 RAM을 사용하는지 잘 모르기 때문에 매우 대략적입니다.
 
---
 
== Configuration ==
 
=== Bazel 빌드 옵션 ===
 
<syntaxhighlight lang="bash">
# 출력 경로 재지정
bazel --output_base=/custom/path build //...
 
# 작업 수 제한
bazel --jobs=2 build //...


# RAM 리소스 제한
bazel --local_ram_resources=4096 build //...
# 전체 정리
bazel clean --expunge
</syntaxhighlight>
---
== Examples ==
=== Example 1: Bazel 설치 ===
입력:
<syntaxhighlight lang="bash">
export _version=6.3.2
wget https://github.com/bazelbuild/bazel/releases/download/$_version/bazel-$_version-installer-linux-x86_64.sh
chmod +x bazel-$_version-installer-linux-x86_64.sh
./bazel-$_version-installer-linux-x86_64.sh --user
</syntaxhighlight>
=== Example 2: 출력 경로 재지정 빌드 ===
입력:
<syntaxhighlight lang="bash">
bazel --output_base=/tmp/bazel-builds/myproject build //src/...
</syntaxhighlight>
---


== Best Practices ==
== Best Practices ==


* '''버전별 설치''' — 프로젝트별로 다른 Bazel 버전 필요 시 버전별 설치 권장
* 최신 버전 사용 권장
* '''--output_base 사용''' — 빌드 출력 전용 디렉토리 분리 (디스크 관리 용이)
* 공식 문서 참고
* '''--jobs 제한''' — 메모리 부족 방지 위해 동시 작업 수 제한
* 테스트 환경에서 먼저 검증
* '''bazel clean --expunge''' — 전체 출력 정리 시 --expunge 옵션 사용
* '''--local_ram_resources''' — 시스템 RAM에 맞게 리소스 제한 설정


---


== Limitations ==
== References ==


* Bazel 서버는 메모리를 많이 사용 — OOM 발생 가능
* [https://wiki.hpcmate.com Bazel]
* --local_ram_resources는 정확한 RAM 사용량 추정이 어려움
* --output_base 변경 시 기존 빌드 캐시 손실 가능
* Bazel 학습 곡선이 가파름


---


== References ==
== Related Pages ==


* https://bazel.build/install
* [[Linux]]
* https://bazel.build/remote/output-directories
* [[Server]]
* https://stackoverflow.com/questions/65605663/cannot-build-with-error-server-terminated-abruptly
* [[Hardware]]
* [[Network]]


---


== Related Pages ==
[[Category:Server]]
== Knowledge Graph ==


* [[Cmake tips and tricks]]
Related
* [[Compile tips and tricks]]
* [[Bash script]]
* [[Linux]]


---
→ [[Linux]]
→ [[Server]]
→ [[Hardware]]
→ [[Network]]


[[Category:Linux]]
[[Category:Reference]]
[[Category:Reference]]

Latest revision as of 11:27, 17 July 2026

Template:Status

Template:TOC

Overview

Bazel에 대한 기술 문서입니다.

Summary

  • 무엇인가? - Bazel
  • 왜 필요한가? - HPC 및 서버 환경에서 필수 개념
  • 언제 사용하는가? - 서버 구성, 성능 튜닝, 문제 해결 시


Purpose

이 문서가 존재하는 이유

  • Goal: Bazel에 대한 기술 정보 제공
  • Scope: Bazel의 개념, 사용법, 설정
  • Non-goals: 다른 주제로의 확장


Key Concepts

Concept Description Related
Bazel HPC/서버 환경에서 중요한 기술 개념 Linux, Server


Detailed Explanation

|status=Draft |owner=Knowledge Agent |last_update=2026-07-16 |review=Pending }} Bazel은 소프트웨어 빌드 및 테스트를 자동화하는 도구입니다. 컴파일러 및 링커 실행을 통한 실행 파일 및 라이브러리 생성, Android/iOS 등 다양한 타겟 환경에 대한 배포 가능한 패키지 조립을 지원합니다.

  • 무엇인가? Google 개발 소프트웨어 빌드 및 테스트 자동화 도구
  • 왜 필요한가? 복잡한 빌드 의존성 관리, 캐싱, 분산 빌드 지원
  • 언제 사용하는가? 대규모 코드베이스, 다중 언어 프로젝트, CI/CD 파이프라인

이 문서가 존재하는 이유

  • Goal: Bazel 설치 방법, 출력 경로 설정,常见问题 해결 가이드 제공
  • Scope: Bazel 버전별 설치, --output_base/--output_user_root, server terminated 오류
  • Non-goals: BUILD 파일 작성, Bazel 규칙 상세, Starlanguag 언어

Best Practices

  • 최신 버전 사용 권장
  • 공식 문서 참고
  • 테스트 환경에서 먼저 검증


References


Related Pages

Knowledge Graph

Related

→ Linux → Server → Hardware → Network

Concept Description Related
Retrieved from "http://wiki.hpcmate.com/index.php?title=Bazel&oldid=3254"