Skip to main content

Install

Install a package on the target host:

$ osapi client node package install --target web-01 --name nginx

Job ID: 550e8400-e29b-41d4-a716-446655440000

HOSTNAME STATUS CHANGED NAME
web-01 changed true nginx

1 host: 1 changed

Broadcast to all hosts at once:

$ osapi client node package install --target _all --name htop

Job ID: 550e8400-e29b-41d4-a716-446655440000

HOSTNAME STATUS CHANGED NAME
web-01 changed true htop
web-02 changed true htop
mac-01 skip

3 hosts: 2 changed, 1 skipped

Details:
mac-01 unsupported platform

JSON Output

Use --json to get the full API response:

$ osapi client node package install --target web-01 --name nginx --json
{"results":[{"hostname":"web-01","name":"nginx","changed":true,
"status":"ok"}],"job_id":"..."}

Flags

FlagDescriptionDefault
--nameName of the package to installrequired
-T, --targetTarget: _any, _all, hostname, or label (group:web)_all
-j, --jsonOutput raw JSON response