Ring 的数据结构由三个顶层域构成，其中：

1. List of Devices，表示集群中设备的列表；
2. Partition Assignment List，表示partition到device的指派；
3. Partition Shift Value，表示计算数据hash的移位量。

1.List of Devices

　　设备列表在Ring类内部被称为devs。在设备列表中的每一项是带有以下键的字典：

　　　　　　　　　　　　　　　　　　　　　　                    表1：Devs键值说明

2.Partition Assignment List

　　用于存放每个replica与device间映射关系。在Ring类内部被称为_replica2part2dev_id，列表中含有replica数量(3)的array(‘I’)，array(‘I’)的长度等于ring的partition数量，在array(‘I’)中的每个值为List of Devices中的索引id。

3.Partition Shift Value

　　Partition Shift Value在Ring类内部称为_part_shift。该值用于转换一个MD5 hash值来计算对于该哈希值的数据所在的partition。使用hash值的前4个字节用于计算。例如，为了计算路径/account/container/object的虚节点，Python代码如下：

partition = unpack_from('>I',md5('/account/container/object').digest())[0] >> self._part_shift

　　其中>表示big-endian byte order，I表示长度为4 byte unsigned int

　　举例：我们以SAIO安装下的ring文件为例，使用python读取/etc/swift/object.ring.gz存放的数据，获得的是以devs、 part_shift、 replica2part2dev_id 为key的dict类数据，其中：

 devs=

[{'device': 'sdb1',

  'id': 0,

  'ip': '127.0.0.1',

  'meta': '',

  'port': 6010,

  'weight': 1.0,

  'zone': 1},

{'device': 'sdb2',

  'id': 1,

  'ip': '127.0.0.1',

  'meta': '',

  'port': 6020,

  'weight': 1.0,

  'zone': 2},

{'device': 'sdb3',

  'id': 2,

  'ip': '127.0.0.1',

  'meta': '',

  'port': 6030,

  'weight': 1.0,

  'zone': 3},

{'device': 'sdb4',

  'id': 3,

  'ip': '127.0.0.1',

  'meta': '',

  'port': 6040,

  'weight': 1.0,

  'zone': 4}]

 

part_shift=4

replica2part2dev_id=[array(‘I’, [3, 2...]) array(‘I’, [0, 1...]), array(‘I’, [1, 3...])]

构建Ring文件

　　假设我们配置了一个4个node组成的集群，分别为node0、node1、node2、node3，在这个集群中，我们为4个存储节点配置了2^18个partition，平均每个存储节点分配65536个partition。

　　需要使用swift-ring-bulider命令来构建ring文件，关于swift-ring-builder命令的详细用法，在shell下直接敲该命令即可获得提示。这里只涉及构建新Ring文件的方法，需要用到两个相关选项：

1. 构建相关的builder文件：swift-ring-builder <builder_file> create <part_power> <replicas><min_part_hours>
2. 添加node到builder文件：swift-ring-builder <builder_file> add  z<zone>-<ip>:<port>/<device_name>_<meta> <weight>

例如，该集群目前ring的配置如下：

swift-ring-builder account.builder create 18 3 1

swift-ring-builder account.builder add z1-192.168.1.50:6002/sdc 100

swift-ring-builder account.builder add z2-192.168.1.51:6002/sdc 100

swift-ring-builder account.builder add z3-192.168.1.52:6002/sdc 100

swift-ring-builder account.builder add z4-192.168.1.54:6002/sdc 100

swift-ring-builder account.builder rebalance

 

swift-ring-builder container.builder create 18 3 1

swift-ring-builder container.builder add z1-192.168.1.50:6001/sdc 100

swift-ring-builder container.builder add z2-192.168.1.51:6001/sdc 100

swift-ring-builder container.builder add z3-192.168.1.52:6001/sdc 100

swift-ring-builder container.builder add z4-192.168.1.54:6001/sdc 100

swift-ring-builder container.builder rebalance

 

swift-ring-builder object.builder create 18 3 1

swift-ring-builder object.builder add z1-192.168.1.50:6000/sdc 100

swift-ring-builder object.builder add z2-192.168.1.51:6000/sdc 100

swift-ring-builder object.builder add z3-192.168.1.52:6000/sdc 100

swift-ring-builder object.builder add z4-192.168.1.54:6000/sdc 100

swift-ring-builder object.builder rebalance

Ring的Rebalance机制

　　当集群中发生存储节点宕机、新增（删）存储节点、新增（删）zone等必须改变partition和node间的映射关系时，就需要对Ring文件进行更新，也就是在swift文档中见到的rebalance一词。

　　在基于原有的Ring来构造新Ring时，swift-ring-builder首先要重新计算每个设备所需的partition数量。然后，将需要重新分配的partition收集起来。取消分配给被移除设备上的partition并把这些partition添加到收集列表。从拥有比当前所需的partition数多的设备上随机地取消分配多出的partition并添加到收集列表中。最后，将收集列表中的partition使用与初始化分配时类似的方法重新分配。

　　在本地执行swift-ring-builder命令行来生成新的ring文件，然后把这些文件复制到集群的每个节点的/etc/swift目录中，所有需要使用ring的server进程会每15秒（默认值）检查一遍ring文件的修改时间mtime，如果发现和内存中的不一致，则重新加载ring文件到内存中去。

　　举例说明

　　现在再增加一台存储节点node4并作为zone5，使用相同权重的devcie。那么每个存储节点上的partition数是52428.8。需要从每台存储节点上随机地移除13107.2个partition到收集列表，然后再重新分配这些parttion到node4上。当有partition的replica被重分配时，重分配的时间将被记录。在RingBuilder类内使用min_part_hours来限制在规定时间内，同一个partition不会被移动两次。

　　由于收集用来重新分配的partition是基于随机的，rebalacne进程并不能一次就可以完美地重平衡ring。为了达到一个较为平衡的ring，rebalacne进程被重复执行直到接近完美(小于1%）或者当rebalacne的提升达不到最小值1%。

　　具体的操作如下，首先移除旧的ring文件：

rm -f account.builder account.ring.gz backups/account.builder backups/account.ring.gz

.......

　　然后，重新平衡ring文件：

swift-ring-builder account.builder create 18 3 1

swift-ring-builder account.builder add z1-192.168.1.50:6002/sdc 100

swift-ring-builder account.builder add z2-192.168.1.51:6002/sdc 100

swift-ring-builder account.builder add z3-192.168.1.52:6002/sdc 100

swift-ring-builder account.builder add z4-192.168.1.54:6002/sdc 100

swift-ring-builder account.builder add z5-192.168.1.53:6002/sdc 100

swift-ring-builder account.builder rebalance

 

swift-ring-builder container.builder create 18 3 1

swift-ring-builder container.builder add z1-192.168.1.50:6001/sdc 100

swift-ring-builder container.builder add z2-192.168.1.51:6001/sdc 100

swift-ring-builder container.builder add z3-192.168.1.52:6001/sdc 100

swift-ring-builder container.builder add z4-192.168.1.54:6001/sdc 100

swift-ring-builder container.builder add z5-192.168.1.53:6001/sdc 100

swift-ring-builder container.builder rebalance

 

swift-ring-builder object.builder create 18 3 1

swift-ring-builder object.builder add z1-192.168.1.50:6000/sdc 100

swift-ring-builder object.builder add z2-192.168.1.51:6000/sdc 100

swift-ring-builder object.builder add z3-192.168.1.52:6000/sdc 100

swift-ring-builder object.builder add z4-192.168.1.54:6000/sdc 100

swift-ring-builder object.builder add z5-192.168.1.53:6000/sdc 100

swift-ring-builder object.builder rebalance

　　最后，复制account.ring.gz、container.ring.gz、object.ring.gz到集群的各节点的/etc/swift目录下。这样我们就完成了Ring的重平衡(rebalance)。