iop/docs/field-bootstrap-user-test.md
toki 0d83ef378e 기능: bootstrap 명령을 positional token 방식의 한 줄 UX로 변경한다
사용자가 artifact URL, Edge 주소, token을 환경변수로 직접 설정하던
IOP_* named parameter 방식을 제거하고, curl | bash -s <token> 형태의
단일 positional token UX로 변경한다.

- bootstrap script에서 NODE_TOKEN을 첫 번째 인자로 받도록 변경
- token 누락 시 명확한 에러 메시지 출력
- artifact HTTP를 127.0.0.1 바인딩으로 변경
- docs, rules, roadmap에 one-line bootstrap UX 기준 기록
2026-05-27 17:56:27 +09:00

1.1 KiB

Field Bootstrap 직접 테스트

Apple Silicon Mac에서 아래만 실행한다. 작업자는 bootstrap URL이 완성된 명령을 전달해야 한다. 사용자는 마지막 token 값 하나만 전달받은 실제 테스트 token으로 바꾼다. 이 token은 Edge 설정의 nodes[].token과 같은 값이어야 한다.

1. Ollama 준비

ollama pull gemma4:26b
ollama list | grep 'gemma4:26b'

2. Node 연결

curl -fsSL <완성된-bootstrap-url> | bash -s <token>

예를 들어 전달받은 토큰이 abc123이면 마지막 <token> 자리만 abc123으로 바꾼다. 전달받은 명령에 <완성된-bootstrap-url> 같은 placeholder가 남아 있거나 token이 없으면 실행하지 말고 먼저 요청한다.

성공하면 터미널에 starting node against toki-labs.com:19090가 보이고, 프로세스가 계속 실행된다. 종료는 Ctrl-C.

3. 결과 공유

성공/실패와 함께 아래만 공유한다.

ollama list | grep 'gemma4:26b'
cat ~/iop-field/node.yaml

그리고 Node 연결 명령을 실행한 터미널 출력 전체를 함께 보낸다. 공유할 때 token 값은 지운다.