github.com/misfo/deis@v1.0.1-0.20141111224634-e0eee0392b8a/docs/installing_deis/install-deisctl.rst (about)

     1  :title: Installing the Deis Control Utility
     2  :description: Learn how to install the Deis Control Utility
     3  
     4  .. _install_deisctl:
     5  
     6  Install deisctl
     7  ===============
     8  
     9  The Deis Control Utility, or ``deisctl`` for short, is a command-line client used to configure and
    10  manage the Deis Platform.
    11  
    12  Building from Installer
    13  -----------------------
    14  
    15  To install the latest version of deisctl, change to the directory where you would like to install
    16  the binary. Then, install the Deis Control Utility by downloading and running the install script
    17  with the following command:
    18  
    19  .. code-block:: console
    20  
    21      $ cd ~/bin
    22      $ curl -sSL http://deis.io/deisctl/install.sh | sh -s 1.0.0
    23  
    24  This installs deisctl to the current directory, and refreshes the Deis systemd unit files used to
    25  schedule the components. Link it to /usr/local/bin, so it will be in your PATH:
    26  
    27  .. code-block:: console
    28  
    29      $ sudo ln -fs $PWD/deisctl /usr/local/bin/deisctl
    30  
    31  To change installation options, save the installer directly:
    32  
    33  .. image:: download-linux-brightgreen.svg
    34     :target: https://s3-us-west-2.amazonaws.com/opdemand/deisctl-1.0.0-linux-amd64.run
    35  
    36  .. image:: download-osx-brightgreen.svg
    37     :target: https://s3-us-west-2.amazonaws.com/opdemand/deisctl-1.0.0-darwin-amd64.run
    38  
    39  Then run the downloaded file as a shell script. Append ``--help`` to see what options
    40  are available.
    41  
    42  .. important::
    43  
    44      Always use a version of ``deisctl`` that matches the Deis release.
    45      Verify this with ``deisctl --version``.
    46  
    47  Builds are hosted on an S3 bucket at this URL format:
    48  
    49  ``https://s3-us-west-2.amazonaws.com/opdemand/deisctl-<VERSION>-<darwin|linux>-amd64.run``
    50  
    51  For example, the deisctl release for Deis version 1.0.0 can be downloaded here:
    52  
    53  .. image:: download-linux-brightgreen.svg
    54     :target: https://s3-us-west-2.amazonaws.com/opdemand/deisctl-1.0.0-linux-amd64.run
    55  
    56  .. image:: download-osx-brightgreen.svg
    57     :target: https://s3-us-west-2.amazonaws.com/opdemand/deisctl-1.0.0-darwin-amd64.run
    58  
    59  Building from Source
    60  --------------------
    61  
    62  If you want to install from source, ensure you have `godep`_ installed and run:
    63  
    64  .. code-block:: console
    65  
    66  	$ make -C deisctl build
    67  
    68  You can then move or link the client so it will be in your path:
    69  
    70  .. code-block:: console
    71  
    72  	$ sudo ln -fs $PWD/deisctl/deisctl /usr/local/bin/deisctl
    73  
    74  
    75  .. _`godep`: https://github.com/tools/godep