class StateReplicator(SDWatchdogTask):
"""
StateReplicator periodically fetches all configured state from Redis,
reporting any updates to the Orchestrator State service.
"""
def __init__(self, service: MagmaService,
grpc_client_manager: GRPCClientManager):
super().__init__(DEFAULT_SYNC_INTERVAL, service.loop)
self._service = service
# In memory mapping of states to version
self._state_versions = {}
# Serdes for each type of state to replicate
self._serdes = {}
self._get_proto_redis_serdes()
self._get_json_redis_serdes()
self._redis_client = RedisFlatDict(get_default_client(), self._serdes)
# _grpc_client_manager to manage grpc client recyclings
self._grpc_client_manager = grpc_client_manager
# Flag to indicate if resync has completed successfully.
# Replication cannot proceed until this flag is True
self._has_resync_completed = False
def _get_proto_redis_serdes(self):
state_protos = self._service.config.get('state_protos', []) or []
for proto_cfg in state_protos:
is_invalid_cfg = 'proto_msg' not in proto_cfg or \
'proto_file' not in proto_cfg or \
'redis_key' not in proto_cfg or \
'state_scope' not in proto_cfg
if is_invalid_cfg:
logging.warning(
"Invalid proto config found in state_protos "
"configuration: %s", proto_cfg)
continue
try:
proto_module = importlib.import_module(proto_cfg['proto_file'])
msg = getattr(proto_module, proto_cfg['proto_msg'])
redis_key = proto_cfg['redis_key']
logging.info('Initializing RedisSerde for proto state %s',
proto_cfg['redis_key'])
serde = StateSerde(redis_key, get_proto_serializer(),
get_proto_deserializer(msg),
proto_cfg['state_scope'], PROTO_FORMAT)
self._serdes[redis_key] = serde
except (ImportError, AttributeError) as err:
logging.error(err)
def _get_json_redis_serdes(self):
json_state = self._service.config.get('json_state', []) or []
for json_cfg in json_state:
is_invalid_cfg = 'redis_key' not in json_cfg or \
'state_scope' not in json_cfg
if is_invalid_cfg:
logging.warning(
"Invalid json state config found in json_state"
"configuration: %s", json_cfg)
continue
logging.info('Initializing RedisSerde for json state %s',
json_cfg['redis_key'])
redis_key = json_cfg['redis_key']
serde = StateSerde(redis_key, get_json_serializer(),
get_json_deserializer(),
json_cfg['state_scope'], JSON_FORMAT)
self._serdes[redis_key] = serde
async def _run(self):
if not self._has_resync_completed:
try:
await self._resync()
except grpc.RpcError as err:
logging.error("GRPC call failed for initial state re-sync: %s",
err)
return
request = await self._collect_states_to_replicate()
if request is not None:
await self._send_to_state_service(request)
async def _resync(self):
states_to_sync = []
for key in self._redis_client:
try:
idval, state_type = self._parse_key(key)
except ValueError as err:
logging.debug(err)
continue
state_scope = self._serdes[state_type].state_scope
version = self._redis_client.get_version(idval, state_type)
device_id = self.make_scoped_device_id(idval, state_scope)
state_id = StateID(type=state_type, deviceID=device_id)
id_and_version = IDAndVersion(id=state_id, version=version)
states_to_sync.append(id_and_version)
if len(states_to_sync) == 0:
logging.debug("Not re-syncing state. No local state found.")
return
state_client = self._grpc_client_manager.get_client()
request = SyncStatesRequest(states=states_to_sync)
response = await grpc_async_wrapper(
state_client.SyncStates.future(
request,
DEFAULT_GRPC_TIMEOUT,
), self._loop)
unsynced_states = set()
for id_and_version in response.unsyncedStates:
unsynced_states.add(
(id_and_version.id.type, id_and_version.id.deviceID))
# Update in-memory map to add already synced states
for state in request.states:
in_mem_key = self.make_mem_key(state.id.deviceID, state.id.type)
if (state.id.type, state.id.deviceID) not in unsynced_states:
self._state_versions[in_mem_key] = state.version
self._has_resync_completed = True
logging.info("Successfully resynced state with Orchestrator!")
async def _collect_states_to_replicate(self):
states_to_report = []
for key in self._redis_client:
try:
idval, state_type = self._parse_key(key)
except ValueError as err:
logging.debug(err)
continue
state_scope = self._serdes[state_type].state_scope
device_id = self.make_scoped_device_id(idval, state_scope)
in_mem_key = self.make_mem_key(device_id, state_type)
redis_version = self._redis_client.get_version(idval, state_type)
if in_mem_key in self._state_versions and \
self._state_versions[in_mem_key] == redis_version:
continue
redis_state = self._redis_client.get(key)
if self._serdes[state_type].state_format == PROTO_FORMAT:
state_to_serialize = MessageToDict(redis_state)
else:
state_to_serialize = redis_state
serialized_json_state = json.dumps(state_to_serialize)
state_proto = State(type=state_type,
deviceID=device_id,
value=serialized_json_state.encode("utf-8"),
version=redis_version)
states_to_report.append(state_proto)
if len(states_to_report) == 0:
logging.debug("Not replicating state. No state has changed!")
return None
return ReportStatesRequest(states=states_to_report)
async def _send_to_state_service(self, request: ReportStatesRequest):
state_client = self._grpc_client_manager.get_client()
try:
response = await grpc_async_wrapper(
state_client.ReportStates.future(
request,
DEFAULT_GRPC_TIMEOUT,
), self._loop)
except grpc.RpcError as err:
logging.error("GRPC call failed for state replication: %s", err)
else:
unreplicated_states = set()
for idAndError in response.unreportedStates:
logging.warning("Failed to replicate state for (%s,%s): %s",
idAndError.type, idAndError.deviceID,
idAndError.error)
unreplicated_states.add((idAndError.type, idAndError.deviceID))
# Update in-memory map for successfully reported states
for state in request.states:
if (state.type, state.deviceID) in unreplicated_states:
continue
in_mem_key = self.make_mem_key(state.deviceID, state.type)
self._state_versions[in_mem_key] = state.version
logging.debug(
"Successfully replicated state for: "
"deviceID: %s,"
"type: %s, "
"version: %d", state.deviceID, state.type, state.version)
finally:
# reset timeout to config-specified + some buffer
self.set_timeout(self._interval * 2)
def _parse_key(self, key):
split_key = key.split(REDIS_KEY_DELIMITER, 1)
if len(split_key) != 2:
raise ValueError("Redis key: %s is not of format <id>:<<type>. "
"Not replicating." % key)
idval = split_key[0]
state_type = split_key[1]
if state_type not in self._serdes:
raise ValueError("No serde found for state type: %s. "
"Not replicating key: %s" % (state_type, idval))
return idval, state_type
@staticmethod
def make_mem_key(device_id, state_type):
"""
Create a key of the format <id>:<type>
"""
return device_id + ":" + state_type
@staticmethod
def make_scoped_device_id(id, scope):
"""
Create a deviceID of the format <id> for scope 'network'
Otherwise create a key of the format <hwid>:<id> for 'gateway' or
unrecognized scope.
"""
if scope == "network":
return id
else:
return snowflake.snowflake() + ":" + id
class RedisDictTests(TestCase):
"""
Tests for the RedisHashDict and RedisFlatDict containers
"""
@mock.patch("redis.Redis", MockRedis)
def setUp(self):
client = get_default_client()
# Use arbitrary orc8r proto to test with
self._hash_dict = RedisHashDict(client, "unittest",
get_proto_serializer(),
get_proto_deserializer(LogVerbosity))
serde = RedisSerde('log_verbosity', get_proto_serializer(),
get_proto_deserializer(LogVerbosity))
self._flat_dict = RedisFlatDict(client, serde)
@mock.patch("redis.Redis", MockRedis)
def test_hash_insert(self):
expected = LogVerbosity(verbosity=0)
expected2 = LogVerbosity(verbosity=1)
# insert proto
self._hash_dict['key1'] = expected
version = self._hash_dict.get_version("key1")
actual = self._hash_dict['key1']
self.assertEqual(1, version)
self.assertEqual(expected, actual)
# update proto
self._hash_dict['key1'] = expected2
version2 = self._hash_dict.get_version("key1")
actual2 = self._hash_dict['key1']
self.assertEqual(2, version2)
self.assertEqual(expected2, actual2)
@mock.patch("redis.Redis", MockRedis)
def test_missing_version(self):
missing_version = self._hash_dict.get_version("key2")
self.assertEqual(0, missing_version)
@mock.patch("redis.Redis", MockRedis)
def test_hash_delete(self):
expected = LogVerbosity(verbosity=2)
self._hash_dict['key3'] = expected
actual = self._hash_dict['key3']
self.assertEqual(expected, actual)
self._hash_dict.pop('key3')
self.assertRaises(KeyError, self._hash_dict.__getitem__, 'key3')
@mock.patch("redis.Redis", MockRedis)
def test_flat_insert(self):
expected = LogVerbosity(verbosity=5)
expected2 = LogVerbosity(verbosity=1)
# insert proto
self._flat_dict['key1'] = expected
version = self._flat_dict.get_version("key1")
actual = self._flat_dict['key1']
self.assertEqual(1, version)
self.assertEqual(expected, actual)
# update proto
self._flat_dict["key1"] = expected2
version2 = self._flat_dict.get_version("key1")
actual2 = self._flat_dict["key1"]
actual3 = self._flat_dict.get("key1")
self.assertEqual(2, version2)
self.assertEqual(expected2, actual2)
self.assertEqual(expected2, actual3)
@mock.patch("redis.Redis", MockRedis)
def test_flat_missing_version(self):
missing_version = self._flat_dict.get_version("key2")
self.assertEqual(0, missing_version)
@mock.patch("redis.Redis", MockRedis)
def test_flat_bad_key(self):
expected = LogVerbosity(verbosity=2)
self.assertRaises(ValueError, self._flat_dict.__setitem__, 'bad:key',
expected)
self.assertRaises(ValueError, self._flat_dict.__getitem__, 'bad:key')
self.assertRaises(ValueError, self._flat_dict.__delitem__, 'bad:key')
@mock.patch("redis.Redis", MockRedis)
def test_flat_delete(self):
expected = LogVerbosity(verbosity=2)
self._flat_dict['key3'] = expected
actual = self._flat_dict['key3']
self.assertEqual(expected, actual)
del self._flat_dict['key3']
self.assertRaises(KeyError, self._flat_dict.__getitem__, 'key3')
self.assertEqual(None, self._flat_dict.get('key3'))
@mock.patch("redis.Redis", MockRedis)
def test_flat_clear(self):
expected = LogVerbosity(verbosity=2)
self._flat_dict['key3'] = expected
actual = self._flat_dict['key3']
self.assertEqual(expected, actual)
self._flat_dict.clear()
self.assertEqual(0, len(self._flat_dict.keys()))
@mock.patch("redis.Redis", MockRedis)
def test_flat_garbage_methods(self):
expected = LogVerbosity(verbosity=2)
expected2 = LogVerbosity(verbosity=3)
key = "k1"
key2 = "k2"
bad_key = "bad_key"
self._flat_dict[key] = expected
self._flat_dict[key2] = expected2
self._flat_dict.mark_as_garbage(key)
is_garbage = self._flat_dict.is_garbage(key)
self.assertTrue(is_garbage)
is_garbage2 = self._flat_dict.is_garbage(key2)
self.assertFalse(is_garbage2)
self.assertEqual([key], self._flat_dict.garbage_keys())
self.assertEqual([key2], self._flat_dict.keys())
self.assertIsNone(self._flat_dict.get(key))
self.assertEqual(expected2, self._flat_dict.get(key2))
deleted = self._flat_dict.delete_garbage(key)
not_deleted = self._flat_dict.delete_garbage(key2)
self.assertTrue(deleted)
self.assertFalse(not_deleted)
self.assertIsNone(self._flat_dict.get(key))
self.assertEqual(expected2, self._flat_dict.get(key2))
with self.assertRaises(KeyError):
self._flat_dict.is_garbage(bad_key)
with self.assertRaises(KeyError):
self._flat_dict.mark_as_garbage(bad_key)
class RedisDictTests(TestCase):
"""
Tests for the RedisHashDict and RedisFlatDict containers
"""
@mock.patch("redis.Redis", MockRedis)
def setUp(self):
client = get_default_client()
# Use arbitrary orc8r proto to test with
self._hash_dict = RedisHashDict(
client,
"unittest",
get_proto_serializer(),
get_proto_deserializer(LogVerbosity))
serdes = {}
serdes['log_verbosity'] = RedisSerde('log_verbosity',
get_proto_serializer(),
get_proto_deserializer(LogVerbosity))
self._flat_dict = RedisFlatDict(client, serdes)
@mock.patch("redis.Redis", MockRedis)
def test_hash_insert(self):
expected = LogVerbosity(verbosity=0)
expected2 = LogVerbosity(verbosity=1)
# insert proto
self._hash_dict['key1'] = expected
version = self._hash_dict.get_version("key1")
actual = self._hash_dict['key1']
self.assertEqual(1, version)
self.assertEqual(expected, actual)
# update proto
self._hash_dict['key1'] = expected2
version2 = self._hash_dict.get_version("key1")
actual2 = self._hash_dict['key1']
self.assertEqual(2, version2)
self.assertEqual(expected2, actual2)
@mock.patch("redis.Redis", MockRedis)
def test_missing_version(self):
missing_version = self._hash_dict.get_version("key2")
self.assertEqual(0, missing_version)
@mock.patch("redis.Redis", MockRedis)
def test_hash_delete(self):
expected = LogVerbosity(verbosity=2)
self._hash_dict['key3'] = expected
actual = self._hash_dict['key3']
self.assertEqual(expected, actual)
self._hash_dict.pop('key3')
self.assertRaises(KeyError, self._hash_dict.__getitem__, 'key3')
@mock.patch("redis.Redis", MockRedis)
def test_flat_insert(self):
expected = LogVerbosity(verbosity=5)
expected2 = LogVerbosity(verbosity=1)
# insert proto
self._flat_dict['key1:log_verbosity'] = expected
version = self._flat_dict.get_version("key1", "log_verbosity")
actual = self._flat_dict['key1:log_verbosity']
self.assertEqual(1, version)
self.assertEqual(expected, actual)
# update proto
self._flat_dict["key1:log_verbosity"] = expected2
version2 = self._flat_dict.get_version("key1", "log_verbosity")
actual2 = self._flat_dict["key1:log_verbosity"]
self.assertEqual(2, version2)
self.assertEqual(expected2, actual2)
@mock.patch("redis.Redis", MockRedis)
def test_flat_missing_version(self):
missing_version = self._flat_dict.get_version("key2", "log_verbosity")
self.assertEqual(0, missing_version)
@mock.patch("redis.Redis", MockRedis)
def test_flat_invalid_key(self):
expected = LogVerbosity(verbosity=5)
self.assertRaises(ValueError, self._flat_dict.__setitem__, 'key3',
expected)
@mock.patch("redis.Redis", MockRedis)
def test_flat_invalid_serde(self):
expected = LogVerbosity(verbosity=5)
self.assertRaises(ValueError, self._flat_dict.__setitem__,
'key3:missing_serde', expected)
@mock.patch("redis.Redis", MockRedis)
def test_flat_delete(self):
expected = LogVerbosity(verbosity=2)
self._flat_dict['key3:log_verbosity'] = expected
actual = self._flat_dict['key3:log_verbosity']
self.assertEqual(expected, actual)
self._flat_dict.pop('key3:log_verbosity')
self.assertRaises(KeyError, self._flat_dict.__getitem__,
'key3:log_verbosity')