Skip to content

Latest commit

 

History

History
110 lines (79 loc) · 16.8 KB

deployment.md

File metadata and controls

110 lines (79 loc) · 16.8 KB

SafeZone 배포 및 운영 기록

2026-11-20 실장비 스냅샷 (18:45 KST, 재연결 후속 보고 전)

이 절은 재연결 후 18:45 KST에 수행한 읽기 전용 점검의 스냅샷이다. 그 뒤 작업자가 추가로 수행한 장비 복구 결과는 다음 절에 기록한다. Pi의 프로세스, systemd 설정, oneM2M 리소스, ACP, RiskEngine 로그는 읽기 전용 조회로 확인했다. ESP의 물리 동작과 Vision 시험 결과는 작업자가 수행해 알려 준 내용이다.

구성 최신 확인
실행 중 tinyiot-mn, tinyiot-in-local, mosquitto, safezone-radar, safezone-engine, safezone-bridge, safezone-ipe; Pi의 safezone-dashboard는 임시 로컬 화면
Radar → MN LD2450 입력을 저장소의 radar/radar_node.py가 MQTT CIN 요청으로 기록. 현재 RADAR_LOCAL_DECISION=0, 따라서 alert writer는 RiskEngine으로 분리됨
RiskEngine /opt/safezone/engine-freshness-20261119; --transport polling, --vision-path /AE-VisionAI/fusedTracks/la, --alert-path /grp-safezone-alarms/fopt. radar와 Vision latest CIN을 HTTP GET으로 읽고 events·alert를 HTTP로 씀
경보 그룹 grp-safezone-alarms의 mid에 forklift·worker·zone alert CNT의 현재 RI 세 개가 있음. worker AE 재등록 후 새 worker alert RI가 그룹에 다시 포함됨
경보 기록 세 alert CNT 모두 최신 level=danger 기록. 작업자는 worker ESP가 위험 모드로 바뀐 것을 확인했고, 두 ESP 보드 동작도 확인함
SUB Forklift SUB는 HTTP /notify 주소를 직접 보유. Worker SUB는 nu=Cworker01이며 AE-worker01의 poa로 해석됨. 이번 확인에서 worker 위험 모드 경로 성공
ACP radar/fusedTracks 조회와 alert 작성용 ACP 확인. Worker ACP의 CAdmin 권한 마스크는 35(create/retrieve/discovery)로 설정돼 있어 최소 권한 검토는 별도 필요
Vision (18:45 스냅샷) 직전 Vision 시험에서 cam_ok=true, tracks=[]의 fresh CIN과 RiskEngine fresh 판정을 작업자가 확인. 이후 이 읽기 전용 조회 시 safezone-vision.service는 비활성·비활성화 상태였고 최신 CIN은 약 13분 전
최신 DANGER 원인 18:44 KST 엔진 기록은 radar 기반 predicted_cpa_inside_radius_within_danger_time; 그 시점 Vision은 stale. 해당 DANGER를 카메라 인식 결과가 유발했다고 주장하지 않음
IN·대시보드 MN은 노트북 Docker IN에 등록. 브리지는 events를 HTTP polling해 IN에 쓰며, 시연 대시보드는 MN 현재 상태와 IN 이력을 조회. Pi 임시 대시보드는 시스템 아키텍처에서 제외
타이밍 RISK_WARNING_DISTANCE_M=2.5, RISK_DANGER_DISTANCE_M=1.5, RISK_STALE_AFTER_S=5, RISK_MAX_SAMPLE_INTERVAL_S=5

2026-11-20 장비 복구 후속 보고 (작업자 확인)

18:45 스냅샷 뒤 두 ESP를 다시 동작시켰다. worker AE 재등록으로 바뀐 alert CNT RI를 경보 그룹에 다시 연결한 다음, DANGER가 세 alert CNT 각각에 기록되고 worker ESP가 위험 모드로 들어가는 것을 확인했다. 시연에서는 SG90 포크 서보와 부저도 동작했다. zone alert CNT는 논리적 확장 대상이며 물리 zone beacon은 연결되어 있지 않다.

C270은 Pi에서 인식됐다. 녹화 시연 동안 /home/user/vision4iot 환경의 VisionAI가 연속 실행되어 새 fusedTracks를 만들고 RiskEngine이 이를 fresh로 읽었다. 시연에서 VisionAI와 레이더가 같은 사람을 confirmed로 연결하고, 쭈그린 자세에 따른 vision_risky_posture_raise가 WARNING을 DANGER로 올렸다. 18:45 조회의 stale CIN과 그 이전 시험의 빈 tracks는 시연 전 관찰이다. 시연 중 실행과 부팅 자동 시작은 별도 상태다.

RiskEngine의 production 모듈 여덟 개는 Pi 파일과 줄바꿈을 정규화해 비교했을 때 일치했다. Pi radar 파일의 로컬 fallback 거리 상수도 반영했다. 운영에서는 RADAR_LOCAL_DECISION=0이라 이 로컬 판정은 비활성이고, 알림 writer는 RiskEngine이다. VisionAI 실행 소스도 Pi와 대조했으며, config.pi.yaml에는 Pi에서 사용한 경고 거리 2.5m와 보조선 설정을 반영했다. 카메라 보정 데이터는 장비마다 새로 만든다. 보정 안내를 참고한다.

그룹 멤버십은 worker AE를 재등록하면 자동으로 따라오지 않을 수 있다. worker alert CNT의 새 RI를 확인해 group mid를 갱신한다. 11월 20일 점검 당시 DHCP 예약은 구성되지 않았다. 2.5 m/1.5 m 임계값과 5초 설정은 팀 시연값이다. Pi의 MEC IPE는 Vision freshness와 cam_ok 상태를 MN-CSE에 기록한다. 별도 local mock MEC011 발견·호출 시험은 아래 후속 확인에 기록한다.

2026-11-20 촬영 후 ACP·RiskEngine·MEC 확인

이 후속 확인은 사용자가 장비에서 수행해 보고한 운영 설정과 결과다. 18:45 스냅샷 및 녹화 시연 결과와 시점을 구분한다.

항목 촬영 후 확인 경계
RiskEngine Criskengine Origin으로 재시작. systemd 설정과 실행 중 프로세스가 새 Origin을 사용. radar·fusedTracks·events GET과 events/alert HTTP 기록 경로 사용 운영 입력·출력은 MQTT가 아니라 HTTP polling/write
ACP / group 운영 group macp를 연결하고 기존 세 mid를 유지·갱신해 cnm=3. group ACP와 세 alert CNT ACP에서 Criskengine 권한은 CREATE만 소유자 권한과 worker CNT의 기존 CAdmin 권한 유지
events 기록 재시작 후 HTTP 201 / RSC 2001 성공 CIN 기록 응답 확인
alert fan-out forklift·worker·zone alert CNT 모두에 level=danger, dist=1170 CIN을 확인 이번 ACP 시험에서 ESP 알림 수신, 부저·서보 동작은 따로 확인하지 않음
SUB 기존 SUB만 확인 이 시험에서 MQTT SUB를 만들거나 변경하지 않음
VisionAI 촬영 후 과열 때문에 중지. 엔진은 저장돼 있던 fusedTracks를 stale로 처리 녹화 시연의 camera–radar fusion 결과는 촬영 당시의 별도 결과. MEC 검사 뒤 VisionAI를 다시 중지
MEC registry / data Pi loopback의 컨테이너가 약 26분 실행. 수동 등록된 safezone-vision-cin-trial은 ACTIVE; Vision 입력이 없을 때 데이터 상태는 INACTIVE. VisionAI를 잠시 켜자 IPE가 실제 fusedTracks 최신 데이터를 읽어 INACTIVE → ACTIVE로 기록 등록 상태와 데이터 freshness는 별개. 컨테이너 접근은 Pi loopback 한정
MEC011 discovery IPE 발견 코드가 운영 Pi IPE에 적용됨. 서비스 등록부 조회와 실제 Vision CIN 주소 확인 후 freshness 상태 기록. 별도 로컬 브랜치의 17개 단위 시험 통과 보고 자동 Vision 서비스 등록과 다중 서비스 자동 선택은 미구현. 원격 CSE는 실제 장비에서 미검증

확인 당시 VisionAI는 중지돼 있어 실시간 융합을 제공하지 않았다. MEC IPE는 수동 등록된 Vision data service를 발견해 실제 oneM2M 최신 데이터를 확인한다. 등록부 ACTIVE는 데이터 freshness ACTIVE를 뜻하지 않는다. 발견 코드는 저장소에 포함돼 있으며 Pi에서는 별도 설치 경로와 systemd drop-in으로 실행한다. 발견에는 IPE_PROBE=mec-cin, 등록부를 지정하는 IPE_MEC_BASE, 서비스 이름을 지정하는 IPE_MEC_SERVICE가 필요하다. IPE_DISCOVERY_CSE_BASE를 생략하면 IPE_MN_BASE의 CSE만 허용한다. 이름이 중복되면 임의로 선택하지 않고 허용 CSE 밖의 주소를 쓰지 않는다. 원격 CSE 경유 discovery는 Pi에서 시험하지 않았다. 여러 엣지 장비로 확장할 때 서비스 자동 등록·주소 변경 반영과 위치·부하 등 기준에 따른 적절한 서비스 선택이 다음 단계다.

운영 복구본은 Pi에 보관돼 있다: /etc/default/safezone.codex-backup-20261120, /etc/systemd/system/safezone-engine.service.codex-backup-20261120.

이전 배포 스냅샷의 기준

아래의 첫 점검 기록은 2026-11-20 장비 재연결 전 상태를 보존한다. Pi의 애플리케이션 저장소는 430c8c7178e9668ac742e30a5295cb6169255b8f이고 레이더 업로더에 로컬 변경이 있다. 엔진은 저장소 checkout이 아니라 /opt/safezone/engine-freshness-20261119에서 실행한다. 따라서 저장소 main 또는 Pi의 애플리케이션 HEAD만으로 운영 코드를 재현할 수 없다.

GitHub main은 이 기록을 시작할 때 f31e63c385524f01b5f51feb186eb1f34f87d8fa였다. Pi 운영 엔진과 해당 코드의 파일별 차이를 이번 제출 브랜치의 engine/에 반영했다. 실행 설정과 실험용 5초 시연값은 코드 기본값과 별도다.

확인된 실행 구성

구성요소 Pi에서 확인한 위치·방식 역할과 경계
tinyIoT MN-CSE와 Mosquitto Pi systemd 서비스 현장 radar, events, alert 및 서비스 상태 리소스
레이더 업로더 저장소의 radar/radar_node.py; LD2450은 UART 입력, oneM2M MQTT 요청·응답 약 0.5초 간격으로 CIN 등록. 응답을 기다리는 동안 프레임을 버리는 로컬 변경 포함
RiskEngine /opt/safezone/engine-freshness-20261119, python -m engine.main --transport polling --vision-path /AE-VisionAI/fusedTracks/la --alert-path /grp-safezone-alarms/fopt radar 최신 CIN과 Vision 경로를 HTTP GET; events와 경보 그룹에 HTTP CIN 생성 요청
MN→IN 브리지 Pi에서 별도 systemd 서비스 MN의 events 최신 CIN을 HTTP polling해 요약하고 IN의 AE-safezone/events에 HTTP로 기록
IN-CSE 작업 노트북의 Docker 컨테이너 브리지 이력 저장 및 대시보드 IN 모드. Pi 안에도 별도 IN-CSE 서비스가 있으나 현재 이 화면·브리지 대상은 노트북 IN
대시보드 노트북, 시연 구성 MN 현재 상태와 IN 이력을 조회. Pi의 HTTP 8080 임시 대시보드는 시스템 아키텍처에 포함하지 않음
MEC 상태 확인 IPE Pi systemd 서비스 최신 Vision CIN의 시각과 cam_ok를 읽고 AE-mecIPE/.../status에 상태를 씀. 확인 당시 Vision INACTIVE
VisionAI Pi /home/user/vision4iot 실행 환경에서 녹화 시연 중 구동 same-person confirmed와 posture raise를 확인. 부팅 자동 시작은 별도 설정
ESP 경보기 (18:45 스냅샷) forklift 및 worker alert CNT/SUB 구성 확인 이 스냅샷 때 보드가 꺼져 있었음. 이후 재연결 때 두 보드 동작, 각 alert CNT의 DANGER 기록, worker ESP 위험 모드를 확인

MN은 노트북 IN-CSE에 Mcc로 등록된다. 이벤트 이력 복사는 별도 Pi bridge AE가 HTTP/Mca polling과 CIN 생성으로 수행한다. 두 흐름을 하나의 직접 Mcc 데이터 동기화로 설명하지 않는다. 노트북 주소가 바뀌면 MN의 상위 CSE 설정, bridge의 BRIDGE_IN_BASE, 노트북 dashboard의 DASH_CSE_BASE·DASH_IN_BASE를 갱신하고 각 서비스를 재시작한다. 11월 20일 점검 당시 DHCP 예약은 구성되지 않았으므로 IP를 문서에 고정하지 않는다.

운영 RiskEngine과 저장소 코드의 차이

Pi 운영본에는 radar CIN의 con.ts가 Unix 시각인지, 허용 시간 범위 안인지 확인하는 가드가 있다. 시각이 없거나 오래됐거나 허용 범위보다 미래인 입력은 처리하지 않고 UNKNOWN으로 기록한다. con.ts가 boolean이면 숫자로 취급하지 않는다. velocity와 표적 연결 간격은 서버 monotonic 수신 시각으로 계산한다.

engine/에는 비교에서 발견한 이 동작과 관련 테스트를 반영했다. 운영 경로 파일의 기록 시각 검사는 실시간 단절 감지와 동일하지 않다. 특히 Pi 설정의 입력 stale 판정과 표적 연결 허용 간격은 5초지만 radar 센서 시각 검사는 코드 기본 최대 나이 3초다. 각각 다른 검사라, 5초 설정이 3초보다 오래된 CIN을 유효하게 만들지 않는다.

확인된 현재 설정

설정 실제 확인값 해석
RISK_DANGER_DISTANCE_M 1.5 m 팀 시연 기준, 산업안전 한계가 아님
RISK_WARNING_DISTANCE_M 2.5 m 팀 시연 기준, 산업안전 한계가 아님
RISK_STALE_AFTER_S 5 s 새 입력이 없다고 판정하는 시연용 설정
RISK_MAX_SAMPLE_INTERVAL_S 5 s 표적 연결·속도 계산의 샘플 간격 상한. 추적 정확도는 검증하지 않음
RiskEngine alert writer AE-riskengine 이벤트 + /grp-safezone-alarms/fopt 경보 그룹 설정 장치가 수신했거나 실제로 정지·경보했다는 확인 아님
레이더 alert writer RADAR_LOCAL_DECISION=0 경보 CIN 기록 주체를 RiskEngine으로 선택한 설정
업로더 응답 대기 RADAR_MQTT_WAIT_S 기본 2 s 기다리는 동안 새 radar 프레임을 버려 오래된 입력이 큐에 쌓이지 않게 하는 로컬 수정

레이더 업로더에서 MQTT 응답 약 0.26–0.28초, 간격 약 0.53초를 잠시 관찰했다. 장기 평균, 최악 지연, 거리판정 정확도는 측정하지 않았다. 최근 엔진 이벤트에는 레이더 시각 만료와 radar 입력 stale 상태가 기록됐으며 이후 새 입력의 DANGER 기록도 관찰됐다. 읽기 요청이 이어진 짧은 관찰이라 발생 원인을 특정하지 않는다.

두 개의 5초 값은 제출 시시각각의 서비스 override에서 확인한 시연 설정이다. 안전 기능의 최적값으로 읽지 않는다. 더 긴 만료는 입력 단절을 늦게 드러낼 수 있고, 더 넓은 표적 연결 간격은 좌표 기반 속도 추정의 신뢰성을 떨어뜨릴 수 있다. 실제 네트워크 지연, 센서 배치와 표적 추적을 따로 측정해 다시 정해야 한다.

새 환경에 설치할 때

  1. Pi와 노트북을 같은 접근 가능한 네트워크에 연결한다. Pi MN-CSE와 노트북 Docker IN-CSE가 기동하는지 확인하고, Pi에서 접근 가능한 노트북 IN 주소를 조회한다. DHCP 주소를 문서나 코드에 고정하지 않는다.
  2. Pi에서 systemd/install.sh로 저장소 기본 서비스를 생성할 수 있다. 이 스크립트는 서비스 파일을 설치하고 daemon-reload를 하지만, 현 Pi의 모든 override, 별도 RiskEngine snapshot, 수정된 tinyIoT 바이너리까지 배포하지 않는다.
  3. 별도 MN 빌드는 상위 노트북 IN의 현재 주소를 사용한다. 주소 변경 시 REMOTE_CSE_HOST/PORT를 갱신하고 MN을 재빌드·재시작한다. 등록 성공 응답과 MN 기동을 확인한다.
  4. Pi bridge의 BRIDGE_IN_BASE를 노트북 IN으로 설정한다. 노트북 dashboard는 DASH_CSE_BASE를 Pi MN으로, DASH_IN_BASE를 노트북 IN으로 설정한다. 각 실행 위치의 systemd 환경 설정을 바꾸고 해당 프로세스를 재시작한다. 주소를 코드나 문서에 커밋하지 않는다.
  5. 레이더 입력이 올라오는지 AE-forklift01/radar/la에서 확인하고 con.ts, targets, 좌표 단위를 점검한다. 엔진은 polling 기반으로 실행하며 Vision 입력을 지정할 때 해당 CNT의 최신 생성과 cam_ok를 별도로 확인한다.
  6. 실제 events CIN과 응답 HTTP 201 / RSC 2001을 확인한다. 이어 브리지 로그와 IN의 AE-safezone/events/la를 확인하고, 대시보드에서 MN·IN 연결 및 같은 최신 상태가 보이는지 확인한다. 각 단계는 독립적으로 확인한다.
  7. worker ESP의 secrets.h에 현재 Pi 주소를 CSE_HOST로 설정하고 펌웨어를 빌드·업로드한다. 지게차 ESP IP가 바뀌면 bash onem2m/sub_alert_node.sh <ESP_IP>로 SUB의 nu를 갱신한다. worker AE 재등록 뒤에는 새 alert RI를 그룹 mid에 반영한다.
  8. Vision을 사용할 때 C270, fresh cam_ok=true CIN, RiskEngine fresh 판정과 MEC IPE 상태를 확인한다. /home/user/vision4iot에서 실행해 시연 동안 연속 처리한다. 부팅 자동 시작은 별도 설정으로 확인한다.
  9. 각 시험의 시간을 기록하고, 노트북 Docker·Pi MN·엔진·브리지·화면을 다시 시작해 복구를 별도 확인한다. 해당 재부팅 후 종단 간 재검증은 완료되지 않았다.

주소나 계정 비밀은 저장소 또는 게시용 글에 넣지 않는다. 설치 스크립트의 기본값만으로 운영 Pi의 임시 설정과 전체 배치가 재현된다고 보장하지 않는다.

제출 시 기술 범위

확인된 범위는 Pi MQTT radar CIN 수집, RiskEngine HTTP polling 판단·기록, Vision same-person 확인과 posture risk raise, VisionAI 중단 사례, radar 중단 시 UNKNOWN과 모형 포크 정지, 경보 그룹의 세 alert CNT fan-out, worker ESP DANGER 모드, MN의 Mcc 등록, 별도 HTTP/Mca 이력 브리지, 노트북 IN-CSE·대시보드 조회, MEC IPE 상태 기록이다. Pi 임계값과 5초 값은 팀 시연 설정이다. 자동 부팅, DHCP 예약, 장기 신뢰성, 재부팅 복구 및 full-size 지게차 제어는 주장하지 않는다.