Deployments

    Deployments push model updates to groups of edge devices using staged rollout strategies.

    Create a Deployment

    openeye fleet deploy --name "yolo-v2-rollout" --model yolov8 --version v2.1.0 --strategy canary
    openeye fleet deploy --model yolov8 --version v2.1.0 --group <group-id> --url https://example.com/yolov8.onnx

    --model and --version are required; --name is generated if omitted, and --strategy defaults to canary. REST: POST /deployments with JSON body. On openeye.sh, the dashboard's Fleet → Deployments page creates and tracks deployments (with per-device status) in your account.

    Rollout Strategies

    StrategyDescription
    canaryDeploy to a small percentage first, then expand in stages
    rollingGradually roll out to all devices in batches
    blue_greenSwitch all devices at once after validation
    all_at_onceDeploy to all target devices simultaneously

    Deployment REST Endpoints

    MethodEndpointDescription
    POST/deploymentsCreate deployment
    GET/deploymentsList deployments (filter by status)
    GET/deployments/{id}Get deployment details
    GET/deployments/{id}/devicesGet device statuses for deployment
    POST/deployments/{id}/advanceAdvance deployment stage
    POST/deployments/{id}/pausePause deployment
    POST/deployments/{id}/rollbackRollback deployment

    Manage a Rollout

    openeye fleet deployments --status in_progress
    openeye fleet advance <deployment-id>
    openeye fleet pause-deployment <deployment-id>
    openeye fleet rollback <deployment-id>

    OTA Updates

    openeye fleet ota --url https://example.com/agent-1.3.0.tar.gz --version 1.3.0 --group <group-id>
    openeye fleet ota --url https://example.com/agent-1.3.0.tar.gz --version 1.3.0 --devices <id1>,<id2> --force