From f4bcae8b6bf4da4f603bdffad73836a99a65c3df Mon Sep 17 00:00:00 2001 From: James Page Date: Mon, 18 Jul 2016 14:45:05 +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: I77d4e53c792be5a9d101584568677f3ab6e3af8e --- Makefile | 3 +- test-requirements.txt | 14 +++ tests/016-basic-trusty-juno | 25 ---- tests/020-basic-wily-liberty | 23 ---- tests/051-basic-trusty-juno-git | 26 ---- tests/README | 113 ------------------ tests/README.md | 9 ++ tests/basic_deployment.py | 16 +-- ...icehouse-git => dfs-basic-trusty-icehouse} | 0 ...sty-kilo-git => dfs-basic-trusty-kilo-git} | 0 ...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/setup/00-setup | 17 --- tests/tests.yaml | 38 +++--- tox.ini | 44 +++++++ 19 files changed, 93 insertions(+), 235 deletions(-) delete mode 100755 tests/016-basic-trusty-juno delete mode 100755 tests/020-basic-wily-liberty delete mode 100755 tests/051-basic-trusty-juno-git delete mode 100644 tests/README create mode 100644 tests/README.md rename tests/{050-basic-trusty-icehouse-git => dfs-basic-trusty-icehouse} (100%) rename tests/{052-basic-trusty-kilo-git => dfs-basic-trusty-kilo-git} (100%) 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%) delete mode 100755 tests/setup/00-setup diff --git a/Makefile b/Makefile index 6ab9989a..553433de 100644 --- 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 4faf2545..06972943 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/016-basic-trusty-juno b/tests/016-basic-trusty-juno deleted file mode 100755 index 90df0f96..00000000 --- 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 neutron-api deployment on trusty-juno.""" - -from basic_deployment import NeutronAPIBasicDeployment - -if __name__ == '__main__': - deployment = NeutronAPIBasicDeployment(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 f18a02d7..00000000 --- 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 neutron-api deployment on wily-liberty.""" - -from basic_deployment import NeutronAPIBasicDeployment - -if __name__ == '__main__': - deployment = NeutronAPIBasicDeployment(series='wily') - deployment.run_tests() diff --git a/tests/051-basic-trusty-juno-git b/tests/051-basic-trusty-juno-git deleted file mode 100755 index 665b287b..00000000 --- a/tests/051-basic-trusty-juno-git +++ /dev/null @@ -1,26 +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 neutron-api git deployment on trusty-juno.""" - -from basic_deployment import NeutronAPIBasicDeployment - -if __name__ == '__main__': - deployment = NeutronAPIBasicDeployment(series='trusty', - openstack='cloud:trusty-juno', - source='cloud:trusty-updates/juno', - git=True) - deployment.run_tests() diff --git a/tests/README b/tests/README deleted file mode 100644 index 79c5b063..00000000 --- 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 00000000..046be7fb --- /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 5fcb8af3..a14045c1 100644 --- a/tests/basic_deployment.py +++ b/tests/basic_deployment.py @@ -177,14 +177,14 @@ class NeutronAPIBasicDeployment(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.rabbitmq_sentry = self.d.sentry.unit['rabbitmq-server/0'] - self.nova_cc_sentry = self.d.sentry.unit['nova-cloud-controller/0'] - self.neutron_gw_sentry = self.d.sentry.unit['neutron-gateway/0'] - self.neutron_api_sentry = self.d.sentry.unit['neutron-api/0'] - self.neutron_ovs_sentry = self.d.sentry.unit['neutron-openvswitch/0'] - self.nova_compute_sentry = self.d.sentry.unit['nova-compute/0'] + self.mysql_sentry = self.d.sentry['mysql'][0] + self.keystone_sentry = self.d.sentry['keystone'][0] + self.rabbitmq_sentry = self.d.sentry['rabbitmq-server'][0] + self.nova_cc_sentry = self.d.sentry['nova-cloud-controller'][0] + self.neutron_gw_sentry = self.d.sentry['neutron-gateway'][0] + self.neutron_api_sentry = self.d.sentry['neutron-api'][0] + self.neutron_ovs_sentry = self.d.sentry['neutron-openvswitch'][0] + self.nova_compute_sentry = self.d.sentry['nova-compute'][0] u.log.debug('openstack release val: {}'.format( self._get_openstack_release())) diff --git a/tests/050-basic-trusty-icehouse-git b/tests/dfs-basic-trusty-icehouse similarity index 100% rename from tests/050-basic-trusty-icehouse-git rename to tests/dfs-basic-trusty-icehouse diff --git a/tests/052-basic-trusty-kilo-git b/tests/dfs-basic-trusty-kilo-git similarity index 100% rename from tests/052-basic-trusty-kilo-git rename to tests/dfs-basic-trusty-kilo-git 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/setup/00-setup b/tests/setup/00-setup deleted file mode 100755 index 94e5611f..00000000 --- a/tests/setup/00-setup +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/bash - -set -ex - -sudo add-apt-repository --yes ppa:juju/stable -sudo apt-get update --yes -sudo apt-get install --yes amulet \ - distro-info-data \ - python-cinderclient \ - python-distro-info \ - python-glanceclient \ - python-heatclient \ - python-keystoneclient \ - python-neutronclient \ - python-novaclient \ - python-pika \ - python-swiftclient diff --git a/tests/tests.yaml b/tests/tests.yaml index 4d17631b..e3185c6d 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 c051dba5..efc5200e 100644 --- a/tox.ini +++ b/tox.ini @@ -24,6 +24,50 @@ commands = flake8 {posargs} hooks unit_tests tests actions [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