gridfleet-agent 0.1.0

GridFleet agent — runs on each host

GridFleet Agent

gridfleet-agent is the host-side service package for GridFleet device hosts.

This package currently provides the runnable agent service entry point:

gridfleet-agent serve

It also provides a safe installer preview:

gridfleet-agent install --dry-run --manager-url http://manager.example.com:8000

The dry run performs host-tool discovery and renders the planned config.env and service definition without writing files or starting services.

Real installs use a dedicated virtual environment under /opt/gridfleet-agent/venv:

python3 -m venv /opt/gridfleet-agent/venv
/opt/gridfleet-agent/venv/bin/pip install gridfleet-agent
/opt/gridfleet-agent/venv/bin/gridfleet-agent install --no-start --manager-url http://manager.example.com:8000

--no-start writes the config and service files but does not enable or start the host service yet.

To also enable/start the service and poll local health:

/opt/gridfleet-agent/venv/bin/gridfleet-agent install --start --manager-url http://manager.example.com:8000

After local health passes, --start also checks whether the host appears in the manager host list. Pending registration is reported as a warning because host approval may still require operator action.

For a one-command bootstrap from a release checkout or raw GitHub URL:

VERSION=0.3.0 sudo -E bash scripts/install-agent.sh --manager-url http://manager.example.com:8000

Inspect local installation state without changing anything:

gridfleet-agent status

The status command reads config.env, checks the local service manager when available, polls local health, and redacts stored secrets.

Upgrade the dedicated agent venv package and restart the host service:

sudo -E /opt/gridfleet-agent/venv/bin/gridfleet-agent update --to 0.3.0

The update command waits for local Appium nodes reported by /agent/health to drain before upgrading the package or restarting the service. Use gridfleet-agent update --dry-run --to 0.3.0 to preview the drain, pip upgrade, service restart, and local health-check steps.

Uninstall requires explicit confirmation:

gridfleet-agent uninstall --yes

Use --keep-config or --keep-agent-dir when you want to preserve local configuration or downloaded runtime state.