iop/docs/edge-local-dev-guide.md

Edge Local Quickstart

Edge는 package 하나, Node는 bootstrap 한 줄로 설치한다.

1. Package

make build

결과: build/packages/iop-edge-<edge-os>-<edge-arch>.tar.gz

2. Edge

tar -xzf iop-edge-<edge-os>-<edge-arch>.tar.gz -C /opt
cd /opt/iop-edge-<edge-os>-<edge-arch>

./iop-edge config init
./iop-edge env

필요하면 edge.yaml의 host/port/model만 수정한다.

3. Node 등록

./iop-edge node register node-1

Ollama Node:

./iop-edge node register node-1 \
  --adapter ollama \
  --ollama-base-url http://127.0.0.1:11434

출력된 curl ... | bash -s <token> 한 줄을 복사한다.

4. Edge 실행

./iop-edge config check
./iop-edge serve

서비스 실행:

sudo ./iop-edge setup --enable --start

5. Node 설치

Node host에서 복사한 명령을 실행한다.

curl -fsSL http://<edge-host>:18080/bootstrap/node.sh | bash -s <token>

node.sh가 OS/architecture를 자동 감지한다.

6. 확인

tail -f logs/edge.log
./iop-edge nodes list

정상: node registered

Build Options

make build NODE_TARGETS="darwin-arm64"
make build-edge && make pack-edge
make pack-node-target NODE_TARGET=darwin-arm64 && make pack-edge