첫 빌드: 코어 이미지 및 빌드 프로세스¶

Yocto 환경 초기화¶

컨테이너 내에서 Yocto 빌드 환경을 초기화합니다:

권한 확인 필수

환경 초기화 전에 워크스페이스 권한을 확인하세요:

# 권한 확인
ls -la /workspace

# 권한이 root로 되어있다면 수정
sudo chown -R yocto:yocto /workspace

# Yocto 빌드 환경 초기화
source /opt/poky/oe-init-build-env /workspace/build

# 또는 편의 함수 사용
yocto_init

환경 초기화가 하는 일

BitBake 경로 설정
빌드 디렉토리 생성 (/workspace/build)
기본 설정 파일 생성 (local.conf, bblayers.conf)
쉘 환경 변수 설정

빌드 설정 확인¶

local.conf 주요 설정¶

# 현재 설정 확인
cat conf/local.conf | grep -E "(MACHINE|IMAGE_INSTALL|BB_NUMBER)"

# 주요 설정 예시
MACHINE ?= "qemux86-64"
BB_NUMBER_THREADS ?= "4"
PARALLEL_MAKE ?= "-j 4"

중요한 설정 변수들

MACHINE: 타겟 하드웨어 (qemux86-64, beaglebone, raspberrypi4 등)
BB_NUMBER_THREADS: BitBake 병렬 태스크 수
PARALLEL_MAKE: 컴파일 병렬 작업 수
DL_DIR: 소스 다운로드 디렉토리
SSTATE_DIR: 공유 상태 캐시 디렉토리

bblayers.conf 확인¶

# 레이어 구성 확인
cat conf/bblayers.conf

# 사용 가능한 레이어 목록
bitbake-layers show-layers

첫 번째 빌드 실행¶

core-image-minimal 빌드¶

# 첫 빌드 시작 (약 30분-3시간 소요)
bitbake core-image-minimal

# 또는 편의 함수 사용
yocto_quick_build

빌드 시간

첫 빌드: 30분에서 3시간까지 소요 (시스템 사양에 따라)
이후 빌드: 캐시 활용으로 5-30분 내외
증분 빌드: 변경사항만 빌드하므로 수분 내

빌드 과정 상세 분석¶

flowchart TD
    Start([🚀 bitbake core-image-minimal]) --> Parse[📖 레시피 파싱<br/>600+ 패키지 분석]
    Parse --> Deps[🔗 의존성 해결<br/>빌드 순서 결정]
    Deps --> Download[⬇️ 소스 다운로드<br/>필요한 모든 소스 코드]

    Download --> Toolchain[🔧 툴체인 빌드<br/>gcc, binutils, glibc]
    Toolchain --> Kernel[🐧 커널 빌드<br/>linux-yocto]
    Kernel --> Core[📦 핵심 패키지<br/>busybox, systemd 등]

    Core --> Apps[🚀 애플리케이션<br/>기본 시스템 도구들]
    Apps --> Rootfs[🌳 루트 파일시스템<br/>디렉토리 구조 생성]
    Rootfs --> Image[🖼️ 이미지 생성<br/>.ext4, .wic 파일]

    Image --> Deploy[📤 배포<br/>tmp/deploy/images/]

빌드 과정 모니터링¶

# 빌드 로그 실시간 확인
tail -f tmp/log/cooker/console-latest.log

# 현재 빌드 중인 패키지 확인
ps aux | grep bitbake

# 의존성 그래프 생성 (분석용)
bitbake -g core-image-minimal

빌드 진행 상황 이해¶

빌드 단계별 설명

1단계: 파싱 (Parsing)

Loading cache: 100% |#######| Time: 0:00:01
Loaded 1234 entries from dependency cache.
Parsing recipes: 100% |####| Time: 0:00:30

2단계: 의존성 해결

Computing transaction... done
Generating task queue... done

3단계: 실행

Executing task 1234 of 5678 (ID: 1, /path/to/recipe.bb:do_fetch)

빌드 결과 확인¶

생성된 파일들¶

# 이미지 파일 위치
ls -la tmp/deploy/images/qemux86-64/

# 주요 파일들
# - core-image-minimal-qemux86-64.ext4 (루트 파일시스템)
# - bzImage (커널 이미지)
# - modules-qemux86-64.tgz (커널 모듈)

주요 출력물 설명¶

파일	설명	용도
`*.ext4`	루트 파일시스템	QEMU에서 직접 부팅
`*.tar.bz2`	압축된 루트 파일시스템	배포, 분석용
`*.wic`	부팅 가능한 디스크 이미지	실제 하드웨어 플래싱
`*.manifest`	포함된 패키지 목록	문서화, 분석용

빌드 통계 확인¶

# 빌드 시간 확인
bitbake -e core-image-minimal | grep "^DATETIME"

# 빌드된 패키지 수 확인
find tmp/deploy/ipk/ -name "*.ipk" | wc -l

# 이미지 크기 확인
ls -lh tmp/deploy/images/qemux86-64/*.ext4

빌드 캐시 이해¶

sstate-cache 활용¶

sstate-cache의 장점

🚀 빌드 속도 향상: 이미 빌드된 결과를 재사용
💾 저장 공간 효율: 해시 기반 중복 제거
🔄 증분 빌드: 변경된 부분만 다시 빌드

# 캐시 상태 확인
ls -la sstate-cache/

# 캐시 통계
du -sh sstate-cache/

빌드 최적화 팁¶

# 1. 병렬 빌드 최적화
echo 'BB_NUMBER_THREADS = "8"' >> conf/local.conf
echo 'PARALLEL_MAKE = "-j 8"' >> conf/local.conf

# 2. 네트워크 캐시 활용
echo 'SSTATE_MIRRORS = "file://.* http://sstate.yoctoproject.org/PATH"' >> conf/local.conf

# 3. 불필요한 기능 비활성화
echo 'PACKAGECONFIG:remove:pn-qemu = "gtk+ sdl"' >> conf/local.conf

일반적인 빌드 문제 해결¶

디스크 공간 부족¶

# 빌드 임시 파일 정리
rm -rf tmp/

# 오래된 sstate 파일 정리
find sstate-cache/ -atime +30 -delete

권한 관련 문제¶

mkdir: cannot create directory '/workspace/build': Permission denied

해결책:

# 컨테이너 내부에서 권한 수정
sudo chown -R yocto:yocto /workspace

# 빌드 디렉토리 생성 후 재시도
mkdir -p /workspace/build
source /opt/poky/oe-init-build-env /workspace/build

파일 생성 권한 에러

증상: conf 파일 생성 시 권한 에러

해결책:

# 빌드 디렉토리 권한 확인
ls -la /workspace/build

# 필요시 권한 수정
sudo chown -R yocto:yocto /workspace/build

User Namespace 문제 (Ubuntu 24.04)¶

User namespaces are not usable by BitBake

증상: Ubuntu 24.04에서 BitBake 실행 시 user namespace 에러

ERROR: User namespaces are not usable by BitBake, possibly due to AppArmor.

원인: Ubuntu 24.04의 보안 정책으로 unprivileged user namespace 제한

해결책:

# 호스트 시스템에서 실행 (컨테이너 외부)
echo 'kernel.apparmor_restrict_unprivileged_userns = 0' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

# 또는 임시로 활성화
sudo sysctl kernel.apparmor_restrict_unprivileged_userns=0

# 컨테이너 재시작
docker compose restart yocto-lecture

Alternative: BB_NO_NETWORK 설정

User namespace를 사용하지 않고 빌드하려면:

# local.conf에 추가
echo 'BB_NO_NETWORK = "1"' >> conf/local.conf
echo 'BB_FETCH_PREMIRRORONLY = "1"' >> conf/local.conf

네트워크 문제¶

# 다운로드 재시도
bitbake -c cleanall core-image-minimal
bitbake core-image-minimal

패키지 빌드 실패¶

# 특정 패키지 재빌드
bitbake -c clean <package-name>
bitbake <package-name>

# 로그 확인
less tmp/work/*/*/<package-name>*/temp/log.do_compile

← 환경 설정 | 이미지 실행 →