#!/usr/bin/env bash # Copyright 2016, Rackspace US, Inc. # # 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. # WARNING: # This file is use by all OpenStack-Ansible roles for testing purposes. # Any changes here will affect all OpenStack-Ansible role repositories # with immediate effect. # PURPOSE: # This script executes a test Ansible playbook for the purpose of # functionally testing the role. It supports a convergence test, # check mode and an idempotence test. ## Shell Opts ---------------------------------------------------------------- set -e ## Vars ---------------------------------------------------------------------- export TESTING_HOME=${TESTING_HOME:-$HOME} export WORKING_DIR=${WORKING_DIR:-$(pwd)} export ROLE_NAME=${ROLE_NAME:-''} export ANSIBLE_CALLBACK_WHITELIST="profile_tasks" export ANSIBLE_OVERRIDES=${ANSIBLE_OVERRIDES:-$WORKING_DIR/tests/$ROLE_NAME-overrides.yml} export ANSIBLE_PARAMETERS=${ANSIBLE_PARAMETERS:-""} export TEST_PLAYBOOK=${TEST_PLAYBOOK:-$WORKING_DIR/tests/test.yml} export TEST_CHECK_MODE=${TEST_CHECK_MODE:-false} export TEST_IDEMPOTENCE=${TEST_IDEMPOTENCE:-false} export COMMON_TESTS_PATH="${WORKING_DIR}/tests/common" echo "ANSIBLE_OVERRIDES: ${ANSIBLE_OVERRIDES}" echo "ANSIBLE_PARAMETERS: ${ANSIBLE_PARAMETERS}" echo "TEST_PLAYBOOK: ${TEST_PLAYBOOK}" echo "TEST_CHECK_MODE: ${TEST_CHECK_MODE}" echo "TEST_IDEMPOTENCE: ${TEST_IDEMPOTENCE}" ## Functions ----------------------------------------------------------------- function set_ansible_parameters { if [ -f "${ANSIBLE_OVERRIDES}" ]; then ANSIBLE_CLI_PARAMETERS="${ANSIBLE_PARAMETERS} -e @${ANSIBLE_OVERRIDES}" else ANSIBLE_CLI_PARAMETERS="${ANSIBLE_PARAMETERS}" fi } function setup_ara { # Don't do anything if ARA has already been set up [[ -L "${ANSIBLE_PLUGIN_DIR}/callback/ara" ]] && return 0 # Install ARA from source if running in ARA gate, otherwise install from PyPi if [[ -d "${TESTING_HOME}/git/openstack/ara" ]]; then pip install "${TESTING_HOME}/git/openstack/ara" elif [[ "${ZUUL_PROJECT}" == "openstack/ara" ]]; then pip install "${WORKING_DIR}" else pip install ara fi # Dynamically figure out the location of ARA (ex: py2 vs py3) ara_location=$(python -c "import os,ara; print(os.path.dirname(ara.__file__))") echo "Linking ${ANSIBLE_PLUGIN_DIR}/callback/ara to ${ara_location}/plugins/callbacks/" mkdir -p "${ANSIBLE_PLUGIN_DIR}/callback/ara" ln -sf "${ara_location}/plugins/callbacks" "${ANSIBLE_PLUGIN_DIR}/callback/ara/" } function execute_ansible_playbook { CMD_TO_EXECUTE="ansible-playbook ${TEST_PLAYBOOK} $@ ${ANSIBLE_CLI_PARAMETERS}" echo "Executing: ${CMD_TO_EXECUTE}" echo "With:" echo " ANSIBLE_INVENTORY: ${ANSIBLE_INVENTORY}" echo " ANSIBLE_LOG_PATH: ${ANSIBLE_LOG_PATH}" ${CMD_TO_EXECUTE} } function gate_job_exit_tasks { source "${COMMON_TESTS_PATH}/test-log-collect.sh" } ## Main ---------------------------------------------------------------------- # NOTE(mhayden): CentOS images in the gate have several slow mirrors enabled # by default. This step ensures that only the base, epel, and updates # repositories are enabled. if which yum &>/dev/null || which dnf &>/dev/null; then sudo yum-config-manager --disable \* sudo yum-config-manager --enable base sudo yum-config-manager --enable epel sudo yum-config-manager --enable updates fi # Ensure that the Ansible environment is properly prepared source "${COMMON_TESTS_PATH}/test-ansible-env-prep.sh" setup_ara # Set gate job exit traps, this is run regardless of exit state when the job finishes. trap gate_job_exit_tasks EXIT # Prepare the extra CLI parameters used in each execution set_ansible_parameters # If the test for check mode is enabled, then execute it if [ "${TEST_CHECK_MODE}" == "true" ]; then # Set the path for the output log export ANSIBLE_LOG_PATH="${ANSIBLE_LOG_DIR}/ansible-check.log" # Execute the test playbook in check mode execute_ansible_playbook --check fi # Set the path for the output log export ANSIBLE_LOG_PATH="${ANSIBLE_LOG_DIR}/ansible-execute.log" # Execute the test playbook execute_ansible_playbook # If the idempotence test is enabled, then execute the # playbook again and verify that nothing changed/failed # in the output log. if [ "${TEST_IDEMPOTENCE}" == "true" ]; then # Set the path for the output log export ANSIBLE_LOG_PATH="${ANSIBLE_LOG_DIR}/ansible-idempotence.log" # Execute the test playbook execute_ansible_playbook # Check the output log for changed/failed tasks if grep -q "changed=0.*failed=0" ${ANSIBLE_LOG_PATH}; then echo "Idempotence test: pass" else echo "Idempotence test: fail" exit 1 fi fi