# vim: tabstop=4 shiftwidth=4 softtabstop=4 # # 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 # import os import util import verify import re import nose from nose.plugins.attrib import attr import unittest import json from heat.common import template_format @attr(speed='slow') @attr(tag=['func', 'wordpress', 'api', 'cfn', 'F17']) class CfnApiFunctionalTest(unittest.TestCase): ''' This test launches a wordpress stack then attempts to verify correct operation of all actions supported by the heat CFN API Note we use class-level fixtures to avoid setting up a new stack for every test method, we set up the stack once then do all the tests, this means all tests methods are performed on one class instance, instead of creating a new class for every method, which is the normal nose unittest.TestCase behavior. The nose docs are a bit vague on how to do this, but it seems that (setup|teardown)All works and they have to be classmethods. Contrary to the nose docs, the class can be a unittest.TestCase subclass ''' @classmethod def setupAll(cls): print "SETUPALL" template = 'WordPress_Single_Instance.template' stack_paramstr = ';'.join(['InstanceType=m1.xlarge', 'DBUsername=dbuser', 'DBPassword=' + os.environ['OS_PASSWORD']]) cls.logical_resource_name = 'WikiDatabase' cls.logical_resource_type = 'AWS::EC2::Instance' # Just to get the assert*() methods class CfnApiFunctions(unittest.TestCase): @unittest.skip('Not a real test case') def runTest(self): pass inst = CfnApiFunctions() cls.stack = util.Stack(inst, template, 'F17', 'x86_64', 'cfntools', stack_paramstr) cls.WikiDatabase = util.Instance(inst, cls.logical_resource_name) try: cls.stack.create() cls.WikiDatabase.wait_for_boot() cls.WikiDatabase.check_cfntools() cls.WikiDatabase.wait_for_provisioning() cls.logical_resource_status = "CREATE_COMPLETE" # Save some compiled regexes and strings for response validation cls.time_re = re.compile( "[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$") cls.description_re = re.compile( "^AWS CloudFormation Sample Template") cls.stack_status = "CREATE_COMPLETE" cls.stack_status_reason = "Stack successfully created" cls.stack_timeout = str(60) cls.stack_disable_rollback = "True" # Match the expected format for an instance's physical resource ID cls.phys_res_id_re = re.compile( "^[0-9a-z]*-[0-9a-z]*-[0-9a-z]*-[0-9a-z]*-[0-9a-z]*$") except: cls.stack.cleanup() raise @classmethod def teardownAll(cls): print "TEARDOWNALL" cls.stack.cleanup() def test_instance(self): # ensure wordpress was installed by checking for expected # configuration file over ssh # This is the same as the standard wordress template test # but we still do it to prove the stack is OK self.assertTrue(self.WikiDatabase.file_present ('/etc/wordpress/wp-config.php')) print "Wordpress installation detected" # Verify the output URL parses as expected, ie check that # the wordpress installation is operational stack_url = self.stack.get_stack_output("WebsiteURL") print "Got stack output WebsiteURL=%s, verifying" % stack_url ver = verify.VerifyStack() self.assertTrue(ver.verify_wordpress(stack_url)) def testListStacks(self): response = self.stack.heatclient.list_stacks() prefix = '/ListStacksResponse/ListStacksResult/StackSummaries/member' stack_id = self.stack.response_xml_item(response, prefix, "StackId") self.stack.check_stackid(stack_id) update_time = self.stack.response_xml_item(response, prefix, "LastUpdatedTime") self.assertTrue(self.time_re.match(update_time) != None) create_time = self.stack.response_xml_item(response, prefix, "CreationTime") self.assertTrue(self.time_re.match(create_time) != None) description = self.stack.response_xml_item(response, prefix, "TemplateDescription") self.assertTrue(self.description_re.match(description) != None) status_reason = self.stack.response_xml_item(response, prefix, "StackStatusReason") self.assertEqual(status_reason, self.stack_status_reason) stack_name = self.stack.response_xml_item(response, prefix, "StackName") self.assertEqual(stack_name, self.stack.stackname) stack_status = self.stack.response_xml_item(response, prefix, "StackStatus") self.assertEqual(stack_status, self.stack_status) print "ListStacks : OK" def testDescribeStacks(self): parameters = {} parameters['StackName'] = self.stack.stackname response = self.stack.heatclient.describe_stacks(**parameters) prefix = '/DescribeStacksResponse/DescribeStacksResult/Stacks/member' stack_id = self.stack.response_xml_item(response, prefix, "StackId") self.stack.check_stackid(stack_id) update_time = self.stack.response_xml_item(response, prefix, "LastUpdatedTime") self.assertTrue(self.time_re.match(update_time) != None) create_time = self.stack.response_xml_item(response, prefix, "CreationTime") self.assertTrue(self.time_re.match(create_time) != None) description = self.stack.response_xml_item(response, prefix, "Description") self.assertTrue(self.description_re.match(description) != None) status_reason = self.stack.response_xml_item(response, prefix, "StackStatusReason") self.assertEqual(status_reason, self.stack_status_reason) stack_name = self.stack.response_xml_item(response, prefix, "StackName") self.assertEqual(stack_name, self.stack.stackname) stack_status = self.stack.response_xml_item(response, prefix, "StackStatus") self.assertEqual(stack_status, self.stack_status) stack_timeout = self.stack.response_xml_item(response, prefix, "TimeoutInMinutes") self.assertEqual(stack_timeout, self.stack_timeout) disable_rollback = self.stack.response_xml_item(response, prefix, "DisableRollback") self.assertEqual(disable_rollback, self.stack_disable_rollback) # Create a dict to lookup the expected template parameters template_parameters = {'DBUsername': 'dbuser', 'LinuxDistribution': 'F17', 'InstanceType': 'm1.xlarge', 'DBRootPassword': 'admin', 'KeyName': self.stack.keyname, 'DBPassword': os.environ['OS_PASSWORD'], 'DBName': 'wordpress'} # We do a fully qualified xpath lookup to extract the paramter # value for each key, then check the extracted value param_prefix = prefix + "/Parameters/member" for key, value in template_parameters.iteritems(): lookup = '[ParameterKey="' + key + '" and ParameterValue="' +\ value + '"]' lookup_value = self.stack.response_xml_item(response, param_prefix + lookup, "ParameterValue") self.assertEqual(lookup_value, value) # Then to a similar lookup to verify the Outputs section expected_url = "http://" + self.WikiDatabase.ip + "/wordpress" outputs_prefix = prefix + "/Outputs/member" lookup = '[OutputKey="WebsiteURL" and OutputValue="' + expected_url +\ '" and Description="URL for Wordpress wiki"]' lookup_value = self.stack.response_xml_item(response, outputs_prefix + lookup, "OutputValue") self.assertEqual(lookup_value, expected_url) print "DescribeStacks : OK" def testDescribeStackEvents(self): parameters = {} parameters['StackName'] = self.stack.stackname response = self.stack.heatclient.list_stack_events(**parameters) prefix = '/DescribeStackEventsResponse/DescribeStackEventsResult/' +\ 'StackEvents/member[LogicalResourceId="' +\ self.logical_resource_name + '" and ResourceStatus="' +\ self.logical_resource_status + '"]' stack_id = self.stack.response_xml_item(response, prefix, "StackId") self.stack.check_stackid(stack_id) event_id = self.stack.response_xml_item(response, prefix, "EventId") self.assertTrue(re.match("[0-9]*$", event_id) != None) resource_status = self.stack.response_xml_item(response, prefix, "ResourceStatus") self.assertEqual(resource_status, self.logical_resource_status) resource_type = self.stack.response_xml_item(response, prefix, "ResourceType") self.assertEqual(resource_type, self.logical_resource_type) update_time = self.stack.response_xml_item(response, prefix, "Timestamp") self.assertTrue(self.time_re.match(update_time) != None) status_data = self.stack.response_xml_item(response, prefix, "ResourceStatusReason") self.assertEqual(status_data, "state changed") stack_name = self.stack.response_xml_item(response, prefix, "StackName") self.assertEqual(stack_name, self.stack.stackname) log_res_id = self.stack.response_xml_item(response, prefix, "LogicalResourceId") self.assertEqual(log_res_id, self.logical_resource_name) phys_res_id = self.stack.response_xml_item(response, prefix, "PhysicalResourceId") self.assertTrue(self.phys_res_id_re.match(phys_res_id) != None) # ResourceProperties format is defined as a string "blob" by AWS # we return JSON encoded properies, so decode and check one key prop_json = self.stack.response_xml_item(response, prefix, "ResourceProperties") self.assertTrue(prop_json != None) prop = json.loads(prop_json) self.assertEqual(prop["InstanceType"], "m1.xlarge") print "DescribeStackEvents : OK" def testGetTemplate(self): parameters = {} parameters['StackName'] = self.stack.stackname response = self.stack.heatclient.get_template(**parameters) prefix = '/GetTemplateResponse/GetTemplateResult' # Extract the JSON TemplateBody and prove it parses template = self.stack.response_xml_item(response, prefix, "TemplateBody") json_load = template_format.parse(template) self.assertTrue(json_load != None) # Then sanity check content - I guess we could diff # with the template file but for now just check the # description looks sane.. description = json_load['Description'] self.assertTrue(self.description_re.match(description) != None) print "GetTemplate : OK" def testDescribeStackResource(self): parameters = {'StackName': self.stack.stackname, 'LogicalResourceId': self.logical_resource_name} response = self.stack.heatclient.describe_stack_resource(**parameters) prefix = '/DescribeStackResourceResponse/DescribeStackResourceResult'\ + '/StackResourceDetail' stack_id = self.stack.response_xml_item(response, prefix, "StackId") self.stack.check_stackid(stack_id) resource_status = self.stack.response_xml_item(response, prefix, "ResourceStatus") self.assertEqual(resource_status, self.logical_resource_status) resource_type = self.stack.response_xml_item(response, prefix, "ResourceType") self.assertEqual(resource_type, self.logical_resource_type) update_time = self.stack.response_xml_item(response, prefix, "LastUpdatedTimestamp") self.assertTrue(self.time_re.match(update_time) != None) status_reason = self.stack.response_xml_item(response, prefix, "ResourceStatusReason") self.assertEqual(status_reason, "state changed") stack_name = self.stack.response_xml_item(response, prefix, "StackName") self.assertEqual(stack_name, self.stack.stackname) log_res_id = self.stack.response_xml_item(response, prefix, "LogicalResourceId") self.assertEqual(log_res_id, self.logical_resource_name) phys_res_id = self.stack.response_xml_item(response, prefix, "PhysicalResourceId") self.assertTrue(self.phys_res_id_re.match(phys_res_id) != None) metadata = self.stack.response_xml_item(response, prefix, "Metadata") json_load = json.loads(metadata) self.assertTrue(json_load != None) self.assertTrue("AWS::CloudFormation::Init" in json_load) print "DescribeStackResource : OK" def testDescribeStackResources(self): parameters = {'NameOrPid': self.stack.stackname, 'LogicalResourceId': self.logical_resource_name} response = self.stack.heatclient.describe_stack_resources(**parameters) prefix = '/DescribeStackResourcesResponse/' +\ 'DescribeStackResourcesResult/StackResources/member' stack_id = self.stack.response_xml_item(response, prefix, "StackId") self.stack.check_stackid(stack_id) resource_status = self.stack.response_xml_item(response, prefix, "ResourceStatus") self.assertEqual(resource_status, self.logical_resource_status) resource_type = self.stack.response_xml_item(response, prefix, "ResourceType") self.assertEqual(resource_type, self.logical_resource_type) update_time = self.stack.response_xml_item(response, prefix, "Timestamp") self.assertTrue(self.time_re.match(update_time) != None) status_reason = self.stack.response_xml_item(response, prefix, "ResourceStatusReason") self.assertEqual(status_reason, "state changed") stack_name = self.stack.response_xml_item(response, prefix, "StackName") self.assertEqual(stack_name, self.stack.stackname) log_res_id = self.stack.response_xml_item(response, prefix, "LogicalResourceId") self.assertEqual(log_res_id, self.logical_resource_name) phys_res_id = self.stack.response_xml_item(response, prefix, "PhysicalResourceId") self.assertTrue(self.phys_res_id_re.match(phys_res_id) != None) print "DescribeStackResources : OK" def testListStackResources(self): parameters = {} parameters['StackName'] = self.stack.stackname response = self.stack.heatclient.list_stack_resources(**parameters) prefix = '/ListStackResourcesResponse/ListStackResourcesResult' +\ '/StackResourceSummaries/member' resource_status = self.stack.response_xml_item(response, prefix, "ResourceStatus") self.assertEqual(resource_status, self.logical_resource_status) status_reason = self.stack.response_xml_item(response, prefix, "ResourceStatusReason") self.assertEqual(status_reason, "state changed") update_time = self.stack.response_xml_item(response, prefix, "LastUpdatedTimestamp") self.assertTrue(self.time_re.match(update_time) != None) resource_type = self.stack.response_xml_item(response, prefix, "ResourceType") self.assertEqual(resource_type, self.logical_resource_type) log_res_id = self.stack.response_xml_item(response, prefix, "LogicalResourceId") self.assertEqual(log_res_id, self.logical_resource_name) phys_res_id = self.stack.response_xml_item(response, prefix, "PhysicalResourceId") self.assertTrue(self.phys_res_id_re.match(phys_res_id) != None) print "ListStackResources : OK" def testValidateTemplate(self): # Use stack.format_parameters to get the TemplateBody params = self.stack.format_parameters() val_params = {'TemplateBody': params['TemplateBody']} response = self.stack.heatclient.validate_template(**val_params) prefix = '/ValidateTemplateResponse/ValidateTemplateResult' +\ '/Parameters/member' # Check the response contains all the expected paramter keys templ_params = ['DBUsername', 'LinuxDistribution', 'InstanceType', 'DBRootPassword', 'KeyName', 'DBPassword', 'DBName'] for param in templ_params: lookup = '[ParameterKey="' + param + '"]' val = self.stack.response_xml_item(response, prefix + lookup, 'ParameterKey') self.assertEqual(param, val) print "ValidateTemplate : OK"