From efcdbae9400631a47b9deb7bb87855c30f1958a8 Mon Sep 17 00:00:00 2001 From: James Page Date: Tue, 19 Jul 2016 09:53:18 +0100 Subject: [PATCH] Use bundletester for amulet test execution Switch to using bundletester for execution of functional tests, leveraging tox to build out test virtualenvs. Rename amulet tests inline with gate-* and dfs-* naming standards. Update README to refer to functional testing section of the charm guide. Change-Id: I038797ce2ac891567707e1b9c0697ba31ba3baed --- Makefile | 3 +- test-requirements.txt | 14 +++ tests/010-basic-precise-essex | 23 ---- tests/016-basic-trusty-juno | 25 ---- tests/020-basic-wily-liberty | 23 ---- tests/README | 113 ------------------ tests/README.md | 9 ++ tests/basic_deployment.py | 10 +- ...e-icehouse => gate-basic-precise-icehouse} | 0 ...ty-icehouse => gate-basic-trusty-icehouse} | 0 ...sic-trusty-kilo => gate-basic-trusty-kilo} | 0 ...usty-liberty => gate-basic-trusty-liberty} | 0 ...trusty-mitaka => gate-basic-trusty-mitaka} | 0 ...xenial-mitaka => gate-basic-xenial-mitaka} | 0 tests/tests.yaml | 38 +++--- tox.ini | 46 +++++++ 16 files changed, 92 insertions(+), 212 deletions(-) delete mode 100644 tests/010-basic-precise-essex delete mode 100755 tests/016-basic-trusty-juno delete mode 100755 tests/020-basic-wily-liberty delete mode 100644 tests/README create mode 100644 tests/README.md rename tests/{014-basic-precise-icehouse => gate-basic-precise-icehouse} (100%) rename tests/{015-basic-trusty-icehouse => gate-basic-trusty-icehouse} (100%) rename tests/{017-basic-trusty-kilo => gate-basic-trusty-kilo} (100%) rename tests/{018-basic-trusty-liberty => gate-basic-trusty-liberty} (100%) rename tests/{019-basic-trusty-mitaka => gate-basic-trusty-mitaka} (100%) rename tests/{021-basic-xenial-mitaka => gate-basic-xenial-mitaka} (100%) diff --git a/Makefile b/Makefile index b4da7cf..0af9513 100755 --- a/Makefile +++ b/Makefile @@ -10,8 +10,7 @@ test: functional_test: @echo Starting Amulet tests... - @tests/setup/00-setup - @juju test -v -p AMULET_HTTP_PROXY,AMULET_OS_VIP --timeout 2700 + @tox -e func27 bin/charm_helpers_sync.py: @mkdir -p bin diff --git a/test-requirements.txt b/test-requirements.txt index 4faf254..0697294 100644 --- a/test-requirements.txt +++ b/test-requirements.txt @@ -7,3 +7,17 @@ flake8>=2.2.4,<=2.4.1 os-testr>=0.4.1 charm-tools>=2.0.0 requests==2.6.0 +# BEGIN: Amulet OpenStack Charm Helper Requirements +# Liberty client lower constraints +amulet>=1.14.3,<2.0 +bundletester>=0.6.1,<1.0 +python-ceilometerclient>=1.5.0,<2.0 +python-cinderclient>=1.4.0,<2.0 +python-glanceclient>=1.1.0,<2.0 +python-heatclient>=0.8.0,<1.0 +python-novaclient>=2.30.1,<3.0 +python-openstackclient>=1.7.0,<2.0 +python-swiftclient>=2.6.0,<3.0 +pika>=0.10.0,<1.0 +distro-info +# END: Amulet OpenStack Charm Helper Requirements diff --git a/tests/010-basic-precise-essex b/tests/010-basic-precise-essex deleted file mode 100644 index 26b4f93..0000000 --- a/tests/010-basic-precise-essex +++ /dev/null @@ -1,23 +0,0 @@ -#!/usr/bin/python -# -# Copyright 2016 Canonical Ltd -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. - -"""Amulet tests on a basic swift-storage deployment on precise-essex.""" - -from basic_deployment import SwiftStorageBasicDeployment - -if __name__ == '__main__': - deployment = SwiftStorageBasicDeployment(series='precise') - deployment.run_tests() diff --git a/tests/016-basic-trusty-juno b/tests/016-basic-trusty-juno deleted file mode 100755 index 2686821..0000000 --- a/tests/016-basic-trusty-juno +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/python -# -# Copyright 2016 Canonical Ltd -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. - -"""Amulet tests on a basic swift-storage deployment on trusty-juno.""" - -from basic_deployment import SwiftStorageBasicDeployment - -if __name__ == '__main__': - deployment = SwiftStorageBasicDeployment(series='trusty', - openstack='cloud:trusty-juno', - source='cloud:trusty-updates/juno') - deployment.run_tests() diff --git a/tests/020-basic-wily-liberty b/tests/020-basic-wily-liberty deleted file mode 100755 index 5561e09..0000000 --- a/tests/020-basic-wily-liberty +++ /dev/null @@ -1,23 +0,0 @@ -#!/usr/bin/python -# -# Copyright 2016 Canonical Ltd -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. - -"""Amulet tests on a basic swift-storage deployment on wily-liberty.""" - -from basic_deployment import SwiftStorageBasicDeployment - -if __name__ == '__main__': - deployment = SwiftStorageBasicDeployment(series='wily') - deployment.run_tests() diff --git a/tests/README b/tests/README deleted file mode 100644 index 79c5b06..0000000 --- a/tests/README +++ /dev/null @@ -1,113 +0,0 @@ -This directory provides Amulet tests to verify basic deployment functionality -from the perspective of this charm, its requirements and its features, as -exercised in a subset of the full OpenStack deployment test bundle topology. - -Reference: lp:openstack-charm-testing for full test bundles. - -A single topology and configuration is defined and deployed, once for each of -the defined Ubuntu:OpenStack release combos. The ongoing goal is for this -charm to always possess tests and combo definitions for all currently-supported -release combinations of U:OS. - -test_* methods are called in lexical sort order, as with most runners. However, -each individual test method should be idempotent and expected to pass regardless -of run order or Ubuntu:OpenStack combo. When writing or modifying tests, -ensure that every individual test is not dependent on another test_ method. - -Test naming convention, purely for code organization purposes: - 1xx service and endpoint checks - 2xx relation checks - 3xx config checks - 4xx functional checks - 9xx restarts, config changes, actions and other final checks - -In order to run tests, charm-tools and juju must be installed: - sudo add-apt-repository ppa:juju/stable - sudo apt-get update - sudo apt-get install charm-tools juju juju-deployer amulet - -Alternatively, tests may be exercised with proposed or development versions -of juju and related tools: - - # juju proposed version - sudo add-apt-repository ppa:juju/proposed - sudo apt-get update - sudo apt-get install charm-tools juju juju-deployer - - # juju development version - sudo add-apt-repository ppa:juju/devel - sudo apt-get update - sudo apt-get install charm-tools juju juju-deployer - -Some tests may need to download files. If a web proxy server is required in -the environment, the AMULET_HTTP_PROXY environment variable must be set and -passed into the juju test command. This is unrelated to juju's http proxy -settings or behavior. - -The following examples demonstrate different ways that tests can be executed. -All examples are run from the charm's root directory. - - * To run all +x tests in the tests directory: - - bzr branch lp:charms/trusty/foo - cd foo - make functional_test - - * To run the tests against a specific release combo as defined in tests/: - - bzr branch lp:charms/trusty/foo - cd foo - juju test -v -p AMULET_HTTP_PROXY 015-basic-trusty-icehouse - - * To run tests and keep the juju environment deployed after a failure: - - bzr branch lp:charms/trusty/foo - cd foo - juju test --set-e -v -p AMULET_HTTP_PROXY 015-basic-trusty-icehouse - - * To re-run a test module against an already deployed environment (one - that was deployed by a previous call to 'juju test --set-e'): - - ./tests/015-basic-trusty-icehouse - - * Even with --set-e, `juju test` will tear down the deployment when all - tests pass. The following work flow may be more effective when - iterating on test writing. - - bzr branch lp:charms/trusty/foo - cd foo - ./tests/setup/00-setup - juju bootstrap - ./tests/015-basic-trusty-icehouse - # make some changes, run tests again - ./tests/015-basic-trusty-icehouse - # make some changes, run tests again - ./tests/015-basic-trusty-icehouse - - * There may be test definitions in the tests/ dir which are not set +x - executable. This is generally true for deprecated releases, or for - upcoming releases which are not yet validated and enabled. To enable - and run these tests: - bzr branch lp:charms/trusty/foo - cd foo - ls tests - chmod +x tests/017-basic-trusty-kilo - ./tests/setup/00-setup - juju bootstrap - ./tests/017-basic-trusty-kilo - - -Additional notes: - - * Use DEBUG to turn on debug logging, use ERROR otherwise. - u = OpenStackAmuletUtils(ERROR) - u = OpenStackAmuletUtils(DEBUG) - - * To interact with the deployed environment: - export OS_USERNAME=admin - export OS_PASSWORD=openstack - export OS_TENANT_NAME=admin - export OS_REGION_NAME=RegionOne - export OS_AUTH_URL=${OS_AUTH_PROTOCOL:-http}://`juju-deployer -e trusty -f keystone`:5000/v2.0 - keystone user-list - glance image-list diff --git a/tests/README.md b/tests/README.md new file mode 100644 index 0000000..046be7f --- /dev/null +++ b/tests/README.md @@ -0,0 +1,9 @@ +# Overview + +This directory provides Amulet tests to verify basic deployment functionality +from the perspective of this charm, its requirements and its features, as +exercised in a subset of the full OpenStack deployment test bundle topology. + +For full details on functional testing of OpenStack charms please refer to +the [functional testing](http://docs.openstack.org/developer/charm-guide/testing.html#functional-testing) +section of the OpenStack Charm Guide. diff --git a/tests/basic_deployment.py b/tests/basic_deployment.py index f6d04b6..464143c 100644 --- a/tests/basic_deployment.py +++ b/tests/basic_deployment.py @@ -93,11 +93,11 @@ class SwiftStorageBasicDeployment(OpenStackAmuletDeployment): def _initialize_tests(self): """Perform final initialization before tests get run.""" # Access the sentries for inspecting service units - self.mysql_sentry = self.d.sentry.unit['mysql/0'] - self.keystone_sentry = self.d.sentry.unit['keystone/0'] - self.glance_sentry = self.d.sentry.unit['glance/0'] - self.swift_proxy_sentry = self.d.sentry.unit['swift-proxy/0'] - self.swift_storage_sentry = self.d.sentry.unit['swift-storage/0'] + self.mysql_sentry = self.d.sentry['mysql'][0] + self.keystone_sentry = self.d.sentry['keystone'][0] + self.glance_sentry = self.d.sentry['glance'][0] + self.swift_proxy_sentry = self.d.sentry['swift-proxy'][0] + self.swift_storage_sentry = self.d.sentry['swift-storage'][0] u.log.debug('openstack release val: {}'.format( self._get_openstack_release())) diff --git a/tests/014-basic-precise-icehouse b/tests/gate-basic-precise-icehouse similarity index 100% rename from tests/014-basic-precise-icehouse rename to tests/gate-basic-precise-icehouse diff --git a/tests/015-basic-trusty-icehouse b/tests/gate-basic-trusty-icehouse similarity index 100% rename from tests/015-basic-trusty-icehouse rename to tests/gate-basic-trusty-icehouse diff --git a/tests/017-basic-trusty-kilo b/tests/gate-basic-trusty-kilo similarity index 100% rename from tests/017-basic-trusty-kilo rename to tests/gate-basic-trusty-kilo diff --git a/tests/018-basic-trusty-liberty b/tests/gate-basic-trusty-liberty similarity index 100% rename from tests/018-basic-trusty-liberty rename to tests/gate-basic-trusty-liberty diff --git a/tests/019-basic-trusty-mitaka b/tests/gate-basic-trusty-mitaka similarity index 100% rename from tests/019-basic-trusty-mitaka rename to tests/gate-basic-trusty-mitaka diff --git a/tests/021-basic-xenial-mitaka b/tests/gate-basic-xenial-mitaka similarity index 100% rename from tests/021-basic-xenial-mitaka rename to tests/gate-basic-xenial-mitaka diff --git a/tests/tests.yaml b/tests/tests.yaml index 4d17631..e3185c6 100644 --- a/tests/tests.yaml +++ b/tests/tests.yaml @@ -1,21 +1,17 @@ -bootstrap: true -reset: false -virtualenv: true -makefile: - - lint - - test -sources: - - ppa:juju/stable -packages: - - amulet - - distro-info-data - - python-ceilometerclient - - python-cinderclient - - python-distro-info - - python-glanceclient - - python-heatclient - - python-keystoneclient - - python-neutronclient - - python-novaclient - - python-pika - - python-swiftclient +# Bootstrap the model if necessary. +bootstrap: True +# Re-use bootstrap node instead of destroying/re-bootstrapping. +reset: True +# Use tox/requirements to drive the venv instead of bundletester's venv feature. +virtualenv: False +# Leave makefile empty, otherwise unit/lint tests will rerun ahead of amulet. +makefile: [] +# Do not specify juju PPA sources. Juju is presumed to be pre-installed +# and configured in all test runner environments. +#sources: +# Do not specify or rely on system packages. +#packages: +# Do not specify python packages here. Use test-requirements.txt +# and tox instead. ie. The venv is constructed before bundletester +# is invoked. +#python-packages: diff --git a/tox.ini b/tox.ini index b044cc2..593a222 100644 --- a/tox.ini +++ b/tox.ini @@ -5,6 +5,8 @@ skipsdist = True [testenv] setenv = VIRTUAL_ENV={envdir} PYTHONHASHSEED=0 + AMULET_SETUP_TIMEOUT=2700 +passenv = HOME TERM AMULET_* install_command = pip install --allow-unverified python-apt {opts} {packages} commands = ostestr {posargs} @@ -24,6 +26,50 @@ commands = flake8 {posargs} hooks unit_tests tests actions lib [testenv:venv] commands = {posargs} +[testenv:func27-noop] +# DRY RUN - For Debug +basepython = python2.7 +deps = -r{toxinidir}/requirements.txt + -r{toxinidir}/test-requirements.txt +commands = + bundletester -vl DEBUG -r json -o func-results.json --test-pattern "gate-*" -n --no-destroy + +[testenv:func27] +# Charm Functional Test +# Run all gate tests which are +x (expected to always pass) +basepython = python2.7 +deps = -r{toxinidir}/requirements.txt + -r{toxinidir}/test-requirements.txt +commands = + bundletester -vl DEBUG -r json -o func-results.json --test-pattern "gate-*" --no-destroy + +[testenv:func27-smoke] +# Charm Functional Test +# Run a specific test as an Amulet smoke test (expected to always pass) +basepython = python2.7 +deps = -r{toxinidir}/requirements.txt + -r{toxinidir}/test-requirements.txt +commands = + bundletester -vl DEBUG -r json -o func-results.json gate-basic-xenial-mitaka --no-destroy + +[testenv:func27-dfs] +# Charm Functional Test +# Run all deploy-from-source tests which are +x (may not always pass!) +basepython = python2.7 +deps = -r{toxinidir}/requirements.txt + -r{toxinidir}/test-requirements.txt +commands = + bundletester -vl DEBUG -r json -o func-results.json --test-pattern "dfs-*" --no-destroy + +[testenv:func27-dev] +# Charm Functional Test +# Run all development test targets which are +x (may not always pass!) +basepython = python2.7 +deps = -r{toxinidir}/requirements.txt + -r{toxinidir}/test-requirements.txt +commands = + bundletester -vl DEBUG -r json -o func-results.json --test-pattern "dev-*" --no-destroy + [flake8] ignore = E402,E226 exclude = hooks/charmhelpers