mirror of
https://github.com/dragonflydb/dragonfly.git
synced 2024-12-14 11:58:02 +00:00
c7750b9d58
Example usage: ```bash # Create a 2-node cluster ./cluster_mgr.py --action=create --replicas_per_master=1 --num_master=2 # Move (no migration) all slots to first node ./cluster_mgr.py --action=move --target_port=7001 --slot_start=8192 --slot_end=16383 # Fill data - like run memtier # Migrate all slots to 2nd node. One could measure how long this step takes. ./cluster_mgr.py --action=migrate --target_port=7002 --slot_start=0 --slot_end=16383 ```
391 lines
12 KiB
Python
Executable file
391 lines
12 KiB
Python
Executable file
#!/usr/bin/env python3
|
|
import argparse
|
|
import json
|
|
import math
|
|
import redis
|
|
import subprocess
|
|
import time
|
|
|
|
"""
|
|
To install: pip install -r requirements.txt
|
|
"""
|
|
|
|
|
|
class Node:
|
|
def __init__(self, port):
|
|
self.id = ""
|
|
self.port = port
|
|
self.admin_port = port + 10_000
|
|
|
|
|
|
class Master:
|
|
def __init__(self, port):
|
|
self.node = Node(port)
|
|
self.replicas = []
|
|
|
|
|
|
def start_node(node, threads):
|
|
f = open(f"/tmp/dfly.cluster.node.{node.port}.log", "w")
|
|
print(f"- Log file for node {node.port}: {f.name}")
|
|
subprocess.Popen(
|
|
[
|
|
"../build-opt/dragonfly",
|
|
f"--port={node.port}",
|
|
f"--admin_port={node.admin_port}",
|
|
"--cluster_mode=yes",
|
|
f"--proactor_threads={threads}",
|
|
"--dbfilename=",
|
|
f"--logtostderr",
|
|
],
|
|
stderr=f,
|
|
)
|
|
|
|
|
|
def send_command(node, command):
|
|
client = redis.Redis(decode_responses=True, host="localhost", port=node.admin_port)
|
|
|
|
for i in range(0, 5):
|
|
try:
|
|
result = client.execute_command(*command)
|
|
client.close()
|
|
return result
|
|
except Exception as e:
|
|
print(e)
|
|
time.sleep(0.1 * i)
|
|
|
|
print(f"Unable to run command {command} against localhost:{node.admin_port} after 5 attempts!")
|
|
|
|
|
|
def update_id(node):
|
|
id = send_command(node, ["dflycluster", "myid"])
|
|
node.id = id
|
|
print(f"- ID for {node.port}: {id}")
|
|
|
|
|
|
def build_config_from_list(masters):
|
|
total_slots = 16384
|
|
slots_per_node = math.floor(total_slots / len(masters))
|
|
|
|
def build_node(node):
|
|
return {"id": node.id, "ip": "localhost", "port": node.port}
|
|
|
|
config = []
|
|
for i, master in enumerate(masters):
|
|
c = {
|
|
"slot_ranges": [{"start": i * slots_per_node, "end": (i + 1) * slots_per_node - 1}],
|
|
"master": build_node(master.node),
|
|
"replicas": [build_node(replica) for replica in master.replicas],
|
|
}
|
|
|
|
config.append(c)
|
|
|
|
config[-1]["slot_ranges"][-1]["end"] += total_slots % len(masters)
|
|
return config
|
|
|
|
|
|
def get_nodes_from_config(config):
|
|
nodes = []
|
|
for shard in config:
|
|
nodes.append(Node(shard["master"]["port"]))
|
|
for replica in shard["replicas"]:
|
|
nodes.append(Node(replica["port"]))
|
|
return nodes
|
|
|
|
|
|
def push_config(config):
|
|
def push_to_node(node, config):
|
|
config_str = json.dumps(config, indent=2)
|
|
response = send_command(node, ["dflycluster", "config", config_str])
|
|
print(f"- Push to {node.port}: {response}")
|
|
|
|
for node in get_nodes_from_config(config):
|
|
push_to_node(node, config)
|
|
|
|
|
|
def create(args):
|
|
print(f"Setting up a Dragonfly cluster:")
|
|
print(f"- Master nodes: {args.num_masters}")
|
|
print(f"- Ports: {args.first_port}...{args.first_port + args.num_masters - 1}")
|
|
print(f"- Replicas for each master: {args.replicas_per_master}")
|
|
print()
|
|
|
|
next_port = args.first_port
|
|
masters = []
|
|
for i in range(args.num_masters):
|
|
master = Master(next_port)
|
|
next_port += 1
|
|
for j in range(args.replicas_per_master):
|
|
replica = Node(next_port)
|
|
master.replicas.append(replica)
|
|
next_port += 1
|
|
masters.append(master)
|
|
|
|
nodes = []
|
|
for master in masters:
|
|
nodes.append(master.node)
|
|
for replica in master.replicas:
|
|
nodes.append(replica)
|
|
|
|
print("Starting nodes...")
|
|
for node in nodes:
|
|
start_node(node, args.threads)
|
|
print()
|
|
|
|
if args.replicas_per_master > 0:
|
|
print("Configuring replication...")
|
|
for master in masters:
|
|
for replica in master.replicas:
|
|
response = send_command(replica, ["replicaof", "localhost", master.node.port])
|
|
print(f"- {replica.port} replicating {master.node.port}: {response}")
|
|
print()
|
|
|
|
print(f"Getting IDs...")
|
|
for n in nodes:
|
|
update_id(n)
|
|
print()
|
|
|
|
config = build_config_from_list(masters)
|
|
print(f"Pushing config:\n{config}\n")
|
|
push_config(config)
|
|
print()
|
|
|
|
|
|
def build_config_from_existing(args):
|
|
def list_to_dict(l):
|
|
return {l[i]: l[i + 1] for i in range(0, len(l), 2)}
|
|
|
|
def build_node(node_list):
|
|
d = list_to_dict(node_list)
|
|
return {"id": d["id"], "ip": d["endpoint"], "port": d["port"]}
|
|
|
|
def build_slots(slot_list):
|
|
slots = []
|
|
for i in range(0, len(slot_list), 2):
|
|
slots.append({"start": slot_list[i], "end": slot_list[i + 1]})
|
|
return slots
|
|
|
|
client = redis.Redis(decode_responses=True, host="localhost", port=args.first_port)
|
|
existing = client.execute_command("cluster", "shards")
|
|
config = []
|
|
for shard_list in existing:
|
|
shard = list_to_dict(shard_list)
|
|
config.append(
|
|
{
|
|
"slot_ranges": build_slots(shard["slots"]),
|
|
"master": build_node(shard["nodes"][0]),
|
|
"replicas": [build_node(replica) for replica in shard["nodes"][1::]],
|
|
}
|
|
)
|
|
return config
|
|
|
|
|
|
def find_node(config, port):
|
|
new_owner = None
|
|
for shard in config:
|
|
if shard["master"]["port"] == port:
|
|
new_owner = shard
|
|
break
|
|
else:
|
|
print(f"Can't find master with port {port} (hint: use flag --target_port).")
|
|
exit(-1)
|
|
return new_owner
|
|
|
|
|
|
def move(args):
|
|
config = build_config_from_existing(args)
|
|
new_owner = find_node(config, args.target_port)
|
|
|
|
def remove_slot(slot, from_range, from_shard):
|
|
if from_range["start"] == slot:
|
|
from_range["start"] += 1
|
|
if from_range["start"] > from_range["end"]:
|
|
from_shard["slot_ranges"].remove(from_range)
|
|
elif from_range["end"] == slot:
|
|
from_range["end"] -= 1
|
|
if from_range["start"] > from_range["end"]:
|
|
from_shard["slot_ranges"].remove(from_range)
|
|
else:
|
|
assert (
|
|
slot > from_range["start"] and slot < from_range["end"]
|
|
), f'{slot} {from_range["start"]} {from_range["end"]}'
|
|
from_shard["slot_ranges"].append({"start": slot + 1, "end": from_range["end"]})
|
|
from_range["end"] = slot - 1
|
|
|
|
def add_slot(slot, to_shard):
|
|
for slot_range in to_shard["slot_ranges"]:
|
|
if slot == slot_range["start"] - 1:
|
|
slot_range["start"] -= 1
|
|
return
|
|
if slot == slot_range["end"] + 1:
|
|
slot_range["end"] += 1
|
|
return
|
|
to_shard["slot_ranges"].append({"start": slot, "end": slot})
|
|
|
|
def find_slot(slot, config):
|
|
for shard in config:
|
|
if shard == new_owner:
|
|
continue
|
|
for slot_range in shard["slot_ranges"]:
|
|
if slot >= slot_range["start"] and slot <= slot_range["end"]:
|
|
return shard, slot_range
|
|
return None, None
|
|
|
|
def pack(slot_ranges):
|
|
new_range = []
|
|
while True:
|
|
changed = False
|
|
new_range = []
|
|
slot_ranges.sort(key=lambda x: x["start"])
|
|
for i, slot_range in enumerate(slot_ranges):
|
|
added = False
|
|
for j in range(i):
|
|
prev_slot_range = slot_ranges[j]
|
|
if prev_slot_range["end"] + 1 == slot_range["start"]:
|
|
prev_slot_range["end"] = slot_range["end"]
|
|
changed = True
|
|
added = True
|
|
break
|
|
if not added:
|
|
new_range.append(slot_range)
|
|
slot_ranges = new_range
|
|
if not changed:
|
|
break
|
|
return new_range
|
|
|
|
for slot in range(args.slot_start, args.slot_end + 1):
|
|
shard, slot_range = find_slot(slot, config)
|
|
if shard == None:
|
|
continue
|
|
if shard == new_owner:
|
|
continue
|
|
remove_slot(slot, slot_range, shard)
|
|
add_slot(slot, new_owner)
|
|
|
|
for shard in config:
|
|
shard["slot_ranges"] = pack(shard["slot_ranges"])
|
|
|
|
print(f"Pushing new config:\n{json.dumps(config, indent=2)}\n")
|
|
push_config(config)
|
|
|
|
|
|
def migrate(args):
|
|
config = build_config_from_existing(args)
|
|
target = find_node(config, args.target_port)
|
|
target_node = Node(target["master"]["port"])
|
|
|
|
# Find source node
|
|
source = None
|
|
for node in config:
|
|
slots = node["slot_ranges"]
|
|
for slot in slots:
|
|
if slot["start"] >= args.slot_start and slot["end"] <= args.slot_end:
|
|
source = node
|
|
break
|
|
if source == None:
|
|
print("Unsupported slot range migration (currently only 1-node migration supported)")
|
|
exit(-1)
|
|
source_node = Node(source["master"]["port"])
|
|
|
|
# do migration
|
|
sync_id = send_command(
|
|
target_node,
|
|
[
|
|
"DFLYCLUSTER",
|
|
"START-SLOT-MIGRATION",
|
|
"127.0.0.1",
|
|
source["master"]["port"] + 10_000,
|
|
args.slot_start,
|
|
args.slot_end,
|
|
],
|
|
)
|
|
|
|
# wait for migration finish
|
|
sync_status = []
|
|
while True:
|
|
sync_status = send_command(target_node, ["DFLYCLUSTER", "SLOT-MIGRATION-STATUS"])
|
|
assert len(sync_status) == 1
|
|
if sync_status[0].endswith("STABLE_SYNC"):
|
|
break
|
|
|
|
print("Reached stable sync: ", sync_status)
|
|
res = send_command(source_node, ["DFLYCLUSTER", "SLOT-MIGRATION-FINALIZE", sync_id])
|
|
assert res == "OK"
|
|
|
|
# Push new config to all nodes
|
|
move(args)
|
|
|
|
|
|
def print_config(args):
|
|
config = build_config_from_existing(args)
|
|
print(json.dumps(config, indent=2))
|
|
|
|
|
|
def shutdown(args):
|
|
config = build_config_from_existing(args)
|
|
for node in get_nodes_from_config(config):
|
|
send_command(node, ["shutdown"])
|
|
|
|
|
|
def main():
|
|
parser = argparse.ArgumentParser(
|
|
description="""
|
|
Local Cluster Manager
|
|
|
|
Example usage:
|
|
|
|
Create a 3+3 nodes cluster:
|
|
./cluster_mgr.py --action=create --num_masters=3 --replicas_per_master=1
|
|
|
|
Connect to cluster and print current config:
|
|
./cluster_mgr.py --action=print
|
|
|
|
Connect to cluster and shutdown all nodes:
|
|
./cluster_mgr.py --action=shutdown
|
|
|
|
Connect to cluster and move slots 10-20 to master with port 7002:
|
|
./cluster_mgr.py --action=move --slot_start=10 --slot_end=20 --new_owner=7002
|
|
|
|
Migrate slots 10-20 to master with port 7002
|
|
./cluster_mgr.py --action=migrate --slot_start=10 --slot_end=20 --new_owner=7002
|
|
"""
|
|
)
|
|
parser.add_argument(
|
|
"--action",
|
|
default="",
|
|
help="Which action to take? create: start a new instance, move=move slots",
|
|
)
|
|
parser.add_argument(
|
|
"--num_masters", type=int, default=3, help="Number of master nodes in cluster"
|
|
)
|
|
parser.add_argument(
|
|
"--replicas_per_master", type=int, default=0, help="How many replicas for each master"
|
|
)
|
|
parser.add_argument("--first_port", type=int, default=7001, help="First master's port")
|
|
parser.add_argument("--threads", type=int, default=2, help="Threads per node")
|
|
parser.add_argument("--slot_start", type=int, default=0, help="First slot to move (inclusive)")
|
|
parser.add_argument("--slot_end", type=int, default=100, help="Last slot to move (inclusive)")
|
|
parser.add_argument(
|
|
"--target_port",
|
|
type=int,
|
|
default=0,
|
|
help="Master port to take ownership over slots in range " "[--slot_start, --slot_end]",
|
|
)
|
|
args = parser.parse_args()
|
|
|
|
actions = {
|
|
"create": create,
|
|
"shutdown": shutdown,
|
|
"move": move,
|
|
"print": print_config,
|
|
"migrate": migrate,
|
|
}
|
|
action = actions.get(args.action.lower())
|
|
if action:
|
|
action(args)
|
|
else:
|
|
print(f'Error - unknown action "{args.action}"')
|
|
exit(-1)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|