고객의 VM에서 시작하는 VibePackr PoC

첫 실습: 로컬 Work 기록 만들기

CREATE_AUDIT_ARTIFACT로 작업 접수 → 실행 → 같은 Work 조회 흐름을 익힙니다. 입력은 짧은 작업 의도와 사용하지 않은 멱등성 키 하나입니다. 이 로컬 연산에는 고객 데이터셋이나 모델 구독이 필요하지 않습니다.

범위: 로컬 실행 이력을 담은 구조화된 산출물을 만듭니다. 첨부 문서 분석·고객 DB 조회·AI 모델 호출 실습은 아닙니다. 전달받은 릴리스가 이 연산을 제공하고 고객 관리자가 해당 Work 한 건을 허용한 경우에 실행하세요.

1. 설치된 실행 경로 확인

아래 runuser 명령은 Debian appliance의 기존 인가된 root 관리 세션에서 실행합니다. 해당 경로를 사용할 수 없으면 설치별 운영 절차를 따르세요. 소켓 권한을 바꾸거나 새 권한을 부여하지 않습니다.

CTL=/opt/vibepackr/current/bin/packrctl
SOCKET=/run/vibepackr/control-plane.sock
"$CTL" --help
runuser -u vibepackr-runtime -- "$CTL" --socket "$SOCKET" status --json
runuser -u vibepackr-runtime -- "$CTL" --socket "$SOCKET" health --json

실제 status·reason을 읽으세요. 서비스가 살아 있다는 사실과 Work 실행 권한은 다릅니다. 거절·바인딩 누락·미충족 조건은 설치된 bootstrap 절차로 해결한 뒤 제출합니다.

2. 한 번 제출하고 원본 응답 보관

WORK_DIR에는 고객이 허용한 기존 비공개 디렉터리, POC_KEY에는 이번 실습에 사용할 미사용 키를 지정하세요. 다음 블록도 같은 터미널 변수로 실행합니다. 제출하면 Work 기록이 생기며, 웹페이지의 복사 버튼은 명령을 실행하지 않습니다.

# Set your actual WORK_DIR and approved unused POC_KEY first.
(
  : "${WORK_DIR:?Set the approved existing private directory}"
  : "${POC_KEY:?Set one approved unused key}"
  : "${CTL:?Run the interface block first}"
  : "${SOCKET:?Run the interface block first}"
  test -d "$WORK_DIR" || exit 66
  umask 077
  RUN_DIR=$(mktemp -d "$WORK_DIR/first-work.XXXXXX") || exit 73
  printf '%s\n' "$RUN_DIR"
  printf '%s\n' "$POC_KEY" > "$RUN_DIR/request-key.txt"
  set +e
  runuser -u vibepackr-runtime -- "$CTL" --socket "$SOCKET" \
    --timeout-seconds 30 work run CREATE_AUDIT_ARTIFACT \
    "Create a local audit artifact for this PoC" "$POC_KEY" --json \
    > "$RUN_DIR/work-run.json" 2> "$RUN_DIR/work-run.stderr"
  work_exit=$?
  printf '%s\n' "$work_exit" > "$RUN_DIR/work-run.exit"
  exit "$work_exit"
)

출력된 디렉터리의 work-run.json·work-run.exit를 읽고 실제 result.work.work_id를 WORK_ID에 지정합니다. 시간 초과·빈 결과·종료 코드 0만으로 완료를 판단하지 마세요. 제출 결과가 불확실할 때 이 블록을 다시 실행하지 않습니다.

3. 같은 Work의 결과와 근거 확인

# Set WORK_ID to the exact result.work.work_id returned above.
(
  : "${WORK_ID:?Set the actual returned Work ID}"
  : "${CTL:?Run the interface block first}"
  : "${SOCKET:?Run the interface block first}"
  runuser -u vibepackr-runtime -- "$CTL" --socket "$SOCKET" \
    work show "$WORK_ID" --json
)

검증 범위: 제공된 공개 CLI와 2026년 11월 6일의 로컬 Debian PoC 실행 기록을 근거로 작성했습니다. 해당 실행은 이후 설치본의 설치 전용 검사와 별개입니다. 고객 VM에서 새로 실행한 결과, 업무 데이터 검증, 클라우드 전체 인증이나 5분 완료 보장은 아닙니다.

네트워크와 데이터 경계

다운로드 경로, VM 내부 제어 경로, 선택형 업무 연결을 구분하세요. 아래는 전달본의 설치 구조이며 실제 배포 검토에는 설치 설정과 리스너 조회 결과를 함께 사용합니다.

자체 VM 설치만으로 외부 전송이 차단되지는 않습니다. Local Sources의 첨부 선택은 전달 문맥을 제어하며 연결된 에이전트의 모든 파일 권한을 제한하는 기능은 아닙니다. 실행 권한·네트워크 통제를 별도로 확인하고 health 검사를 통과시키려고 방화벽이나 서비스를 임의 개방하지 마세요.

현장에서 바로 확인할 점검 항목

아래 명령은 상태와 제한된 분량의 로그를 조회합니다. 고객이 허용한 운영 세션에서 실행하며, 저널·소켓 조회에는 기존 관리자 권한이 필요할 수 있습니다. 원문 출력은 고객의 비공개 기록에 보관하세요.

/opt/vibepackr/setup paths
systemctl status vibepackr-control-plane.service --no-pager --full
journalctl -u vibepackr-first-boot.service -u vibepackr-control-plane.service -n 100 --no-pager
/opt/vibepackr/health

setup paths에서 설치된 bootstrap·Skills 위치를 확인합니다. 설치 로그는 install.md가 출력한 비공개 디렉터리의 install.log이며 종료 코드는 같은 위치의 install.exit에 있습니다. 실행 중인 서비스 로그는 journald로 확인하며 고정된 /var/log/vibepackr.log 경로를 가정하지 않습니다. health의 실제 종료 코드와 누락 조건을 확인하세요.

ss -lntup
ss -lx
systemctl status vibepackr-customer-access-gateway.service --no-pager
systemctl status vibepackr-remote-admin-gateway.service --no-pager

이력을 지우지 않고 재개·중지·제거하기

원래 Work를 지원되는 조회·조정 경로로 이어가세요. /opt/vibepackr/diagnostics·disable·uninstall은 설치별 상태 경로·요청·자격증명 파일이 필요한 네이티브 관리 진입점입니다. 일반 재시작·롤백·청소 명령이 아닙니다. 설치된 관리 절차를 따르고 실제 결과를 확인하며, /var/lib/vibepackr를 지우거나 current 연결을 수동 변경하지 마세요.