Files
charm-interface-mysql-shared/unit_tests/test_requires.py
David Ames b2ed9aa73c Enable MySQL TLS
Enable passing the certificate authority on the relation in order to
enable TLS communication to the MySQL DB.

In order to enable MySQL to use TLS for client connections all that
is required is the CA certificate. A certificate and key may be used
for client certificate authentication. However, since almost all
deployments will not use certificate authentication, focusing on the CA as SSL
data complete makes sense.

Change-Id: I785afe7f64cb57caa857178d529e3cabdcf63517
2020-06-30 15:24:52 -07:00

304 lines
12 KiB
Python

# 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.
import unittest
import mock
import requires
_hook_args = {}
def mock_hook(*args, **kwargs):
def inner(f):
# remember what we were passed. Note that we can't actually determine
# the class we're attached to, as the decorator only gets the function.
_hook_args[f.__name__] = dict(args=args, kwargs=kwargs)
return f
return inner
class TestMySQLSharedRequires(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls._patched_hook = mock.patch('charms.reactive.hook', mock_hook)
cls._patched_hook_started = cls._patched_hook.start()
# force requires to rerun the mock_hook decorator:
# try except is Python2/Python3 compatibility as Python3 has moved
# reload to importlib.
try:
reload(requires)
except NameError:
import importlib
importlib.reload(requires)
@classmethod
def tearDownClass(cls):
cls._patched_hook.stop()
cls._patched_hook_started = None
cls._patched_hook = None
# and fix any breakage we did to the module
try:
reload(requires)
except NameError:
import importlib
importlib.reload(requires)
def setUp(self):
self._patches = {}
self._patches_start = {}
self._rel_ids = ["mysql-shared:3"]
self._remote_data = {}
self._local_data = {}
self._conversation = mock.MagicMock()
self._conversation.relation_ids = self._rel_ids
self._conversation.scope = requires.scopes.GLOBAL
self._conversation.get_remote.side_effect = self.get_fake_remote_data
self._conversation.get_local.side_effect = self.get_fake_local_data
# The Relation object
self.mysql_shared = requires.MySQLSharedRequires(
'mysql-shared', [self._conversation])
self.patch_mysql_shared('conversations', [self._conversation])
self.patch_mysql_shared('set_remote')
self.patch_mysql_shared('set_local')
self.patch_mysql_shared('set_state')
self.patch_mysql_shared('remove_state')
self.patch_mysql_shared('db_host', "10.5.0.21")
self.patch_mysql_shared('wait_timeout', 90)
def tearDown(self):
self.mysql_shared = None
for k, v in self._patches.items():
v.stop()
setattr(self, k, None)
self._patches = None
self._patches_start = None
def patch_mysql_shared(self, attr, return_value=None):
mocked = mock.patch.object(self.mysql_shared, attr)
self._patches[attr] = mocked
started = mocked.start()
started.return_value = return_value
self._patches_start[attr] = started
setattr(self, attr, started)
def get_fake_remote_data(self, key, default=None):
return self._remote_data.get(key) or default
def get_fake_local_data(self, key, default=None):
return self._local_data.get(key) or default
def test_registered_hooks(self):
# test that the hooks actually registered the relation expressions that
# are meaningful for this interface: this is to handle regressions.
# The keys are the function names that the hook attaches to.
hook_patterns = {
'joined': ('{requires:mysql-shared}-relation-joined',),
'changed': ('{requires:mysql-shared}-relation-changed',),
'departed': (
'{requires:mysql-shared}-relation-{broken,departed}',)}
for k, v in _hook_args.items():
self.assertEqual(hook_patterns[k], v['args'])
def test_changed_available(self):
self.patch_mysql_shared('unit_allowed_all_dbs', True)
self.patch_mysql_shared('base_data_complete', True)
self.patch_mysql_shared('access_network_data_complete', True)
self.patch_mysql_shared('ssl_data_complete', True)
_calls = [
mock.call("{relation_name}.available"),
mock.call("{relation_name}.available.access_network"),
mock.call("{relation_name}.available.ssl")]
self.mysql_shared.changed()
self.set_state.assert_has_calls(_calls)
def test_changed_not_available(self):
self.patch_mysql_shared('base_data_complete', False)
self.patch_mysql_shared('access_network_data_complete', False)
self.patch_mysql_shared('ssl_data_complete', False)
self.mysql_shared.changed()
self.set_state.assert_not_called()
def test_joined(self):
self.mysql_shared.joined()
self.set_state.assert_called_once_with('{relation_name}.connected')
def test_departed(self):
self.mysql_shared.departed()
_calls = [
mock.call("{relation_name}.available"),
mock.call("{relation_name}.available.access_network"),
mock.call("{relation_name}.available.ssl")]
self.remove_state.assert_has_calls(_calls)
def test_base_data_complete(self):
self._remote_data = {"password": "1234",
"allowed_units": "unit/1"}
assert self.mysql_shared.base_data_complete() is True
self.db_host.return_value = None
assert self.mysql_shared.base_data_complete() is False
def test_base_data_complete_prefixed(self):
self._local_data = {"prefixes": ["myprefix"]}
self._remote_data = {"myprefix_password": "1234",
"myprefix_allowed_units": "unit/1"}
assert self.mysql_shared.base_data_complete() is True
self.db_host.return_value = None
assert self.mysql_shared.base_data_complete() is False
def test_shared_db_data_complete_wait_timeout(self):
self._local_data = {"prefixes": ["myprefix"]}
self._remote_data = {"myprefix_password": "1234",
"myprefix_allowed_units": "unit/1"}
# Wait timeout is an optional value and should not affect data complete
self.wait_timeout.return_value = None
assert self.mysql_shared.base_data_complete() is True
self.wait_timeout.return_value = 90
assert self.mysql_shared.base_data_complete() is True
def test_base_data_incomplete(self):
assert self.mysql_shared.base_data_complete() is False
def test_access_network_data_incomplete(self):
self.patch_mysql_shared('access_network', "10.92.3.0/24")
assert self.mysql_shared.access_network_data_complete() is True
self.access_network.return_value = None
assert self.mysql_shared.access_network_data_complete() is False
def test_ssl_data_incomplete(self):
self.patch_mysql_shared('ssl_ca', "Certificate Authority")
self.patch_mysql_shared('ssl_cert', "somecert")
self.patch_mysql_shared('ssl_key', "somekey")
assert self.mysql_shared.ssl_data_complete() is True
self.ssl_ca.return_value = None
assert self.mysql_shared.ssl_data_complete() is False
def test_local_accessors(self):
_prefix = "myprefix"
_value = "value"
_tests = {
"database": self.mysql_shared.database,
"username": self.mysql_shared.username,
"hostname": self.mysql_shared.hostname}
# Not set
for key, test in _tests.items():
self.assertEqual(test(), None)
# Unprefixed
for key, test in _tests.items():
self._local_data = {key: _value}
self.assertEqual(test(), _value)
# Prefixed
self._local_data = {"prefixes": [_prefix]}
for key, test in _tests.items():
self._local_data["{}_{}".format(_prefix, key)] = _value
self.assertEqual(test(prefix=_prefix), _value)
def test_remote_accessors(self):
_prefix = "myprefix"
_value = "value"
_tests = {
"password": self.mysql_shared.password,
"allowed_units": self.mysql_shared.allowed_units}
# Not set
for key, test in _tests.items():
self.assertEqual(test(), None)
# Unprefixed
for key, test in _tests.items():
self._remote_data = {key: _value}
self.assertEqual(test(), _value)
# Prefixed
self._local_data = {"prefixes": [_prefix]}
for key, test in _tests.items():
self._remote_data = {"{}_{}".format(_prefix, key): _value}
self.assertEqual(test(prefix=_prefix), _value)
def test_configure(self):
_db = "db"
_user = "user"
_host = "host"
_prefix = None
self.mysql_shared.configure(_db, _user, _host, prefix=_prefix)
self.set_remote.assert_called_once_with(
database=_db, username=_user, hostname=_host)
self.set_local.assert_called_once_with(
database=_db, username=_user, hostname=_host)
def test_configure_prefixed(self):
self.patch_mysql_shared('set_prefix')
_db = "db"
_user = "user"
_host = "host"
_prefix = "prefix"
_expected = {
"{}_database".format(_prefix): _db,
"{}_username".format(_prefix): _user,
"{}_hostname".format(_prefix): _host}
self.mysql_shared.configure(_db, _user, _host, prefix=_prefix)
self.set_remote.assert_called_once_with(**_expected)
self.set_local.assert_called_once_with(**_expected)
self.set_prefix.assert_called_once()
def test_get_prefix(self):
_prefix = "prefix"
self._local_data = {"prefixes": [_prefix]}
self.assertEqual(
self.mysql_shared.get_prefixes(), [_prefix])
def test_set_prefix(self):
# First
_prefix = "prefix"
self.mysql_shared.set_prefix(_prefix)
self.set_local.assert_called_once_with("prefixes", [_prefix])
# More than one
self.set_local.reset_mock()
self._local_data = {"prefixes": [_prefix]}
_second = "secondprefix"
self.mysql_shared.set_prefix(_second)
self.set_local.assert_called_once_with("prefixes", [_prefix, _second])
@mock.patch.object(requires.hookenv, 'log')
@mock.patch.object(requires.hookenv, 'local_unit')
def test_unit_allowed_db(self, local_unit, log):
self._remote_data = {'allowed_units': 'unit/1 unit/3'}
local_unit.return_value = 'unit/1'
self.assertTrue(self.mysql_shared.unit_allowed_db())
local_unit.return_value = 'unit/2'
self.assertFalse(self.mysql_shared.unit_allowed_db())
@mock.patch.object(requires.hookenv, 'log')
@mock.patch.object(requires.hookenv, 'local_unit')
def test_unit_allowed_db_prefix(self, local_unit, log):
self._remote_data = {'bob_allowed_units': 'unit/1 unit/3'}
local_unit.return_value = 'unit/1'
self.assertTrue(self.mysql_shared.unit_allowed_db(prefix='bob'))
self.assertFalse(self.mysql_shared.unit_allowed_db())
self.assertFalse(self.mysql_shared.unit_allowed_db(prefix='flump'))
@mock.patch.object(requires.hookenv, 'log')
@mock.patch.object(requires.hookenv, 'local_unit')
def test_unit_allowed_all_dbs(self, local_unit, log):
local_unit.return_value = 'unit/1'
self._local_data = {"prefixes": ['prefix1', 'prefix2']}
self._remote_data = {'prefix1_allowed_units': 'unit/1 unit/3'}
self.assertFalse(self.mysql_shared.unit_allowed_all_dbs())
self._remote_data = {
'prefix1_allowed_units': 'unit/1 unit/3',
'prefix2_allowed_units': 'unit/1 unit/3'}
self.assertTrue(self.mysql_shared.unit_allowed_all_dbs())