Changelog¶
Contents
Next¶
Drop support for Python 3.5 and DC/OS 1.9 - 1.11. These versions may continue to work, but will no longer be tested.
2020.08.14.0¶
Updated
google-api-python-client
tov1.7.12
.Added support for CentOS 8 and Flatcar when using Docker.
2020.05.26.0¶
Changed the default version of
dcos-vagrant-box
to0.10
.Updated dependencies.
Drop support for RHEL in
minidcos aws
.
2019.10.11.0¶
Update vendored
dcos-test-utils
dependency.
2019.10.10.0¶
Bump
dcos-test-utils
dependency.
2019.08.28.0¶
Fix issue which prevented CoreOS nodes starting on Docker.
2019.06.19.0¶
Renamed
Cluster.run_integration_tests
’stest_host
parameter tonode
.Renamed
Cluster.run_integration_tests
’spytest_command
parameter toargs
.Renamed
Cluster.run_integration_tests
toCluster.run_with_test_environment
.Split
Cluster
andNode
upgrade
andinstall_dcos
functions into*_dcos_from_[path|url]
functions.Enable larger log sizes and lower memory uses by moving
Docker
backend logs to the host disk.
2019.06.15.0¶
Add
minidcos aws destroy
andminidcos aws destroy-list
commands.
2019.06.10.0¶
Fix error “No module named ‘keyring.util.escape’”.
Added
Cluster.upgrade_dcos
andminidcos
upgrade
commands.Replaced
Cluster.install_dcos_from_url
andCluster.install_dcos_from_path
withCluster.install_dcos
which takes a URL or Path.Replaced
Node.install_dcos_from_url
andNode.install_dcos_from_path
withNode.install_dcos
which takes a URL or Path.Fix
minidcos
inspect
commands for legacy versions of DC/OS.Add options to enable or disable spinner animations in
minidcos
.
2019.06.07.0¶
Get DC/OS build information from a
Node
object after installation.Added option to
minidcos aws create
andminidcos aws provision
to choose the AWS instance type.Changed the default version of Docker installed on
minidcos docker
clusters to18.06.3-ce
.Added
Node.upgrade_dcos_from_path
.Added
minidcos docker upgrade
.
2019.06.03.0¶
Added options to choose the amount of memory given to each VM.
Fixed a bug which prevented
minidcos vagrant
from working when a VM existed with a space in the name.Fixed a bug which prevented
minidcos vagrant
from working in some situations when the$HOME
environment variable is not set.
2019.05.24.1¶
Add a
minidcos docker doctor
check which fails when usingBoot2Docker
.
2019.05.23.1¶
Fix issue with
minidcos vagrant
which prevented node access via SSH.Change
minidcos
default credentials for DC/OS Enterprise clusters fromadmin/admin
tobootstrapuser/deleteme
.
2019.05.23.0¶
Download a file or directory from a
Node
.Improve efficiency of installing DC/OS with
create
onminidcos docker
andminidcos aws
.Allow the use of a
MINIDCOS_NODE_DOCKER_VERSION
environment variable to set the version of Docker insideminidcos docker
nodes.
2019.04.29.0¶
Remove use of
select
which is not supported on Windows.minidcos docker clean
will no longer clean up containers which are started from now on by the tooling to create a custom macOS network.
2019.04.23.1¶
The
wait_for_dcos_oss
andwait_for_dcos_ee
methods no longer log output of node poststart check command run.The
Node.run
method logs the command that is going to execute withdebug
level ifoutput
is configured toLOG_AND_CAPTURE
.The
Node.run
method no longer logsstderr
whenOutput.CAPTURE
is used.The
Node.run
method no longer mergesstderr
intostdout
whenOutput.LOG_AND_CAPTURE
is used.
2019.04.23.0¶
The library no longer configures logger handler. Applications using
dcos_e2e
library that were relying on logging being printed to stdout should configurelogging
on its own.
2019.04.18.1¶
Add new commands to
minidcos vagrant
andminidcos aws
to provision a bare cluster (provision
) and install DC/OS on a bare cluster (install
).
2019.04.18.0¶
Improve the spinner while waiting for
minidcos
commands.Add
send-file
commands tominidcos
subcommands.Remove
--env
option onminidcos docker inspect
.Custom backends must now specify the base config in the
ClusterBackend
rather than theClusterManager
.Add new commands to
minidcos docker
to provision a bare cluster (provision
) and install DC/OS on a bare cluster (install
).
2019.04.08.1¶
Add
minidcos vagrant clean
command to clean up left over VMs.
2019.04.08.0¶
Allow multiple
--node
options onrun
commands to run a command on multiple nodes.minidcos vagrant list
will now not show clusters with aborted VMs. A VM is aborted for example if the host is shut down.
2019.04.02.1¶
Make various
minidcos
commands faster by using caching.
2019.04.02.0¶
Remove warnings about YAML when running
minidcos vagrant
.
2019.03.28.0¶
Change names of install functions for custom backends to remove
_with_bootstrap_node
.
2019.03.27.0¶
Allow login after
minidcos docker wait
on DC/OS OSS 1.13.
2019.02.16.0¶
Mount
/sys/fs/cgroup
into Docker agents by default.Add options to the CLI and library to disable mounting
/sys/fs/cgroup
.
2019.01.27.1¶
Stop mounting
/sys/fs/cgroup
into Docker agents.
2019.01.27.0¶
Add more
minidcos docker doctor
checks.
2019.01.10.0¶
Fix issue where “RuntimeError: cannot join current thread” was shown.
2019.01.05.0¶
Backwards incompatible change: Move
ClusterBackend
andClusterManager
todcos_e2e.base_classes
.
2018.12.05.0¶
Limit UUID in the cluster ID to 5 characters to avoid problems with Docker.
2018.12.01.0¶
Ship type hints for other packages to use.
2018.11.22.0¶
Allow
-h
instead of--help
on all CLI commands.
2018.11.20.1¶
Allow multiple
--sync-dir
options to be given torun
commands.
2018.11.20.0¶
Rename
build_artifact
and related variables to “installer”.If syncing a DC/OS OSS repository to a DC/OS Enterprise cluster, only Open Source tests are synced.
2018.11.16.1¶
Backwards incompatible change: Changed CLI commands from
dcos-docker
tominidcos docker
and alike.
2018.11.16.0¶
Add a
dcos-docker doctor
check for systemd.Add a progress bar for
doctor
commands.Log subprocess output unicode characters where possible.
2018.11.09.1¶
Backwards incompatible change: Change
--no-test-env
to--test-env
onrun
commands, with the opposite default.
2018.11.09.0¶
Fix an issue which caused incompatible version errors between
keyring
andSecretStore
dependencies.
2018.11.07.0¶
Add
dcos-docker create-loopback-sidecar
anddcos-docker destroy-loopback-sidecar
commands to provide unformatted block devices to DC/OS.Add
dcos-docker clean
command to clean left over artifacts.Backwards incompatible change: Changed names of VPN containers on macOS.
2018.10.17.0¶
Fix an issue which stopped the SSH transport from working on CLIs.
2018.10.16.0¶
Remove
log_output_live
parameters on various functions in favor of newoutput
options.Node.__init__
’sssh_key_path
parameter now expects a path to an SSH key file with specific permissions.See the documentation for this class for details.
2018.10.12.0¶
The
docker-exec
transport uses interactive mode only when running in a terminal.
2018.10.11.0¶
Show full path on
download-artifact
downloads.Default to downloading to the current directory for
download-artifact
downloads.Use a TTY on CLI run commands only if Stdin is a TTY.
2018.10.10.0¶
Fix issues which stopped pre-built Linux binaries from working.
2018.09.25.0¶
wait_for_dcos_oss
andwait_for_dcos_ee
now raise a customDCOSTimeoutError
if DC/OS has not started within one hour.
2018.09.06.0¶
The
--variant
option is now required for thedcos-aws
CLI.Added the ability to install on Linux from a pre-built binary.
Add the ability to do a release to a fork.
2018.08.31.0¶
Fix using macOS with no custom network.
2018.08.28.0¶
Support for CoreOS on the AWS backend.
Fix an issue which prevented the Vagrant backend from working.
2018.08.22.0¶
Improve diagnostics when creating a Docker-backed cluster with no running Docker daemon.
2018.08.13.0¶
Add instructions for uninstalling DC/OS E2E.
2018.08.03.0¶
Pin
msrestazure
pip dependency to specific version to avoid dependency conflict.
2018.07.31.0¶
Add a
dcos-docker doctor
check that relevant Docker images can be built.
2018.07.30.0¶
Add Red Hat Enterprise Linux 7.4 support to the AWS backend.
2018.07.27.0¶
Fix bug which meant that a user could not log in after
dcos-docker wait
on DC/OS Open Source clusters.Backwards incompatible change: Remove
files_to_copy_to_installer
fromCluster.__init__
and addfiles_to_copy_to_genconf_dir
as an argument toCluster.install_dcos_from_path
as well asCluster.install_dcos_from_url
.Add
files_to_copy_to_genconf_dir
as an argument toNode.install_dcos_from_path
andNode.install_dcos_from_url
.
2018.07.25.0¶
Add the capability of sending a directory to a
Node
viaNode.send_file
.Add
ip_detect_path
to the eachClusterBackend
as a property and to each install DC/OS function as a parameter.
2018.07.23.0¶
Add an initial
dcos-aws
CLI.
2018.07.22.1¶
Add
dcos-docker download-artifact
anddcos-vagrant download-artifact
.
2018.07.22.0¶
Add
verbose
option to multiple commands.
2018.07.16.0¶
Add
virtualbox_description
parameter to theVagrant
backend.Change the default transport for the Docker backend to
DOCKER_EXEC
.
2018.07.15.0¶
Add a
--one-master-host-port-map
option todcos-docker create
.
2018.07.10.0¶
Execute
node-poststart
checks inCluster.wait_for_dcos
andCluster.wait_for_dcos_ee
.Add
dcos-vagrant doctor
checks.
2018.07.03.5¶
Add a
--network
option to thedcos-docker
CLI.
2018.07.03.0¶
Add a
dcos-vagrant
CLI.
2018.07.01.0¶
Renamed Homebrew formula. To upgrade from a previous version, follow Homebrew’s linking instructions after upgrade instructions.
2018.06.30.0¶
Add a
Vagrant
backend.
2018.06.28.2¶
Add a
aws_instance_type
parameter to theAWS
backend.
2018.06.28.0¶
Compare
Node
objects based on thepublic_ip_address
andprivate_ip_address
.
2018.06.26.0¶
Add a
network
parameter to theDocker
backend.
2018.06.20.0¶
Add platform-independent DC/OS installation method from
Path
and URL onNode
.
2018.06.18.0¶
Add
dcos-docker doctor
check for a version conflict between systemd and Docker.Allow installing DC/OS by a URL on the Docker backend, and a cluster
from_nodes
.
2018.06.14.1¶
Add
Cluster.remove_node
.
2018.06.14.0¶
Add Ubuntu support to the Docker backend.
Add
aws_key_pair
parameter to the AWS backend.Fix Linuxbrew installation on Ubuntu.
2018.06.12.1¶
Add a
--wait
flag todcos-docker create
to also wait for the cluster.
2018.06.12.0¶
dcos-docker create
now creates clusters with the--cluster-id
“default” by default.
2018.06.05.0¶
Change
Node.default_ssh_user
toNode.default_user
.Add a
docker exec
transport toNode
operations.Add a
--transport
options to multipledcos-docker
commands.
2018.05.29.0¶
Do not pin
setuptools
to an exact version.
2018.05.24.2¶
Add
--env
option todcos-docker run
.
2018.05.24.1¶
Make
xfs_info
available on nodes, meaning that preflight checks can be run on nodes with XFS.Fix
dcos-docker doctor
for cases wheredf
produces very long results.
2018.05.21.0¶
Show a formatted error rather than a traceback if Docker cannot be connected to.
Custom backends’ must now implement a
base_config
method.Custom backends’ installation methods must now take
dcos_config
rather thanextra_config
.Cluster.install_dcos_from_url
andCluster.install_dcos_from_path
now takedcos_config
rather thanextra_config
.
2018.05.17.0¶
Add a
--variant
option todcos-docker create
to speed up cluster creation.
2018.05.15.0¶
Add a
test_host
parameter toCluster.run_integration_tests
.Add the ability to specify a node to use for
dcos-docker run
.
2018.05.14.0¶
Show IP address in
dcos-docker inspect
.
2018.05.10.0¶
Expose the SSH key location in
dcos-docker inspect
.Make network created by
setup-mac-network
now survives restarts.
2018.05.02.0¶
Previously not all volumes were destroyed when destroying a cluster from the CLI or with the
Docker
backend. This has been resolved. To remove dangling volumes from previous versions, usedocker volume prune
.Backwards incompatible change:
mount
parameters toDocker.__init__
now take alist
ofdocker.types.Mount
s.Docker version 17.06 or later is now required for the CLI and for the
Docker
backend.
2018.04.30.2¶
Added
dcos-docker destroy-mac-network
command.Added a
--force
parameter todcos-docker setup-mac-network
to override files and containers.
2018.04.29.0¶
Added
dcos-docker setup-mac-network
command.
2018.04.25.0¶
Logs from dependencies are no longer emitted.
The
dcos-docker
CLI now gives more feedback to let you know that things are happening.
2018.04.19.0¶
The AWS backend now supports DC/OS 1.9.
The Docker backend now supports having custom mounts which apply to all nodes.
Add
custom-volume
parameter (and similar for each node type) todcos-docker create
.
2018.04.11.0¶
Add an AWS backend to the library.
Add ability to control which labels are added to particular node types on the
Docker
backend.Add support for Ubuntu on the
Docker
backend.
2018.04.02.1¶
Add a new
dcos-docker doctor
check for suitablesed
for DC/OS 1.9.Support
cluster.run_integration_tests
on DC/OS 1.9.
2018.04.02.0¶
Add support for DC/OS 1.9 on Linux hosts.
dcos-docker doctor
returns a status code of1
if there are any errors.Add a new
dcos-docker doctor
check for free space in the Docker root directory.
2018.03.26.0¶
Add a
dcos-docker doctor
check that a supported storage driver is available.Fix error with using Docker version v17.12.1-ce inside Docker nodes.
Fix race condition between installing DC/OS and SSH starting.
Remove support for Ubuntu on the Docker backend.
2018.03.07.0¶
Fix public agents on DC/OS 1.10.
Remove options to use Fedora and Debian in the
Docker
backend nodes.Fix the Ubuntu distribution on the
Docker
backend.Add support for Docker
17.12.1-ce
on nodes in theDocker
backend.Exceptions in
create
in the CLI point towards thedoctor
command.Removed a race condition in the
doctor
command.dcos-docker run
now exits with the return code of the command run.dcos-docker destroy-list
is a new command anddcos-docker destroy
now adheres to the common semantics of the CLI.
2018.02.28.0¶
Add
Vagrantfile
to run DC/OS E2E in a virtual machine.Add instructions for running DC/OS E2E on Windows.
Allow relative paths for the build artifact.
2018.02.27.0¶
Backwards incompatible change: Move
default_ssh_user
parameter fromCluster
toNode
. Thedefault_ssh_user
is now used forNode.run
,Node.popen
andNode.send_file
ifuser
is not supplied.
2018.02.23.0¶
Add
linux_distribution
parameter to theDocker
backend.Add support for CoreOS in the
Docker
backend.Add
docker_version
parameter to theDocker
backend.The fallback Docker storage driver for the
Docker
backend is nowaufs
.Add
storage_driver
parameter to theDocker
backend.Add
docker_container_labels
parameter to theDocker
backend.Logs are now less cluttered with escape characters.
Documentation is now on Read The Docs.
Add a Command Line Interface.
Vendor
dcos_test_utils
so--process-dependency-links
is not needed.Backwards incompatible change:
Cluter
’sfiles_to_copy_to_installer
argument is now aList
ofTuple
s rather than aDict
.Add a
tty
option toNode.run
andCluster.run_integration_tests
.
2018.01.25.0¶
Backwards incompatible change: Change the default behavior of
Node.run
andNode.popen
to quote arguments, unless a newshell
parameter isTrue
. These methods now behave similarly tosubprocess.run
.Add custom string representation for
Node
object.Bump
dcos-test-utils
for better diagnostics reports.
2018.01.22.0¶
Expose the
public_ip_address
of the SSH connection and theprivate_ip_address
of its DC/OS component onNode
objects.Bump
dcos-test-utils
for better diagnostics reports.
2017.12.11.0¶
Replace the extended
wait_for_dcos_ee
timeout with a precedingdcos-diagnostics
check.
2017.12.08.0¶
Extend
wait_for_dcos_ee
timeout for waiting until the DC/OS CA cert can be fetched.
2017.11.29.0¶
Backwards incompatible change: Introduce separate
wait_for_dcos_oss
andwait_for_dcos_ee
methods. Both methods improve the boot process waiting time for the corresponding DC/OS version.Backwards incompatible change:
run_integration_tests
now requires users to callwait_for_dcos_oss
orwait_for_dcos_ee
beforehand.
2017.11.21.0¶
Remove
ExistingCluster
backend and replaced it with simplerCluster.from_nodes
method.Simplified the default configuration for the Docker backend. Notably this no longer contains a default
superuser_username
orsuperuser_password_hash
.Support
custom_agent_mounts
andcustom_public_agent_mounts
on the Docker backend.
2017.11.15.0¶
Remove
destroy_on_error
anddestroy_on_success
fromCluster
. Instead, avoid usingCluster
as a context manager to keep the cluster alive.
2017.11.14.0¶
Backwards incompatible change: Rename
DCOS_Docker
backend toDocker
backend.Backwards incompatible change: Replace
generate_config_path
withbuild_artifact
that can either be aPath
or a HTTP(S) URL string. This allows for supporting installation methods that require build artifacts to be downloaded from a HTTP server.Backwards incompatible change: Remove
run_as_root
. Instead require adefault_ssh_user
for backends torun
commands over SSH on any clusterNode
created with this backend.Backwards incompatible change: Split the DC/OS installation from the ClusterManager
__init__
procedure. This allows for installing DC/OS afterCluster
creation, and therefore enables decoupling of transferring files ahead of the installation process.Backwards incompatible change: Explicit distinction of installation methods by providing separate methods for
install_dcos_from_path
andinstall_dcos_from_url
instead of inspecting the type ofbuild_artifact
.Backwards incompatible change:
log_output_live
is no longer an attribute of theCluster
class. It may now be passed separately as a parameter for each output-generating operation.
2017.11.02.0¶
Added
Node.send_file
to allow files to be copied to nodes.Added
custom_master_mounts
to the DC/OS Docker backend.Backwards incompatible change: Removed
files_to_copy_to_masters
. Instead, usecustom_master_mounts
orNode.send_file
.
2017.10.04.0¶
Added Apache2 license.
Repository moved to
https://github.com/dcos/dcos-e2e
.Added
run
, which is similar torun_as_root
but takes auser
argument.Added
popen
, which can be used for running commands asynchronously.
2017.08.11.0¶
Fix bug where
Node
repr
s were put into environment variables rather than IP addresses. This prevented some integration tests from working.
2017.08.08.0¶
Fixed issue which prevented
files_to_copy_to_installer
from working.
2017.08.05.0¶
The Enterprise DC/OS integration tests now require environment variables describing the IP addresses of the cluster. Now passes these environment variables.
2017.06.23.0¶
Wait for 5 minutes after diagnostics check.
2017.06.22.0¶
Account for the name of
3dt
having changed todcos-diagnostics
.
2017.06.21.1¶
Support platforms where
$HOME
is set as/root
.Cluster.wait_for_dcos
now waits for CA cert to be available.
2017.06.21.0¶
Add ability to specify a workspace.
Fixed issue with DC/OS Docker files not existing in the repository.
2017.06.20.0¶
Vendor DC/OS Docker so a path is not needed.
If
log_output_live
is set toTrue
for aCluster
, logs are shown inwait_for_dcos
.
2017.06.19.0¶
More storage efficient.
Removed need to tell
Cluster
whether a cluster is an enterprise cluster.Removed need to tell
Cluster
thesuperuser_password
.Added ability to set environment variables on remote nodes when running commands.
2017.06.15.0¶
Initial release.