Commands and Scripts

You will learn: Common commands for starting, building, testing, installing, and uninstalling the OpenFlare Server, management console frontend, Agent, Swagger, and documentation site.

Server

Start from source:

cd openflare_server
export SESSION_SECRET='replace-with-random-string'
export SQLITE_PATH='./openflare.db'
export LOG_LEVEL='info'
go run .

Specify listening port and log directory:

go run . --port 3000 --log-dir ./logs

Test:

cd openflare_server
GOCACHE=/tmp/openflare-go-cache go test ./...

Frontend

Development:

cd openflare_server/web
pnpm install
pnpm dev

Build static artifacts:

cd openflare_server/web
pnpm build

Checks:

cd openflare_server/web
pnpm lint
pnpm typecheck
pnpm test

Agent

Run from source:

cd openflare_agent
go run ./cmd/agent -config /path/to/agent.json

Compile:

cd openflare_agent
go build -o openflare-agent ./cmd/agent

Test:

cd openflare_agent
GOCACHE=/tmp/openflare-go-cache go test ./...

Install Agent

curl -fsSL https://raw.githubusercontent.com/Rain-kl/OpenFlare/main/scripts/install-agent.sh | bash -s -- \
  --server-url http://your-server:3000 \
  --agent-token YOUR_AGENT_TOKEN

Uninstall Agent

curl -fsSL https://raw.githubusercontent.com/Rain-kl/OpenFlare/main/scripts/uninstall-agent.sh | bash

Swagger

Regenerate Swagger documentation:

go install github.com/swaggo/swag/cmd/swag@v1.16.4
cd openflare_server
swag init -g main.go -o docs

Docs

Local preview:

cd docs
pnpm dev

Build:

cd docs
pnpm build

1.7 KiB Raw Blame History