13.4.2.1 노드(Node) 인스턴스화 및 동적 임베딩을 위한 환경 변수 주사 전술

분산 환경에서 수천 개의 Zenoh-Flow 파이프라인을 기동시키는 SRE(사이트 신뢰성 엔지니어)가 마주치는 끔찍한 병목이 있다. 그것은 3번 공장 로봇을 위한 야믈(YAML) 파일과, 8번 공장 지게차를 위한 야믈 파일을 모두 따로따로 작성해 관리하려 드는 하드코딩의 저주다.

로직과 그래프 위상(Topology)은 완전히 동일한데, 고작 센서의 IP 주소 하나, 타겟 토픽(Topic) 경로 하나가 다르다는 이유만으로 파이프라인 매니페스트 서류를 찍어내는 짓은 스파게티 시스템의 지름길이다. 본 절에서는 YAML 파이프라인 선언부를 완전한 템플릿(Template)으로 추상화하고, 런타임 엔진에 노드를 인스턴스화(Instantiation)하여 밀어 넣을 때 외부 운영체제의 환경 변수(Environment Variables) 를 신경에 주사(Inject)하는 동적 임베딩 전술을 서술한다.

1. 정적 하드코딩의 파멸과 템플릿화(Templating) 선언

기존에 엮어 놓은 카메라 필터 연산 파이프라인의 디스크립터를 보자. 노드를 선언할 때 카메라의 접근 IP나 로봇의 ID 번호를 문자열로 직접 타이핑(예: resource: "robot_3_camera")해 두는 방식이다.
이 파이프라인 파일을 4번 로봇 장비에 그대로 배포하면 4번 카메라는 3번 카메라의 트래픽을 도청하게 되어 관제 시스템 전체가 폭주한다.

이를 막기 위해 파이프라인 매니페스트 자체를 변수가 뚫린 거대한 빵틀(Template)로 승격시켜야 한다. Zenoh-Flow는 매니페스트 문자열 내에 콧수염 괄호 {{ }} 형식의 Jinja-Like 환경 변수 동적 스니펫을 허용한다.

# [추상화된 데이터 플로우 템플릿 야믈 선언]
name: "Vision_Pipeline_{{ ROBOT_ID }}" # 생성될 파이프라인의 이름마저 변동 가능

sources:
  - id: "camera_node"
    uri: "file:///opt/zenoh-flow/camera.so"
    configuration:
      # 노드가 구동부 메모리에 뜰 때, OS 환경변수 값을 빨아먹도록 동적 주입 창구 개방
      camera_endpoint: "tcp://{{ CAMERA_IP }}:8080"

2. 런타임 인스턴스화(Instantiation) 시점의 주사(Injection) 타격

위처럼 매니페스트에 구멍(Hole)을 뚫어두었다면, SRE는 컨테이너나 단말 데몬을 띄우는 배쉬(Bash) 쉘이나 도커 컴포즈(Docker Compose) 층위에서 이 변수들을 극단적으로 밀어 넣는다(Inject).

# [단말 컨테이너/데몬 기동 시 런타임 변수 주입 런북]
export ROBOT_ID="AGV_Unit_04"
export CAMERA_IP="192.168.10.40"

# 변수가 메모리에 떠있는 상태에서 Zenoh-Flow 마스터 데몬에게 템플릿 실행을 명령한다
zenoh-flow-daemon --manifest pipeline_template.yml

명령이 떨어지는 순간, Zenoh-Flow 런타임 파서는 pipeline_template.yml 텍스트를 메모리에 올리면서 {{ ROBOT_ID }} 와 {{ CAMERA_IP }} 문자열 패턴을 순식간에 탐색해 운영체제의 환경 주머니(Env)에 있던 실제 값으로 문자열 변환(Replace)을 가한다.
그 결과, C++ 혹은 파이썬 기반 Source 보드의 생성자(Constructor)가 초기화될 때, 하드코딩이 1도 섞이지 않았음에도 완벽하게 AGV_Unit_04 라는 ID를 쥐고 192.168.10.40의 올바른 렌즈를 타격하게 되는 것이다.

3. 동적 임베딩이 불러온 오케스트레이션(Orchestration)의 절대 권력

환경 변수 주사 전술의 완성은 비로소 인프라스트럭처의 코드화(Infrastructure as Code)를 완결 짓는다.
엔지니어는 파이프라인의 “뇌 구조(Topology YAML)“를 단 하나 파일로 온전히 규격화하여 깃허브(Git)에 올려둘 수 있다.

이 하나의 중앙 집중화된 템플릿(YAML)은, 쿠버네티스(Kubernetes) 헬름 차트나 퍼펫(Puppet) 등의 백엔드 오케스트레이션 툴을 타고 전 세계 5만 대의 기기로 퍼져 나간다. 각 기기 단말 데몬은 자기가 위치한 ROBOT_ID 환경 변수라는 주삿바늘을 통해 템플릿을 독자적으로 해독하고, 자신에게 딱 맞는 최적화된 독립 인스턴스(Instance)로 부활(Re-spawn)한다.
매니페스트에는 논리의 뼈대만을 남기고, 변동하는 모든 설정의 살점들을 환경 변수로 찢어 날리는 것. 이것이 대규모 스웜(Swarm) 관제를 구축하는 마이크로 아키텍트들의 기본 소양이다.