Yet Another Ambari Shell
pip install yaas
env YAAS_SERVER=ambari.example.com yaas [options] [command options [...]]
-
--help
$ yaas --help usage: yaas ...$ yaas help usage: yaas ... -
--version
$ yaas --version x.x.x$ yaas version x.x.x -
--raw
$ yaas --raw ... (JSON) -
--debug
$ yaas --debug ... (verbose)
All API commands require setting these environment variables:
YAAS_SERVER--the address or name of the Ambari server- Example: ambari.example.com
- Default: none (This is required.)
YAAS_SCHEME--the scheme to use when connecting to the Ambari server- Example: https
- Default: http
YAAS_PORT--the port of the Ambari server- Example: 443
- Default: 8080
YAAS_USER--the user to auth with to the Ambari server- Example: l337u53r
- Default: admin
YAAS_PASSWORD--the password to auth with to the ambari server- Example: l337p455
- Default: admin
$ export YAAS_SERVER=ambari.example.com
$ yaas ...
$ env YAAS_SERVER=ambari.example.com yaas ...
POST /api/v1/blueprints/:name
Store a blueprint on YAAS_SERVER.
$ yaas blueprint add blueprint1.json blueprint2.json
$ cat blueprint3.json | yaas blueprint add
-
--validate-topology
POST /api/v1/blueprints/:name?validate_topology=...Toggle topology validation.
GET /api/v1/blueprints
Show blueprints that are stored on YAAS_SERVER.
$ yaas blueprint list
blueprint1
blueprint2
blueprint3
- Note: This will list the name of the actual Blueprint (as specified inside the JSON file) which may differ from the file name.
-
--fields
GET /api/v1/blueprints?fields=...Add blueprint details to the list.
GET /api/v1/blueprints/:name
Show details about a blueprint stored on YAAS_SERVER.
$ yaas blueprint show blueprint1
DELETE /api/v1/blueprints/:name
Remove a blueprint stored on YAAS_SERVER.
$ yaas blueprint remove blueprint2
$ yaas blueprint list
blueprint1
blueprint3
$ yaas cluster create cluster1 --template=template1.json
$ cat template2.json | yaas cluster create cluster2
$ yaas cluster create cluster3
- --template
$ yaas cluster list
cluster1
cluster2
cluster3
$ yaas cluster show cluster1 --format=blueprint > blueprint1.json
$ yaas cluster show cluster2
...
- --format
$ yaas cluster destroy cluster2
$ yaas cluster list
cluster1
cluster3
GET /api/v1/hosts
Show hosts that are registered with YAAS_SERVER.
$ yaas host list
host1.example.com - cluster1
host2.example.com - cluster1
host3.example.com
-
--fields
GET /api/v1/hosts?fields=...Add host details to the list. See the Ambari API documentation for valid fields.
$ yaas host show [--hardware] host1.example.com host2.example.com ...
...
- --hardware
$ yaas repo add [--verify-baseurls=true] repo.json
See all configured repository URLs. Limit output by one or more of these parameters. Note that stack-version and stack-version must be specified together:
- stack-name (e.g. HDP)
- stack-version (e.g. 2.2)
- os-type (e.g. redhat6)
- repo-name (e.g. HDP-UTILS)
$ yaas repo list
HDP-2.2
redhat5
HDP: http://www.example.com/redhat5/HDP
HDP-UTILS: http://www.example.com/redhat5/HDP
redhat6
HDP: http://www.example.com/redhat6/HDP
HDP-UTILS: http://www.example.com/redhat6/HDP-UTILS-1.1.0.20
...
$ yaas repo list --stack-name=HDP --stack-version=2.2 --repo-name=HDP-UTILS
redhat5
HDP: http://www.example.com/redhat5/HDP-UTILS
redhat6
HDP: http://www.example.com/redhat6/HDP-UTILS
...
$ yaas repo list --stack-name=HDP --stack-version=2.2 --os-type=redhat6 --repo-name=HDP
http://www.example.com/redhat6/HDP
$ yaas repo set [--verify-baseurls=true] repo-changed.json
$ yaas repo remove HDP 2.2
$ yaas template create [--blueprint=blueprint1] [--host_group=host1.example.com ...] > template1.json
$ cat clueprint2.json | yaas template create [--host_group=host1.example.com ...] > template2.json
WARNING: You have not specified enough hosts to satisfy the blueprint.