dcos/dcos-test-utils

Name: dcos-test-utils

Owner: DC/OS

Description: Utilities for testing and interacting with DC/OS services

Created: 2017-07-06 04:38:23.0

Updated: 2018-04-27 23:57:06.0

Pushed: 2018-05-10 00:14:19.0

Homepage:

Size: 401

Language: Python

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

dcos-test-utils

This module is the backend for the dcos_api_session object used as a test harness in the DC/OS integration tests. More specifically, this module provides utilities that allow:

• Storing common URL elements repeated between requests to the same service
• Providing a DC/OS-authenticated API Client that can be wrapped and composed with API Mixins
• Helper methods for managing Marathon and other DC/OS services

To read more about how to use this library, Read the Docs

System Requirements

• python 3.5
• local SSH client at /usr/bin/ssh

Using the library interactively

on3.5 -m venv env
v/bin/activate
 install -r requirements.txt
on setup.py develop

Running Unit Tests with tox

Simply run tox and the following will be executed:

• flake8 for style errors
• pytest for unit tests

Note: these can be triggered individually by supplying the -e option to tox

Running Integration Tests with Tox

Integration tests are not run by default as they require a real DC/OS cluster which is externally provided.

To launch a cluster, check out dcos-launch, which can be used like so (on a GNU/Linux system):

in/bash
 https://downloads.dcos.io/dcos-launch/bin/linux/dcos-launch
d +x dcos-launch
<<EOF > config.yaml

ch_config_version: 1
oyment_name: YOUR-DEPLOYMENT-NAME-HERE
late_url: https://s3.amazonaws.com/downloads.dcos.io/dcos/testing/master/cloudformation/single-master.cloudformation.json
ider: aws
region: us-west-2
helper: true
late_parameters:
AdminLocation: 0.0.0.0/0
PublicSlaveInstanceCount: 1
SlaveInstanceCount: 1
user: core


-launch create

-launch wait

rt DCOS_DNS_ADDRESS=http://`dcos-launch describe | jq -r .masters[0].public_ip`

 WAIT_FOR_HOSTS is set to `true`, then MASTER_LIST, SLAVE_LIST, and PUBLIC_SLAVE list
st be set before starting the test
rt WAIT_FOR_HOSTS=false

-e py35-integration-tests

-launch-delete