# -*- coding: utf-8 -*- # Import Python libs from __future__ import absolute_import import random import string # Import Salt Testing libs from tests.support.mixins import LoaderModuleMockMixin from tests.support.unit import skipIf, TestCase from tests.support.mock import NO_MOCK, NO_MOCK_REASON, patch # Import Salt libs import salt.config import salt.loader import salt.utils.boto from salt.ext import six from salt.utils.versions import LooseVersion import salt.states.boto_vpc as boto_vpc # Import test suite libs # pylint: disable=import-error,unused-import from tests.unit.modules.test_boto_vpc import BotoVpcTestCaseMixin # Import 3rd-party libs from salt.ext.six.moves import range # pylint: disable=import-error,redefined-builtin try: import boto import boto3 from boto.exception import BotoServerError HAS_BOTO = True except ImportError: HAS_BOTO = False try: from moto import mock_ec2_deprecated HAS_MOTO = True except ImportError: HAS_MOTO = False def mock_ec2_deprecated(self): ''' if the mock_ec2_deprecated function is not available due to import failure this replaces the decorated function with stub_function. Allows boto_vpc unit tests to use the @mock_ec2_deprecated decorator without a "NameError: name 'mock_ec2_deprecated' is not defined" error. ''' def stub_function(self): pass return stub_function # pylint: enable=import-error,unused-import # the boto_vpc module relies on the connect_to_region() method # which was added in boto 2.8.0 # https://github.com/boto/boto/commit/33ac26b416fbb48a60602542b4ce15dcc7029f12 required_boto_version = '2.8.0' region = 'us-east-1' access_key = 'GKTADJGHEIQSXMKKRBJ08H' secret_key = 'askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs' conn_parameters = {'region': region, 'key': access_key, 'keyid': secret_key, 'profile': {}} cidr_block = '10.0.0.0/24' subnet_id = 'subnet-123456' dhcp_options_parameters = {'domain_name': 'example.com', 'domain_name_servers': ['1.2.3.4'], 'ntp_servers': ['5.6.7.8'], 'netbios_name_servers': ['10.0.0.1'], 'netbios_node_type': 2} network_acl_entry_parameters = ('fake', 100, -1, 'allow', cidr_block) dhcp_options_parameters.update(conn_parameters) def _has_required_boto(): ''' Returns True/False boolean depending on if Boto is installed and correct version. ''' if not HAS_BOTO: return False elif LooseVersion(boto.__version__) < LooseVersion(required_boto_version): return False else: return True class BotoVpcStateTestCaseBase(TestCase, LoaderModuleMockMixin): def setup_loader_modules(self): ctx = {} utils = salt.loader.utils(self.opts, whitelist=['boto', 'boto3'], context=ctx) serializers = salt.loader.serializers(self.opts) self.funcs = salt.loader.minion_mods(self.opts, context=ctx, utils=utils, whitelist=['boto_vpc', 'config']) self.salt_states = salt.loader.states(opts=self.opts, functions=self.funcs, utils=utils, whitelist=['boto_vpc'], serializers=serializers) return { boto_vpc: { '__opts__': self.opts, '__salt__': self.funcs, '__utils__': utils, '__states__': self.salt_states, '__serializers__': serializers, }, salt.utils.boto: {} } @classmethod def setUpClass(cls): cls.opts = salt.config.DEFAULT_MINION_OPTS cls.opts['grains'] = salt.loader.grains(cls.opts) @classmethod def tearDownClass(cls): del cls.opts def setUp(self): self.addCleanup(delattr, self, 'funcs') self.addCleanup(delattr, self, 'salt_states') # connections keep getting cached from prior tests, can't find the # correct context object to clear it. So randomize the cache key, to prevent any # cache hits conn_parameters['key'] = ''.join(random.choice(string.ascii_lowercase + string.digits) for _ in range(50)) @skipIf(NO_MOCK, NO_MOCK_REASON) @skipIf(HAS_BOTO is False, 'The boto module must be installed.') @skipIf(HAS_MOTO is False, 'The moto module must be installed.') @skipIf(_has_required_boto() is False, 'The boto module must be greater than' ' or equal to version {0}' .format(required_boto_version)) class BotoVpcTestCase(BotoVpcStateTestCaseBase, BotoVpcTestCaseMixin): ''' TestCase for salt.states.boto_vpc state.module ''' @mock_ec2_deprecated def test_present_when_vpc_does_not_exist(self): ''' Tests present on a VPC that does not exist. ''' with patch.dict(salt.utils.boto.__salt__, self.funcs): vpc_present_result = self.salt_states['boto_vpc.present']('test', cidr_block) self.assertTrue(vpc_present_result['result']) self.assertEqual(vpc_present_result['changes']['new']['vpc']['state'], 'available') @mock_ec2_deprecated def test_present_when_vpc_exists(self): vpc = self._create_vpc(name='test') vpc_present_result = self.salt_states['boto_vpc.present']('test', cidr_block) self.assertTrue(vpc_present_result['result']) self.assertEqual(vpc_present_result['changes'], {}) @mock_ec2_deprecated @skipIf(True, 'Disabled pending https://github.com/spulec/moto/issues/493') def test_present_with_failure(self): with patch('moto.ec2.models.VPCBackend.create_vpc', side_effect=BotoServerError(400, 'Mocked error')): vpc_present_result = self.salt_states['boto_vpc.present']('test', cidr_block) self.assertFalse(vpc_present_result['result']) self.assertTrue('Mocked error' in vpc_present_result['comment']) @mock_ec2_deprecated def test_absent_when_vpc_does_not_exist(self): ''' Tests absent on a VPC that does not exist. ''' with patch.dict(salt.utils.boto.__salt__, self.funcs): vpc_absent_result = self.salt_states['boto_vpc.absent']('test') self.assertTrue(vpc_absent_result['result']) self.assertEqual(vpc_absent_result['changes'], {}) @mock_ec2_deprecated def test_absent_when_vpc_exists(self): vpc = self._create_vpc(name='test') with patch.dict(salt.utils.boto.__salt__, self.funcs): vpc_absent_result = self.salt_states['boto_vpc.absent']('test') self.assertTrue(vpc_absent_result['result']) self.assertEqual(vpc_absent_result['changes']['new']['vpc'], None) @mock_ec2_deprecated @skipIf(True, 'Disabled pending https://github.com/spulec/moto/issues/493') def test_absent_with_failure(self): vpc = self._create_vpc(name='test') with patch('moto.ec2.models.VPCBackend.delete_vpc', side_effect=BotoServerError(400, 'Mocked error')): vpc_absent_result = self.salt_states['boto_vpc.absent']('test') self.assertFalse(vpc_absent_result['result']) self.assertTrue('Mocked error' in vpc_absent_result['comment']) class BotoVpcResourceTestCaseMixin(BotoVpcTestCaseMixin): resource_type = None backend_create = None backend_delete = None extra_kwargs = {} def _create_resource(self, vpc_id=None, name=None): _create = getattr(self, '_create_' + self.resource_type) _create(vpc_id=vpc_id, name=name, **self.extra_kwargs) @mock_ec2_deprecated def test_present_when_resource_does_not_exist(self): ''' Tests present on a resource that does not exist. ''' vpc = self._create_vpc(name='test') with patch.dict(salt.utils.boto.__salt__, self.funcs): resource_present_result = self.salt_states['boto_vpc.{0}_present'.format(self.resource_type)]( name='test', vpc_name='test', **self.extra_kwargs) self.assertTrue(resource_present_result['result']) exists = self.funcs['boto_vpc.resource_exists'](self.resource_type, 'test').get('exists') self.assertTrue(exists) @mock_ec2_deprecated def test_present_when_resource_exists(self): vpc = self._create_vpc(name='test') resource = self._create_resource(vpc_id=vpc.id, name='test') with patch.dict(salt.utils.boto.__salt__, self.funcs): resource_present_result = self.salt_states['boto_vpc.{0}_present'.format(self.resource_type)]( name='test', vpc_name='test', **self.extra_kwargs) self.assertTrue(resource_present_result['result']) self.assertEqual(resource_present_result['changes'], {}) @mock_ec2_deprecated @skipIf(True, 'Disabled pending https://github.com/spulec/moto/issues/493') def test_present_with_failure(self): vpc = self._create_vpc(name='test') with patch('moto.ec2.models.{0}'.format(self.backend_create), side_effect=BotoServerError(400, 'Mocked error')): resource_present_result = self.salt_states['boto_vpc.{0}_present'.format(self.resource_type)]( name='test', vpc_name='test', **self.extra_kwargs) self.assertFalse(resource_present_result['result']) self.assertTrue('Mocked error' in resource_present_result['comment']) @mock_ec2_deprecated def test_absent_when_resource_does_not_exist(self): ''' Tests absent on a resource that does not exist. ''' with patch.dict(salt.utils.boto.__salt__, self.funcs): resource_absent_result = self.salt_states['boto_vpc.{0}_absent'.format(self.resource_type)]('test') self.assertTrue(resource_absent_result['result']) self.assertEqual(resource_absent_result['changes'], {}) @mock_ec2_deprecated def test_absent_when_resource_exists(self): vpc = self._create_vpc(name='test') self._create_resource(vpc_id=vpc.id, name='test') with patch.dict(salt.utils.boto.__salt__, self.funcs): resource_absent_result = self.salt_states['boto_vpc.{0}_absent'.format(self.resource_type)]('test') self.assertTrue(resource_absent_result['result']) self.assertEqual(resource_absent_result['changes']['new'][self.resource_type], None) exists = self.funcs['boto_vpc.resource_exists'](self.resource_type, 'test').get('exists') self.assertFalse(exists) @mock_ec2_deprecated @skipIf(True, 'Disabled pending https://github.com/spulec/moto/issues/493') def test_absent_with_failure(self): vpc = self._create_vpc(name='test') self._create_resource(vpc_id=vpc.id, name='test') with patch('moto.ec2.models.{0}'.format(self.backend_delete), side_effect=BotoServerError(400, 'Mocked error')): resource_absent_result = self.salt_states['boto_vpc.{0}_absent'.format(self.resource_type)]('test') self.assertFalse(resource_absent_result['result']) self.assertTrue('Mocked error' in resource_absent_result['comment']) @skipIf(NO_MOCK, NO_MOCK_REASON) @skipIf(HAS_BOTO is False, 'The boto module must be installed.') @skipIf(HAS_MOTO is False, 'The moto module must be installed.') @skipIf(_has_required_boto() is False, 'The boto module must be greater than' ' or equal to version {0}' .format(required_boto_version)) class BotoVpcSubnetsTestCase(BotoVpcStateTestCaseBase, BotoVpcResourceTestCaseMixin): resource_type = 'subnet' backend_create = 'SubnetBackend.create_subnet' backend_delete = 'SubnetBackend.delete_subnet' extra_kwargs = {'cidr_block': cidr_block} @skipIf(NO_MOCK, NO_MOCK_REASON) @skipIf(HAS_BOTO is False, 'The boto module must be installed.') @skipIf(HAS_MOTO is False, 'The moto module must be installed.') @skipIf(_has_required_boto() is False, 'The boto module must be greater than' ' or equal to version {0}' .format(required_boto_version)) class BotoVpcInternetGatewayTestCase(BotoVpcStateTestCaseBase, BotoVpcResourceTestCaseMixin): resource_type = 'internet_gateway' backend_create = 'InternetGatewayBackend.create_internet_gateway' backend_delete = 'InternetGatewayBackend.delete_internet_gateway' @skipIf(NO_MOCK, NO_MOCK_REASON) @skipIf(six.PY3, 'Disabled for Python 3 due to upstream bugs: ' 'https://github.com/spulec/moto/issues/548 and ' 'https://github.com/gabrielfalcao/HTTPretty/issues/325') @skipIf(HAS_BOTO is False, 'The boto module must be installed.') @skipIf(HAS_MOTO is False, 'The moto module must be installed.') @skipIf(_has_required_boto() is False, 'The boto module must be greater than' ' or equal to version {0}' .format(required_boto_version)) class BotoVpcRouteTableTestCase(BotoVpcStateTestCaseBase, BotoVpcResourceTestCaseMixin): resource_type = 'route_table' backend_create = 'RouteTableBackend.create_route_table' backend_delete = 'RouteTableBackend.delete_route_table' @mock_ec2_deprecated def test_present_with_subnets(self): vpc = self._create_vpc(name='test') subnet1 = self._create_subnet(vpc_id=vpc.id, name='test1') subnet2 = self._create_subnet(vpc_id=vpc.id, name='test2') route_table_present_result = self.salt_states['boto_vpc.route_table_present']( name='test', vpc_name='test', subnet_names=['test1'], subnet_ids=[subnet2.id]) associations = route_table_present_result['changes']['new']['subnets_associations'] assoc_subnets = [x['subnet_id'] for x in associations] self.assertEqual(set(assoc_subnets), set([subnet1.id, subnet2.id])) route_table_present_result = self.salt_states['boto_vpc.route_table_present']( name='test', vpc_name='test', subnet_ids=[subnet2.id]) changes = route_table_present_result['changes'] old_subnets = [x['subnet_id'] for x in changes['old']['subnets_associations']] self.assertEqual(set(assoc_subnets), set(old_subnets)) new_subnets = changes['new']['subnets_associations'] self.assertEqual(new_subnets[0]['subnet_id'], subnet2.id) @mock_ec2_deprecated def test_present_with_routes(self): vpc = self._create_vpc(name='test') igw = self._create_internet_gateway(name='test', vpc_id=vpc.id) with patch.dict(salt.utils.boto.__salt__, self.funcs): route_table_present_result = self.salt_states['boto_vpc.route_table_present']( name='test', vpc_name='test', routes=[{'destination_cidr_block': '0.0.0.0/0', 'gateway_id': igw.id}, {'destination_cidr_block': '10.0.0.0/24', 'gateway_id': 'local'}]) routes = [x['gateway_id'] for x in route_table_present_result['changes']['new']['routes']] self.assertEqual(set(routes), set(['local', igw.id])) route_table_present_result = self.salt_states['boto_vpc.route_table_present']( name='test', vpc_name='test', routes=[{'destination_cidr_block': '10.0.0.0/24', 'gateway_id': 'local'}]) changes = route_table_present_result['changes'] old_routes = [x['gateway_id'] for x in changes['old']['routes']] self.assertEqual(set(routes), set(old_routes)) self.assertEqual(changes['new']['routes'][0]['gateway_id'], 'local')