1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
|
DCOS Command Line Interface
===========================
The DCOS Command Line Interface (CLI) is a cross-platform command line utility
that provides a user-friendly yet powerful way to manage DCOS installations.
Installation and Usage
----------------------
If you're a **user** of DCOS, please follow the `installation instructions`_.
Otherwise, follow the instructions below to set up your development environment.
Detailed help and usage information is available through the :code:`dcos help`
command and for specific subcommands through :code:`dcos <subcommand> --help`.
Additional documentation for the CLI and for the DCOS in general is available
in the `Mesosphere docs`_.
Parsing CLI Output
------------------
The CLI outputs either whitespace delimited tables which can be processed by
all of your favourite Unix/Linux tools like sed, awk and grep, or text formatted
as JSON when using the :code:`--json` flag.
If using JSON, you can combine it with the powerful jq_ utility.
The example below installs every package available in the DCOS repository::
dcos package search --json | jq '.[0].packages[].name' | xargs -L 1 dcos package install --yes
Using the CLI without DCOS
--------------------------
You may optionally configure the DCOS CLI to work with open source Mesos and
Marathon_ by setting the following properties::
dcos config set core.mesos_master_url http://<mesos-master-host>:5050
dcos config set marathon.url http://<marathon-host>:8080
Note that the DCOS CLI has tight integration with DCOS and certain
functionality may not work as expected or at all when using it directly with
Mesos and Marathon.
Controlling Analytics Reporting
-------------------------------
The CLI reports usage and exception information to Segment.io for production
usage.
If you wish to turn reporting of analytics off entirely,
you can set the :code:`core.reporting` property to false::
dcos config set core.reporting false
Dependencies
------------
#. git_ must be installed and on the system path in order to fetch
packages from :code:`git` sources.
#. virtualenv_ must be installed and on the system path in order to install
subcommands.
Setup
-----
#. Make sure you meet requirements for installing packages_
#. Clone git repo for the dcos cli::
git clone git@github.com:mesosphere/dcos-cli.git
#. Change directory to the repo directory::
cd dcos-cli
#. Make sure that you have virtualenv installed. If not type::
sudo pip install virtualenv
#. Create a virtualenv and packages for the dcos project::
make env
make packages
#. Create a virtualenv for the dcoscli project::
cd cli
make env
Configure Environment and Run
-----------------------------
#. :code:`source` the setup file to add the :code:`dcos` command line
interface to your :code:`PATH` and create an empty configuration file::
source bin/env-setup-dev
#. Configure the CLI, changing the values below as appropriate for your local
installation of DCOS::
dcos config set core.dcos_url http://dcos-ea-1234.us-west-2.elb.amazonaws.com
dcos config append package.sources https://github.com/mesosphere/universe/archive/version-1.x.zip
dcos config set package.cache /tmp/dcos
dcos package update
#. Get started by calling the DCOS CLI help::
dcos help
Running Tests
--------------
Setup
#####
Tox, our test runner, tests against both Python 2.7 and Python 3.4
environments.
If you're using OS X, be sure to use the officially distributed Python 3.4
installer_ since the Homebrew version is missing a necessary library.
Running
#######
Tox will run unit and integration tests in both Python environments using a
temporarily created virtualenv.
You can set :code:`DCOS_CONFIG` to a config file that points to a DCOS
cluster you want to use for integration tests. This defaults to
:code:`~/.dcos/dcos.toml`
If you are testing against the DCOS Image you can configure the URL to the
Exhibitor::
export EXHIBITOR_URL=http://<hostname>:8181/
There are two ways to run tests, you can either use the virtualenv created by
:code:`make env` above::
make test
Or, assuming you have tox installed (via :code:`sudo pip install tox`)::
tox
Other Useful Commands
#####################
#. List all of the supported test environments::
tox --listenvs
#. Run a specific set of tests::
tox -e <testenv>
#. Run a specific integration test module::
tox -e py27-integration /cli/test_config.py
Releasing
#########
Releasing a new version of the DCOS CLI is only possible through an `automated TeamCity build`_ which is triggered automatically when a new tag is added.
The tag is used as the version number and must adhere to the conventional `PEP-440 version scheme`_.
Once all tests pass successfully, the automated build publishes two packages to PyPI using the `publish_to_pypi.sh script`_:
#. dcos_
#. dcoscli_
These packages are now available to be installed by the DCOS CLI installation script in the `mesosphere/install-scripts`_ repository.
.. _automated TeamCity build: https://teamcity.mesosphere.io/viewType.html?buildTypeId=ClosedSource_DcosCli_PushToPyPI
.. _dcos: https://pypi.python.org/pypi/dcos
.. _dcoscli: https://pypi.python.org/pypi/dcoscli
.. _dcos-helloworld: https://github.com/mesosphere/dcos-helloworld
.. _jq: http://stedolan.github.io/jq/
.. _git: http://git-scm.com
.. _installation instructions: http://docs.mesosphere.com/install/cli/
.. _installer: https://www.python.org/downloads/
.. _installer: https://www.python.org/downloads/
.. _Marathon: https://mesosphere.github.io/marathon/
.. _Mesosphere docs: http://docs.mesosphere.com
.. _mesosphere/install-scripts: https://github.com/mesosphere/install-scripts
.. _packages: https://packaging.python.org/en/latest/installing.html#installing-requirements
.. _PEP-440 version scheme: https://www.python.org/dev/peps/pep-0440/
.. _publish_to_pypi.sh script: https://github.com/mesosphere/dcos-cli/blob/master/bin/publish_to_pypi.sh
.. _setup: https://github.com/mesosphere/dcos-helloworld#setup
.. _virtualenv: https://virtualenv.pypa.io/en/latest/
|
