Awesome
marathonctl
marathonctl is a command line tool for Marathon
Install
binary
Binary downloads available! Get the latest from the releases page.
source
go install github.com/shoenig/marathonctl@latest
docker
# Add to ~/.bash_aliases
alias marathonctl='docker run --rm --net=host shoenig/marathonctl:latest'
Usage
marathonctl <flags...> [action] <args...>
Actions
app
list - list all apps
versions [id] - list all versions of apps of id
show [id] - show config and status of app of id (latest version)
show [id] [version] - show config and status of app of id and version
create [jsonfile] - deploy application defined in jsonfile
update [id] [jsonfile] - update application id as defined in jsonfile
update cpu [id] [cpu%] - update application id to have cpu% of cpu share
update memory [id] [MB] - update application id to have MB of memory
update instances [id] [N] - update application id to have N instances
restart [id] - restart app of id
destroy [id] - destroy and remove all instances of id
task
list - list all tasks
list [id] - list tasks of app of id
kill [id] - kill all tasks of app id
kill [id] [taskid] - kill task taskid of app id
queue - list all queued tasks
group
list - list all groups
list [groupid] - list groups in groupid
create [jsonfile] - create a group defined in jsonfile
update [groupid] [jsonfile] - update group groupid as defined in jsonfile
destroy [groupid] - destroy group of groupid
deploy
list - list all active deploys
destroy [deployid] - cancel deployment of [deployid]
marathon
leader - get the current Marathon leader
abdicate - force the current leader to relinquish control
ping - ping Marathon master host[s]
Flags
-c [config file]
-h [host]
-u [user:password] (separated by colon)
-k - allow unverified tls connections
-f [format]
human (simplified columns, default)
json (json on one line)
jsonpp (json pretty printed)
raw (the exact response from Marathon)
-v print git sha1
-s print semver version
Configuration
- Specify using "-c [file]" or "-h [host:port]"
Configuration Properties
marathon.host: [hosts] (ex http://node1.indeed.com,http://node2.indeed.com,http://node3.indeed.com)
marathon.user: [user]
marathon.password: [password]
Examples
Ping
- This example demonstrates -h, -u for host/login information
$ ./marathonctl -h http://marathon1:8080,http://marathon2:8080,http://marathon3:8080 -u user:pass marathon ping
HOST DURATION
http://marathon1:8080 11.004071ms
http://marathon2:8080 25.422ms
http://marathon3:8080 6.927772ms
Leader
- This example demonstrates -c and a file for host/login information
- This example demonstrates -f and the jsonpp (pretty printed json) output format
$ ./marathonctl -f jsonpp -c /etc/marathonctl.properties marathon leader
{
"leader": "tst-mcontrol1:8080"
}
Abdicate
- This example demonstrates -f to specify one-line json output format
./marathonctl -f json -c /etc/marathonctl.properties marathon abdicate
{"message":"Leadership abdicted"}
Group List
- This example demonstrates the default human readable output
$ ./marathonctl -c /etc/marathonctl.properties group list
GROUPID VERSION GROUPS APPS
/ 2015-04-07T20:29:35.672Z 3 0
/websites 2015-04-07T20:29:35.672Z 2 0
/websites/indeed 2015-04-07T20:29:35.672Z 1 0
/websites/indeed/indeed-pings 2015-04-07T20:29:35.672Z 1 0
/websites/indeed/indeed-pings/a.indeed.com 2015-04-07T20:29:35.672Z 0 2
/websites/google 2015-04-07T20:29:35.672Z 2 0
/websites/google/news.google.com 2015-04-07T20:29:35.672Z 0 1
/websites/google/calendar.google.com 2015-04-07T20:29:35.672Z 0 1
App Create
- This example demonstrates creating an app as specified in a json file
$ ./marathonctl -c /etc/marathonctl.properties app create sample/ping.google.json
APPID VERSION
/hoenig/ping-google 2015-04-07T21:41:53.440Z