5.2 개발 환경 구축과 의존성 관리

5.2 개발 환경 구축과 의존성 관리

어떤 언어로 분산 시스템을 개발하든 프로젝트 첫날의 빌드 환경 세팅이 그 프로젝트의 운명을 결정짓는다. “어제는 컴파일이 됐는데 오늘은 안 됩니다“라는 신입 개발자의 비명을 듣기 싫다면, 의존성 트리와 타겟 아키텍처를 콘크리트처럼 단단하게 굳혀(Lock) 놓아야 한다.

다행히도 Rust는 Cargo(카고) 라는 지상계에서 가장 진보된 패키지 매니저 겸 빌드 시스템을 기본 탑재하고 있다. 이 장에서는 단순한 cargo new를 넘어서, 라즈베리 파이(Raspberry Pi)와 같은 에지 타겟을 바라보는 교차 컴파일(Cross-compilation) 런북과, Zenoh의 수많은 파편화된 기능(Feature Flags) 중 우리 프로젝트에 정확히 필요한 톱니바퀴만 골라 조립하는 최적화 패키징 전술을 다룬다.

1. Cargo를 이용한 Zenoh 프로젝트 초기화 및 구성

현대적인 시스템 프로그래밍의 시작은 패키지 매니저의 통제력을 100% 장악하는 것에서 출발한다.

1.0.1 [Runbook] 프로덕션 레벨 Zenoh 프로젝트 생성

단순히 cargo new를 치고 끝내는 건 학생 티를 못 벗어난 행동이다. 실무에서는 작업 공간(Workspace) 분리와 비동기 엔진(Tokio)의 이빨을 함께 맞추는 보일러플레이트를 한 호흡에 전개해야 한다.

1. 워크스페이스(Workspace) 기반 메인 폴더 생성
마이크로서비스 구조에서 Publisher 앱과 Subscriber 앱을 하나의 저장소(Monorepo)에서 관리하기 위해 최상단 계층을 잡는다.

mkdir zenoh_fleet_system && cd zenoh_fleet_system
touch Cargo.toml

최상단 Cargo.toml에 컴포넌트들을 묶어준다.

[workspace]
members = [
    "edge_sensor",
    "cloud_dashboard"
]

2. 에지 노드(Publisher) 구역 초기화

cargo new edge_sensor
cd edge_sensor

3. 코어 의존성 일괄 주입 (의존성 지옥 방어)
Zenoh는 기본적으로 비동기 이벤트 루프를 타므로 tokio가 바늘과 실처럼 따라붙어야 한다. 버전 충돌을 막기 위해 명령어로 한 번에 박아넣는다.

## zenoh 라이브러리와 비동기 런타임 tokio 세팅
cargo add zenoh@0.10.1
cargo add tokio --features full
## 직렬화 마법을 위한 serde 패키지 동시 투하
cargo add serde --features derive
cargo add bincode

이 세팅이 끝나면 당신의 edge_sensor/Cargo.toml은 어떠한 OS에서도 100% 동일한 빌드 재현성을 보장하는 강력한 닻(Anchor)을 내리게 된다.

2. Cargo.toml에서의 Zenoh 크레이트(crate) 및 주요 Feature Flags 설정

C++ 진영에서 #ifdef 매크로로 개발자들을 괴롭히던 조건부 컴파일을, Rust는 Cargo.toml의 Feature Flags라는 우아한 스위치로 해결했다.
Zenoh 크레이트는 거대하다. 이걸 아무 옵션 없이 통째로 컴파일하면 불필요한 바이너리가 디바이스의 용량을 좀먹는다. 필요한 엔진만 골라서 빌드(Opt-in)하는 것이 다이어트의 핵심이다.

2.0.1 [Runbook] 목적별 Feature Flag 배합 전술

edge_sensor/Cargo.toml 내의 [dependencies] 섹션을 에디터로 열어라.

전술 A. 공장 에지용 초경량 세팅 (디폴트)
센서 데이터를 단방향으로 던지기만 하는 초소형 단말기. 불필요한 라우터 코어 기동 능력이나 내장 QUIC 엔진을 빼서 빌드 시간과 바이너리 용량을 절반으로 날린다.

[dependencies]
## QUIC 트랜스포트를 빼고 가벼운 TCP/UDP만 물고 간다.
zenoh = { version = "0.10.1", default-features = false, features = ["transport-tcp", "transport-udp"] }
tokio = { version = "1.30", features = ["rt-multi-thread", "net", "time", "macros"] }

전술 B. 서버용 풀 무장 세팅 (Heavy Duty)
이 앱 자체가 하나의 강력한 라우터로 동작해야 하거나(Peer 모드), 보안 통신 구간(Shared Memory, TLS)을 지나가야 할 때.

[dependencies]
zenoh = { version = "0.10.1", features = [
    "unstable",          # 최신 API (queryable 등) 개방
    "transport-quic",    # 5G 망 돌파용 트랜스포트
    "transport-tls",     # TLS 암호화 모듈 활성화
    "shared-memory"      # [핵심] 같은 리눅스 내 통신 시 커널 바이패스 초고속 통신
] }

[아키텍처 인스펙션]
특히 임베디드 리눅스가 올라간 카메라 모듈 프로세서에서 Zenoh 비디오 스트리밍을 쏠 것이라면, "shared-memory" 피처는 선택이 아닌 생존 필수 요건이다. 복붙(Copy) 부하를 제로(0)로 만들지 않으면 암 코어 아키텍처(ARM Arch)는 그대로 뻗어버린다.

3. 컴파일 최적화를 위한 타겟 프로필 설정

cargo build --release 만 치면 자동으로 최강의 속도가 나오는 줄 아는 순진한 개발자들이 있다. 기본 릴리즈 옵션은 ’적당히 빠른 속도’와 ’적당한 빌드 시간’의 타협점일 뿐이다.

자율주행 자동차의 브레이크 제어 루프나 고빈도 금융 트레이딩(HFT)처럼 1나노초 단위까지 뼛속까지 쥐어짜야 한다면, 당신의 Cargo.toml 최하단에는 다음과 같은 극단적인 커널 튜닝 스크립트가 박혀 있어야 한다.

3.0.1 [Runbook] 프로덕션 최고 성능 마력(Horsepower) 튜닝

Cargo.toml 맨 밑줄에 아래 영역을 과감하게 선언하라.

## ==========================================
## 극단적 릴리즈 모드(Release Profile) 강제화
## ==========================================
[profile.release]
opt-level = 3       # 컴파일러가 속도를 위해 가능한 모든 희생(용량 등)을 감수하게 함
lto = "fat"         # [핵심] Link Time Optimization. Zenoh 크레이트와 내 코드를 통째로 합쳐서 죽은 코드를 소거하고 병목을 없앤다.
codegen-units = 1   # 빌드는 심각하게 느려지지만(멀티코어 빌드 포기), 결과물의 런타임 최적화는 궁극에 달한다.
panic = "abort"     # 크래시가 났을 때 우아하게 역추적(Unwind)하는 로직을 지워버리고, 바이너리 크기와 속도를 얻는다.
strip = true        # 실행 파일에 박힌 불필요한 디버깅 심볼을 완전히 삭제하여 경량화.

[튜닝 후 트레이드오프(Trade-off) 검열]
이 세팅을 바르고 나면, 기존에 10초 걸리던 컴파일이 2분 가까이 걸리며 당신의 노트북 쿨러가 비명을 지를 것이다.
하지만 이 인내의 결실로 만들어진 Zenoh 바이너리는 LTO를 통해 C++ 시절에도 볼 수 없었던 “CPU 분기 예측과 인라이닝(Inlining)“의 수혜를 입어, 패킷 처리 Throughput이 기본 빌드 대비 20~30% 이상 폭발적으로 뛰어오른다.

4. 멀티 플랫폼 및 임베디드 기기를 위한 교차 컴파일(Cross-compilation) 설정

당신이 개발하는 PC는 최신형 MacBook(x86_64 또는 ARM64)이겠지만, 실제 코드가 올라가서 흙먼지를 뒤집어쓸 타겟은 공장 기둥에 매달린 구형 Raspberry Pi 4 (AArch64-Linux) 다.
C언어 시절에는 타겟에 맞는 gnu-gcc-toolchain 버전을 맞추다 며칠 밤을 새웠겠지만, Rust 생태계에서는 명령어 두 방으로 완벽한 도하(Bridge) 작전이 수행된다.

4.0.1 [Runbook] 에지 디바이스 크로스 컴파일 마스터하기

전술 1. 순정 Cargo 타겟 추가 투하
가장 우아하고 정석적인 방법. 당신의 OS에 ARM 리눅스용 엔진을 부착한다.

## 1. 아키텍처 컴파일 타겟 확보 (라즈베리 파이 64비트 리눅스)
rustup target add aarch64-unknown-linux-gnu

## 2. Ubuntu 환경일 경우, C 링커(Linker) 패키지도 주입해 줘야 한다.
sudo apt install gcc-aarch64-linux-gnu libc6-dev-arm64-cross

## 3. 프로젝트 폴더 내 .cargo/config.toml 에 링커 강제 할당
mkdir -p .cargo
echo '[target.aarch64-unknown-linux-gnu]
linker = "aarch64-linux-gnu-gcc"' > .cargo/config.toml

## 4. 크로스 컴파일 폭격
cargo build --release --target aarch64-unknown-linux-gnu

전술 2. [치트키] Cross 프로젝트를 통한 도커 기반 100% 격리 빌드
복잡한 C 언어 라이브러리(OpenSSL 등)가 얽혀있어서 1번 전술로 링커 에러가 난다면, 고민하지 말고 Rust 진영의 궁극 병기 cross를 꺼내 든다.
이는 텅 빈 도커 깡통 안에 아키텍처별 툴체인을 미리 다 세팅해 둔 킬러 컨테이너 기술이다.

## 크로스 컴파일 헬퍼 툴 전역 설치
cargo install cross

## Docker 데몬이 켜져 있는 상태에서, cargo 대신 cross 로 명령어를 날린다!
## (나머지 지저분한 환경 세팅은 도커 안에서 마법처럼 해결된다)
cross build --release --target aarch64-unknown-linux-gnu

빌드가 끝나면 target/aarch64-unknown-linux-gnu/release 폴더 안에 떨어진 깨끗한 엘프(ELF) 실행 파일 하나를, SCP 명령어로 센서 기기에 던져 넣기만 하면 로컬 배포가 종료된다.