Package: tutum
tutum=====CLI for Tutum. Full documentation available at `https://docs.tutum.co/v2/api/?shell# <https://docs.tutum.co/v2/api/?shell#>`_Installing the CLI------------------In order to install the Tutum CLI, you can use ``pip install``:.. sourcecode:: bashpip install tutumFor Mac OS users, you can use ``brew install``:.. sourcecode:: bashbrew install tutumNow you can start using it:.. sourcecode:: none$ tutumusage: tutum [-h] [-v]{build,container,event,exec,image,login,node,nodecluster,push,run,service,stack,tag,volume,volumegroup,trigger,up}...Tutum's CLIoptional arguments:-h, --help            show this help message and exit-v, --version         show program's version number and exitTutum's CLI commands:{build,container,event,exec,image,login,node,nodecluster,push,run,service,stack,tag,volume,volumegroup,trigger,up}build               Build an image using tutum/buildercontainer           Container-related operationsevent               Get real time tutum eventsexec                Run a command in a running containerimage               Image-related operationslogin               Login into Tutumnode                Node-related operationsnodecluster         NodeCluster-related operationspush                Push a local image to Tutum private registryrun                 Create and run a new serviceservice             Service-related operationsstack               Stack-related operationstag                 Tag-related operationsvolume              Volume-related operationsvolumegroup         VolumeGroup-related operationstrigger             Trigger-related operationsup                  Create and deploy a stackDocker image^^^^^^^^^^^^You can also install the CLI via Docker:.. sourcecode:: bashdocker run tutum/cli -hYou will have to pass your username and API key as environment variables, as the credentials stored via ``tutum login``will not persist by default:.. sourcecode:: bashdocker run -it -e TUTUM_USER=username -e TUTUM_APIKEY=apikey tutum/cliTo make things easier, you might want to use an ``alias`` for it:.. sourcecode:: bashalias tutum="docker run -it -v /usr/bin/docker:/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock -e TUTUM_USER=username -e TUTUM_APIKEY=apikey --rm tutum/cli"Then, you can run commands like:.. sourcecode:: bashtutum servicetutum execAuthentication--------------In order to manage your apps and containers running on Tutum, you need to log into Tutum in any of the following ways(will be used in this order):* Login using Tutum CLI or storing it directly in a configuration file in ``~/.tutum``:.. sourcecode:: bash$ tutum loginUsername: adminPassword:Login succeeded!Your login credentials will be stored in ``~/.tutum``:.. sourcecode:: ini[auth]user = "username"apikey = "apikey"* Set the environment variables ``TUTUM_USER``, ``TUTUM_APIKEY``, or ``TUTUM_USER``, ``TUTUM_PASS``:.. sourcecode:: bashexport TUTUM_USER=<username>export TUTUM_APIKEY=<apikey>or.. sourcecode:: bashexport TUTUM_USER=<username>export TUTUM_PASS=<password>* Set the environment variables ``TUTUM_AUTH``:.. sourcecode:: bashexport TUTUM_AUTH=tutumauth``TUTUM_AUTH`` is the environment variable injected via API rolesNote: ``tutum-cli`` and ``python-tutum`` will pick up the auth in the following order:* ``TUTUM_AUTH``* ``TUTUM_USER``, ``TUTUM_PASS`` or ``TUTUM_USER``, ``TUTUM_APIKEY``* ``~/.tutum``