Installation¶
DC/OS E2E consists of a Python Library and various CLI Tools.
The CLI can be installed with Homebrew on macOS, and the library and CLI can be installed together with pip
on any Linux and macOS.
Windows is not currently supported, but we provide instructions on using DC/OS E2E on Windows with Vagrant on particular Backends’ documentation.
CLI on macOS With Homebrew¶
To install the CLI on macOS, install Homebrew.
Then install the latest stable version:
brew install https://raw.githubusercontent.com/dcos/dcos-e2e/master/dcose2e.rb
To upgrade from an older version, run the following command:
brew upgrade https://raw.githubusercontent.com/dcos/dcos-e2e/master/dcose2e.rb
Or the latest master
:
Homebrew installs the dependencies for the latest released version and so installing master
may not work.
brew install --HEAD https://raw.githubusercontent.com/dcos/dcos-e2e/master/dcose2e.rb
CLI on Linux With Linuxbrew¶
One way to install the CLI on Linux is with Linuxbrew. Install Linuxbrew, then install the latest stable version:
brew install https://raw.githubusercontent.com/dcos/dcos-e2e/master/dcose2e.rb
To upgrade from an older version, run the following command:
brew upgrade https://raw.githubusercontent.com/dcos/dcos-e2e/master/dcose2e.rb
Or the latest master
:
Homebrew installs the dependencies for the latest released version and so installing master
may not work.
brew install --HEAD https://raw.githubusercontent.com/dcos/dcos-e2e/master/dcose2e.rb
Library and CLI with Python¶
If the CLI has been installed with Homebrew, you do not need to install the library to use the CLI.
Requires Python 3.5.2+. To avoid interfering with your system’s Python, we recommend using a virtualenv.
Check the Python version:
python3 --version
On Fedora, install Python development requirements:
sudo dnf install -y git python3-devel
On Ubuntu, install Python development requirements:
apt install -y gcc python3-dev
If you are not in a virtualenv, you may have to use sudo
before the following command, or --user
after install
.
pip3 install --upgrade git+https://github.com/dcos/dcos-e2e.git@2018.10.17.1
CLI on Linux with Pre-built Packages¶
One way to install the CLI on Linux is with a pre-built package.
# Install dcos-docker curl --fail -L https://github.com/dcos/dcos-e2e/releases/download/2018.10.17.1/dcos-docker /usr/local/bin/dcos-docker && \ chmod +x /usr/local/bin/dcos-docker # Install dcos-vagrant curl --fail -L https://github.com/dcos/dcos-e2e/releases/download/2018.10.17.1/dcos-vagrant /usr/local/bin/dcos-vagrant && \ chmod +x /usr/local/bin/dcos-vagrant # Install dcos-aws curl --fail -L https://github.com/dcos/dcos-e2e/releases/download/2018.10.17.1/dcos-aws /usr/local/bin/dcos-aws && \ chmod +x /usr/local/bin/dcos-aws
Uninstall¶
To uninstall DC/OS E2E, use one of the following methods, depending on how you installed DC/OS E2E.
For pip
installations:
pip3 uninstall -y dcos-e2e
For Homebrew or Linuxbrew installations:
# --force uninstalls all versions of DC/OS E2E which have been installed. brew uninstall dcose2e --force
For installations from pre-built packages:
rm -f /usr/local/bin/dcos-docker rm -f /usr/local/bin/dcos-vagrant rm -f /usr/local/bin/dcos-aws