임베디드 리눅스 펌웨어 빌드 및 배포 자동화 파이프라인 구축 가이드

수동 배포의 한계와 원자적 패키지의 필요성

임베디드 디바이스 양산 단계에서 USB 메모리를 이용해 수동으로 스크립트를 실행하거나, 필드 업데이트 후 버전 불일치로 인한 장애를 경험하는 경우가 많습니다. 이러한 문제는 단순히 기능 개발에만 집중하고, 코드를 실제 제품으로 전환하는 표준화된 빌드 및 배포 프로세스가 부재하기 때문에 발생합니다.

단순히 파일을 복사하는 방식은 환경 종속성, 순서 오류, 롤백 불가 등의 문제를 야기하며 CI/CD 파이프라인 통합을 불가능하게 만듭니다. 따라서 모든 디바이스가 검증되고 동일한 시스템을 실행하도록 보장하려면, 스마트폰 롬과 유사한 원자적(Atomic) 설치 패키지를 구축해야 합니다.

빌드 시스템 선정: Buildroot와 Yocto Project

수동 빌드를 탈피하기 위해 가장 먼저 결정해야 할 것은 빌드 프레임워크입니다. 현재 업계 표준은 주로 Buildroot와 Yocto Project로 나뉩니다.

Buildroot: 경량 및 빠른 프로토타이핑

타겟 하드웨어가 고정되어 있고, 복잡한 패키지 관리가 불필요하며 소규모 팀이 빠른 개발을 원할 경우 Buildroot가 적합합니다. Kconfig 기반의 설정과 선형적인 빌드 프로세스를 제공하여 학습 곡선이 낮고 빌드 속도가 빠릅니다.

외부 애플리케이션을 통합할 때는 다음과 같이 독립적인 패키지 정의를 사용할 수 있습니다. 

SENSOR_DAEMON_VERSION = 2.1.4
SENSOR_DAEMON_SITE = $(BR2_EXTERNAL_CUSTOM_PATH)/src/sensor_daemon
SENSOR_DAEMON_SITE_METHOD = local
SENSOR_DAEMON_INSTALL_TARGET = YES

define SENSOR_DAEMON_BUILD_CMDS
    $(TARGET_MAKE_ENV) $(MAKE) CC="$(TARGET_CC)" CFLAGS="$(TARGET_CFLAGS)" -C $(@D) build
endef

define SENSOR_DAEMON_INSTALL_TARGET_CMDS
    $(INSTALL) -D -m 0755 $(@D)/bin/sensor_daemon $(TARGET_DIR)/usr/local/bin/sensor_daemon
    $(INSTALL) -D -m 0644 $(@D)/config/daemon.conf $(TARGET_DIR)/etc/sensor_daemon/daemon.conf
endef

$(eval $(generic-package))

Yocto Project: 복잡한 시스템과 확장성

다양한 하드웨어 변형, 증분 업데이트, 타사 SDK 통합 및 규정 준수가 필요한 대규모 프로젝트에는 Yocto Project가 필수적입니다. BitBake와 Recipe, Layer 개념을 통해 세밀한 버전 제어와 SBOM(소프트웨어 자재 명세서) 생성이 가능합니다.

CMake 기반 프로젝트를 Yocto Recipe로 작성하는 예시는 다음과 같습니다. 

SUMMARY = "Edge computing agent for IoT gateway"
LICENSE = "Apache-2.0"
LIC_FILES_CHKSUM = "file://COPYING;md5=abc123def456"

SRC_URI = "git://git.internal.corp/edge-agent.git;protocol=https;branch=main \
           file://edge-agent.service"

S = "${WORKDIR}/git"

inherit cmake systemd

SYSTEMD_SERVICE:${PN} = "edge-agent.service"

do_install:append() {
    install -d ${D}${bindir}
    install -m 0755 ${B}/src/edge-agent ${D}${bindir}/edge-agent

    install -d ${D}${systemd_system_unitdir}
    install -m 0644 ${WORKDIR}/edge-agent.service ${D}${systemd_system_unitdir}/edge-agent.service
}

파일 시스템 안정성: SquashFS와 OverlayFS 아키텍처

전원 차단이나 사용자 오류로 인한 시스템 손상을 방지하기 위해, 읽기 전용 압축 파일 시스템인 SquashFS와 쓰기 가능한 가상 계층을 제공하는 OverlayFS를 결합하는 것이 산업 표준입니다.

이 아키텍처를 사용하면 기본 OS는 절대 변경되지 않으며, 모든 사용자 설정과 로그는 별도의 데이터 파티션에 저장됩니다. 공장 초기화는 데이터 파티션의 상위 디렉토리만 비우면 됩니다. 

#!/bin/sh
# 기본 읽기 전용 파티션 마운트
mount -t squashfs -o ro /dev/mmcblk1p2 /mnt/base_os

# 쓰기 가능한 영역 및 작업 디렉토리 준비
mkdir -p /mnt/data/rw_layer /mnt/data/work_dir

# OverlayFS를 통한 통합 루트 파일 시스템 구성
mount -t overlay overlay_fs \
  -o lowerdir=/mnt/base_os,upperdir=/mnt/data/rw_layer,workdir=/mnt/data/work_dir /mnt/merged_root

# 새로운 루트로 전환 및 초기화 프로세스 시작
exec switch_root /mnt/merged_root /sbin/init

릴리스 패키지 구성 및 무결성 검증

배포용 패키지는 단순한 디스크 이미지(.img) 이상이어야 합니다. 무결성 검증, 변조 방지 서명, 자동화된 플래싱 스크립트가 포함되어야 합니다. 

#!/bin/bash
set -e

RELEASE_TAG=$(git describe --tags --abbrev=0)
ARTIFACT_DIR="dist/release-${RELEASE_TAG}"

mkdir -p "${ARTIFACT_DIR}"

# 빌드 결과물 복사
cp build/out/core_image.img "${ARTIFACT_DIR}/system.img"
cp build/out/bootloader.bin "${ARTIFACT_DIR}/"
cp tools/provision.sh "${ARTIFACT_DIR}/"

# SHA-256 해시 생성 및 파일 기록
find "${ARTIFACT_DIR}" -type f ! -name "checksums.txt" -exec sha256sum {} + > "${ARTIFACT_DIR}/checksums.txt"

# 개인키를 이용한 펌웨어 서명
openssl dgst -sha256 -sign certs/signing_key.pem -out "${ARTIFACT_DIR}/system.img.sig" "${ARTIFACT_DIR}/system.img"

# 최종 아카이브 압축
tar -czvf "firmware_bundle-${RELEASE_TAG}.tar.gz" -C dist "release-${RELEASE_TAG}"

OTA 업데이트 전략: A/B 파티션과 Swupdate

필드 디바이스의 업데이트 실패로 인한 브릭(Brick) 현상을 방지하려면 A/B 듀얼 파티션 구조와 원자적 전환 메커니즘이 필요합니다. 새 펌웨어는 비활성 파티션에 기록되며, 부트로더는 성공적인 부팅 후에만 활성 슬롯을 전환합니다.

Swupdate는 이러한 A/B 전략을 완벽히 지원하는 임베디드 업데이트 프레임워크입니다. 대역폭 절약을 위해 bsdiff와 같은 바이너리 패치를 적용할 수 있습니다. 

# 이중 복사본(A/B) 전략을 사용하여 델타 업데이트 적용
swupdate -i /tmp/patch_bundle.swu -e "strategy=dual_copy,hardware_rev=2"

CI/CD 파이프라인 통합을 통한 배포 자동화

모든 빌드, 패키징, 서명 및 업로드 프로세스는 CI/CD 서버를 통해 자동화되어야 합니다. Git 태그 푸시를 트리거로 하여 파이프라인이 실행되도록 구성하면, 수동 개입으로 인한 오류를 제거하고 추적 가능성을 확보할 수 있습니다. 

stages:
  - compile
  - bundle
  - deploy

variables:
  FW_VERSION: ${CI_COMMIT_TAG}

compile_firmware:
  stage: compile
  script:
    - make -C buildroot BR2_EXTERNAL=../custom_layers board_config
    - make -j$(nproc)
  artifacts:
    paths:
      - buildroot/output/images/

bundle_artifacts:
  stage: bundle
  needs: ["compile_firmware"]
  script:
    - bash scripts/create_release_bundle.sh ${FW_VERSION}
  artifacts:
    paths:
      - firmware_bundle-${FW_VERSION}.tar.gz

deploy_to_ota_server:
  stage: deploy
  when: manual
  script:
    - openssl dgst -sha256 -sign ${SIGNING_KEY} firmware_bundle-${FW_VERSION}.tar.gz > bundle.sig
    - rsync -avz firmware_bundle-${FW_VERSION}.tar.gz bundle.sig ota-user@ota-server:/var/www/ota/releases/

태그: embedded-linux buildroot yocto-project OverlayFS SquashFS

7월 10일 16:33에 게시됨

인기 태그

©2026 괴물 클럽