기기의 상태를 Reporter의 heartbeat로 확인하는 상태 페이지입니다. 첫 heartbeat 수신부터 가동률을 계산하며, 최근 7일을 시간당 한 칸으로 표시합니다. 수집 전 기간은 기본적으로 회색입니다. DB에 정상 상태 초기화 구간을 등록하면 해당 구간을 초록색으로 표시하고 툴팁으로 구분하며, 실제 관측 가동률 계산에서는 제외합니다.
Node.js 22.13 이상, pnpm 9가 필요합니다.
pnpm install
pnpm db:migrate:local
pnpm devWrangler가 출력한 주소로 접속합니다.
본인 GitHub 계정에 fork하고 Cloudflare에 해당 저장소의 접근 권한을 연결합니다.
Cloudflare API 토큰을 CLOUDFLARE_API_TOKEN에 설정합니다.
cp infra/cloudflare/example.tfvars infra/cloudflare/terraform.tfvars파일에 본인의 계정 ID, GitHub 계정·저장소, Pages 프로젝트 이름, 사용할 도메인을 입력합니다.
terraform -chdir=infra/cloudflare init
terraform -chdir=infra/cloudflare plan
terraform -chdir=infra/cloudflare apply
cp wrangler.production.example.jsonc wrangler.production.jsonc
cp wrangler.preview.example.jsonc wrangler.preview.jsonc두 Wrangler 파일의 database_id에 Terraform 출력의 운영·preview DB ID를 각각 입력합니다.
도메인 DNS는 생성된 Pages 프로젝트의 <프로젝트>.pages.dev를 가리키도록 설정합니다.
pnpm db:migrate:production
pnpm db:migrate:preview
STATUS_ADMIN_URL=https://status.example.com STATUS_PAGES_PROJECT=your-status-project pnpm admin:secret:create
pnpm admin:secret:deploy productionURL과 프로젝트 이름은 본인 것으로 바꿉니다. 관리 설정은 Git 제외 local/admin.env에 저장됩니다.
설정 후 Cloudflare Pages를 재배포합니다. 이후 main push 시 자동 배포됩니다.
관리 토큰으로 장비 추가 API를 호출하면 장비 토큰이 반환됩니다.
POST /api/v1/admin/reporters
Authorization: Bearer <admin-token>
Content-Type: application/json
{ "id": "nas", "name": "NAS" }응답: { "reporterId": "nas", "token": "<device-token>" }.
CLI로 호출하면 토큰을 파일에 저장합니다.
pnpm token:create nas --name NAS --output-dir local/nasReporter를 설치할 장비의 ENV에 응답 토큰과 장비 ID를 설정합니다.
STATUS_REPORTER_URL=https://status.example.com/api/v1/heartbeat
STATUS_REPORTER_TOKEN=<device-token>
STATUS_COMPONENT=nas설치: Linux · OPNsense · OpenWrt
local/update.json에 변경할 값을 작성합니다. 예: { "enabled": false }.
pnpm reporter:update nas local/update.json
pnpm token:rotate nas --output-dir local/nas-rotated재발급하면 이전 토큰은 즉시 폐기됩니다. 새 토큰을 장비에도 반영합니다. 관리 Secret은 관리 PC에, Reporter 토큰은 해당 장비에 보관합니다.
검증은 pnpm check로 실행합니다.