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

37 lines
1.1 KiB
Markdown

# Field Bootstrap 직접 테스트
Apple Silicon Mac에서 아래만 실행한다.
작업자는 bootstrap URL이 완성된 명령을 전달해야 한다.
사용자는 마지막 token 값 하나만 전달받은 실제 테스트 token으로 바꾼다.
이 token은 Edge 설정의 `nodes[].token`과 같은 값이어야 한다.
## 1. Ollama 준비
```bash
ollama pull gemma4:26b
ollama list | grep 'gemma4:26b'
```
## 2. Node 연결
```bash
curl -fsSL <완성된-bootstrap-url> | bash -s <token>
```
예를 들어 전달받은 토큰이 `abc123`이면 마지막 `<token>` 자리만 `abc123`으로 바꾼다.
전달받은 명령에 `<완성된-bootstrap-url>` 같은 placeholder가 남아 있거나 token이 없으면 실행하지 말고 먼저 요청한다.
성공하면 터미널에 `starting node against toki-labs.com:19090`가 보이고, 프로세스가 계속 실행된다.
종료는 `Ctrl-C`.
## 3. 결과 공유
성공/실패와 함께 아래만 공유한다.
```bash
ollama list | grep 'gemma4:26b'
cat ~/iop-field/node.yaml
```
그리고 Node 연결 명령을 실행한 터미널 출력 전체를 함께 보낸다.
공유할 때 `token` 값은 지운다.