핵심 요약

Yocto bitbake 빌드를 가장 빠르게 시작하는 방법은 6.0 “Wrynose” LTS(2030년까지 지원) 기준 bitbake-setup 도구와 구성 프래그먼트(fragments)를 활용하는 것입니다. 예전의 git clone poky 대신 필수 패키지와 en_US.UTF-8 로캘을 갖춘 뒤 bitbake-setup init --non-interactive로 환경을 생성합니다. 이어 init-build-env를 source하고 기본으로 꺼져 있는 root 로그인 프래그먼트를 활성화한 후 bitbake core-image-minimal을 실행합니다. 빌드가 끝나면 runqemu qemux86-64 nographic으로 QEMU에서 부팅해 root로 로그인합니다.

이 글은 Yocto Project 공식 Quick Build 문서(6.0)와 직접 실행한 bitbake-setup 출력을 바탕으로 정리했습니다. 빌드 시간, 디스크 사용량, 부팅 로그처럼 직접 측정하지 않은 항목은 수치를 적지 않고 “일반적인 예시(실측 아님)“으로 표시했습니다.

Yocto bitbake 빌드는 무엇이고, 빌드 전에 무엇을 준비하나?

Yocto Project 안에 Poky 참조 배포판이 있고, Poky가 BitBake로 레시피와 태스크를 실행한다. 메타데이터는 openembedded-core, meta-yocto, bitbake, yocto-docs. 현재 LTS는 6.0 Wrynose(2026-04, 2030년까지), 이전 LTS는 5.0 Scarthgap(2028-04까지). 호스트는 디스크 140GB 이상, RAM 32GB 이상, Git 1.8.3.1+, tar 1.28+, Python 3.9+, gcc 10.1+, GNU make 4.0+

한 줄 답: Yocto Project는 임베디드 리눅스 구축 프로젝트, Poky는 참조 배포판, BitBake는 레시피를 읽어 태스크를 실행하는 빌드 엔진입니다. core-image-minimal 이미지를 빌드해 runqemu로 검증하려면 6.0 LTS 기준 넉넉한 디스크와 RAM, 필수 패키지, en_US.UTF-8 로캘 준비가 필요합니다.

  • Yocto Project: 임베디드 리눅스 시스템을 만들기 위한 오픈소스 프로젝트입니다.
  • Poky: Yocto Project의 참조 배포판입니다.
  • BitBake: 레시피(메타데이터)를 파싱하고 태스크 의존성을 풀어 실행하는 엔진입니다.
  • 릴리스: 현재 LTS는 2026년 4월에 나온 6.0 “Wrynose”이고 2030년까지 지원됩니다. 이전 LTS인 5.0 “Scarthgap”은 2028년 4월까지입니다.

호스트 요구사항(6.0 Quick Build 문서 기준)은 다음과 같습니다.

  • 여유 디스크 140GB 이상, RAM 32GB 이상
  • 지원 배포판: 최신 Fedora, openSUSE, CentOS, Debian, Ubuntu
  • 도구 버전: Git 1.8.3.1 이상, tar 1.28 이상, Python 3.9.0 이상, gcc 10.1 이상, GNU make 4.0 이상

참고로 이전 LTS(5.0 Scarthgap) 문서는 디스크 90GB, RAM 8GB, Python 3.8.0 이상을 기준으로 했습니다.

Ubuntu/Debian에서는 아래 패키지를 설치합니다.

sudo apt-get install build-essential chrpath cpio debianutils diffstat file gawk gcc git iputils-ping libacl1 libcrypt-dev locales python3 python3-git python3-jinja2 python3-pexpect python3-pip python3-subunit socat texinfo unzip wget xz-utils zstd

Yocto 빌드에는 en_US.UTF-8 로캘이 필요합니다. 먼저 설치 여부를 확인합니다.

locale --all-locales | grep en_US.utf8

출력이 없다면 아래 명령으로 로캘을 설정합니다.

sudo dpkg-reconfigure locales
# 또는 /etc/locale.gen에 en_US.UTF-8 UTF-8 추가 후 sudo locale-gen 실행

bitbake-setup으로 환경을 구성하고 첫 bitbake 빌드는 어떻게 실행하나?

bitbake-setup init --non-interactive poky-wrynose poky distro/poky machine/qemux86-64, source init-build-env, root 로그인 프래그먼트 활성화, bitbake core-image-minimal, deploy/images/qemux86-64, runqemu qemux86-64 nographic, root 로그인. local.conf는 거의 비어 있고 머신과 배포판은 프래그먼트로 고른다. 6.0에서는 poky clone과 oe-init-build-env 대신 bitbake-setup과 init-build-env를 쓴다

한 줄 답: bitbake-setup init으로 LTS 브랜치와 타깃 머신을 초기화하고, 생성된 init-build-env를 source한 뒤, root 로그인 프래그먼트를 켜고 bitbake core-image-minimal을 실행합니다.

6.0에서 달라진 점은 두 가지입니다. poky를 직접 clone하는 대신 bitbake-setup을 쓰고, local.conf의 MACHINE을 직접 고치는 대신 구성 프래그먼트로 머신과 배포판을 고릅니다. 그래서 local.conf는 거의 비어 있습니다.

1) bitbake-setup 받기와 초기화

git clone https://git.openembedded.org/bitbake
./bitbake/bin/bitbake-setup init

LTS용 비대화형 초기화는 아래 명령입니다. 이 명령은 도구가 직접 출력해 준 형태를 그대로 옮겼습니다.

bitbake-setup init --non-interactive poky-wrynose poky distro/poky machine/qemux86-64

2) 생성된 디렉터리 구조

  • build/: BitBake 빌드 디렉터리와 README
  • layers/: bitbake, openembedded-core, meta-yocto, yocto-docs
  • config/: 설정 프래그먼트 메타데이터
  • build/conf/: bblayers.conf, local.conf, site.conf, templateconf.cfg, conf-notes.txt, conf-summary.txt

3) 빌드 환경 불러오기

source poky-wrynose/build/init-build-env

스크립트 이름은 init-build-env입니다. 예전 poky의 oe-init-build-env에서 바뀌었습니다.

4) 프래그먼트 확인과 root 로그인 켜기

bitbake-config-build list-fragments

목록에서 distro/poky와 machine/qemux86-64가 활성화되어 있는지 확인합니다. 6.0에서는 root 로그인이 기본으로 꺼져 있으므로, QEMU에서 빈 비밀번호로 root 로그인을 하려면 아래 프래그먼트를 켜야 합니다.

bitbake-config-build enable-fragment core/yocto/root-login-with-empty-password

선택 사항으로 sstate 미러와 해시 동등성을 쓰는 가속 프래그먼트도 있습니다. 다운로드가 직접 빌드하는 것보다 빠를 때만 도움이 됩니다.

bitbake-config-build enable-fragment core/yocto/sstate-mirror-cdn

5) 첫 이미지 빌드

bitbake core-image-minimal

공식 문서는 GUI 이미지인 core-image-sato를 빌드합니다. 이 글에서는 더 작은 표준 이미지인 core-image-minimal을 빌드하며, nographic 콘솔로 띄우기에도 충분합니다.

첫 빌드가 오래 걸리는 이유는 공식 문서의 표현대로 “The build process creates an entire Linux distribution, including the toolchain, from source.”이기 때문입니다. 툴체인, 커널, 루트 파일시스템까지 전부 소스에서 빌드하므로 단일 패키지 빌드와 비교할 수 없는 시간과 CPU를 씁니다. 구체적인 빌드 시간과 디스크 사용량은 직접 측정하지 않았기 때문에 수치를 적지 않습니다.

이전 LTS(5.0 Scarthgap)를 쓰신다면 방식이 다릅니다. git clone git://git.yoctoproject.org/poky 후 git checkout -t origin/scarthgap -b my-scarthgap, source oe-init-build-env를 실행하고 local.conf에서 MACHINE을 설정하는 흐름이었습니다.

빌드한 이미지는 QEMU로 어떻게 띄우나?

한 줄 답: 산출물이 build/tmp/deploy/images/qemux86-64/에 생기면 runqemu qemux86-64 nographic으로 GUI 없이 부팅하고 root로 로그인합니다.

터미널 콘솔(헤드리스)로 띄우는 명령입니다.

runqemu qemux86-64 nographic

공식 Quick Build 문서의 예시는 아래 명령입니다. snapshot은 루트 파일시스템 변경을 QEMU 종료 후 남기지 않는 옵션입니다.

runqemu snapshot

커널 이미지, 루트 파일시스템 이미지 등 QEMU 부팅에 쓰는 파일은 build/tmp/deploy/images/qemux86-64/에 있습니다. 로그인 프롬프트에서 root를 입력하면 되고, 앞서 root 로그인 프래그먼트를 켰으므로 비밀번호는 필요하지 않습니다.

아래는 일반적인 예시(실측 아님)입니다. 시간이나 크기 같은 수치는 넣지 않았습니다.

qemux86-64 login: root
root@qemux86-64:~#

종료 방법은 모드에 따라 다릅니다.

  • nographic 콘솔: 셸에서 poweroff를 입력하거나 Ctrl-A X(QEMU 기본 단축키)
  • 그래픽 모드: 실행한 터미널에서 Ctrl-C

첫 빌드가 실패하면 어디부터 봐야 할까?

한 줄 답: 로캘 누락, 호스트 필수 도구 부재, 네트워크 fetch 차단이 흔한 원인이므로 에러 로그와 호스트 환경부터 확인합니다.

bitbake 서버가 시작되지 않고 en_US.UTF-8 에러가 나오면?

로캘이 없는 환경에서 실제로 나온 출력입니다(실제 출력).

ERROR: Unable to start bitbake server (None)
ERROR: Server didn't start, last 60 loglines (.../poky-wrynose/build/bitbake-cookerdaemon.log):
Please make sure locale 'en_US.UTF-8' is available on your system

해결: sudo dpkg-reconfigure locales를 실행하거나, /etc/locale.gen에 en_US.UTF-8 UTF-8을 추가한 뒤 sudo locale-gen으로 로캘을 생성합니다.

소스 다운로드(fetcher)가 실패하거나 도중에 멈추면?

프록시나 방화벽 때문에 외부 git/tarball 접근이 막히는 경우가 많습니다. 네트워크와 프록시 설정(http_proxy, https_proxy)을 점검합니다. 또 여유 디스크가 공식 권장치(140GB)에 못 미치면 빌드 도중 멈출 수 있으니 함께 확인합니다.

재빌드를 빠르게 하려면 캐시를 어떻게 공유하나?

DL_DIR(다운로드 소스)과 SSTATE_DIR(sstate 캐시)를 별도 디렉터리로 지정해 여러 빌드 디렉터리가 공유하면 반복 빌드가 빨라집니다.

첫 빌드 다음 단계는 무엇을 보면 되나?

  • bbappend로 레시피 수정하기
  • Yocto systemd 서비스 레시피
  • IMAGE_INSTALL과 RDEPENDS