跳转到: 导航, 搜索

自适应版本控制

Warning.svg 旧设计页面

此页面曾用于帮助设计 OpenStack 早期版本的一个特性。它可能已经被实现,也可能没有。因此,此页面可能不会更新,并且可能包含过时的信息。上次更新时间为 2015-01-09

对于 oslo.rpc 和 oslo.notify 来说,版本控制是一个棘手的问题。每当模式发生变化时,版本号就必须递增。如果我们忘记了,我们希望它能在代码审查中被发现,但可能会出现损坏的版本。也许我们可以使用自适应版本控制来解决这个问题?

注意:我不知道“自适应版本控制”是否是一种实际存在的概念,但这个表达方式在这里最符合我的意思。

对于 rpc 和通知,我们本质上是在创建一个字典负载并将其传递过去。希望另一端的人知道如何处理它。“哦,这是一个版本 7 的 Foo,我知道如何处理它。”

但关键在于字典负载。嵌套字典可以被展平,从而形成一个运行时模式

考虑这个通知

{
    u'_context_auth_token': u'3d8b13de1b7d499587dfc69b77dc09c2',
    u'_context_is_admin': True,
    u'_context_project_id': u'7c150a59fe714e6f9263774af9688f0e',
    u'_context_quota_class': None,
    u'_context_read_deleted': u'no',
    u'_context_remote_address': u'10.0.2.15',
    u'_context_request_id': u'req-d68b36e0-9233-467f-9afb-d81435d64d66',
    u'_context_roles': [u'admin'],
    u'_context_timestamp': u'2012-05-08T20:23:41.425105',
    u'_context_user_id': u'1e3ce043029547f1a61c1996d1a531a2',
    u'event_type': u'compute.instance.create.end',
    u'message_id': u'dae6f69c-00e0-41c0-b371-41ec3b7f4451',
    u'payload': {u'created_at': u'2012-05-08 20:23:41',
                 u'deleted_at': u'',
                 u'disk_gb': 0,
                 u'display_name': u'testme',
                 u'fixed_ips': [{u'address': u'10.0.0.2',
                                 u'floating_ips': [],
                                 u'meta': {},
                                 u'type': u'fixed',
                                 u'version': 4}],
                 u'image_ref_url': u'http://10.0.2.15:9292/images/UUID',
                 u'instance_id': u'9f9d01b9-4a58-4271-9e27-398b21ab20d1',
                 u'instance_type': u'm1.tiny',
                 u'instance_type_id': 2,
                 u'launched_at': u'2012-05-08 20:23:47.985999',
                 u'memory_mb': 512,
                 u'state': u'active',
                 u'state_description': u'',
                 u'tenant_id': u'7c150a59fe714e6f9263774af9688f0e',
                 u'user_id': u'1e3ce043029547f1a61c1996d1a531a2',
                 u'reservation_id': u'1e3ce043029547f1a61c1996d1a531a3',
                 u'vcpus': 1,
                 u'root_gb': 0,
                 u'ephemeral_gb': 0,
                 u'host': u'compute-host-name',
                 u'availability_zone': u'1e3ce043029547f1a61c1996d1a531a4',
                 u'os_type': u'linux?',
                 u'architecture': u'x86',
                 u'image_ref': u'UUID',
                 u'kernel_id': u'1e3ce043029547f1a61c1996d1a531a5',
                 u'ramdisk_id': u'1e3ce043029547f1a61c1996d1a531a6',
                 },
    u'priority': u'INFO',
    u'publisher_id': u'compute.vagrant-precise',
    u'timestamp': u'2012-05-08 20:23:48.028195',
}

如果我们去除值并将键展平,我们可以得到

[   u'_context_auth_token'[str]
    u'_context_is_admin'[bool]
    u'_context_project_id'[str]
    u'_context_quota_class'[str]
    u'_context_read_deleted'
    u'_context_remote_address'[str]
    u'_context_request_id'[str]
    u'_context_roles'[list]
    u'_context_timestamp'[str]
    u'_context_user_id'[str]
    u'event_type'[str]
    u'message_id'[str]
    u'payload.created_at'[str] 
    u'payload.deleted_at'[str]
    u'payload.disk_gb'[int]
    u'payload.display_name'[str]
    u'payload.fixed_ips'[list]
    u'payload.fixed_ips.address'[str]
    u'payload.fixed_ips.floating_ips'[str]
    u'payload.fixed_ips.meta'[str]
    u'payload.fixed_ips.type'[int]
    u'payload.fixed_ips.version'[int]
    u'payload.image_ref_url'[str]
    u'payload.instance_id'[str]
    u'payload.instance_type'[str]
    u'payload.instance_type_id'[int]
    u'payload.launched_at'[str]
    u'payload.memory_mb'[int]
    u'payload.state'[str]
    u'payload.state_description'[str]
    u'payload.tenant_id'[str]
    u'payload.user_id'[str]
    u'payload.reservation_id'[str]
    u'payload.vcpus'[int]
    u'payload.root_gb'[str]
    u'payload.ephemeral_gb'[int]
    u'payload.host'[str]
    u'payload.availability_zone'[str]
    u'payload.os_type'[str]
    u'payload.architecture'[str]
    u'payload.image_ref'[str]
    u'payload.kernel_id'[str]
    u'payload.ramdisk_id'[str]
    u'priority'[str]
    u'publisher_id'[str]
    u'timestamp'[str]
}

注意:如果嵌套字典中的数组不是同构的,则需要特别小心,但我们可以解决这个问题。

服务重启后,我们可以开始检查消息或通知,第一次看到新的消息时。

Adaptiveversioning.gif

我们将展平的模式(或者模式的哈希值)与数据库中上次看到该类型消息的条目进行比较。如果哈希值匹配,则保持相同的版本号。如果它们不同,则递增版本号并将新的版本号(以及展平的模式和新的哈希值)存储在数据库中。

我们只需要在第一次看到自重启以来从未见过消息时才执行此操作。

对于通知,我们将基于 event_type。对于 rpc,方法名称。

这意味着我们拥有模式随时间变化的数据库历史记录。

如果想更进一步,我们可以只存储从一个版本到下一个版本的差异,这将使查找更改更容易。