【RocketMQ】DLedger选主源码分析

RocketMQ 4.5版本之前,可以采用主从架构进行集群部署,但是如果master节点挂掉,不能自动在集群中选举出新的Master节点,需要人工介入,在4.5版本之后提供了DLedger模式,使用Raft算法,如果Master节点出现故障,可以自动选举出新的Master进行切换。

Raft协议

Raft是分布式系统中的一种共识算法,用于在集群中选举Leader管理集群。Raft协议中有以下角色:

Leader(领导者):集群中的领导者,负责管理集群。

Candidate(候选者):具有竞选Leader资格的角色,如果集群需要选举Leader,节点需要先转为候选者角色才可以发起竞选。

Follower(跟随者 ):Leader的跟随者,接收和处理来自Leader的消息,与Leader之间保持通信,如果通信超时或者其他原因导致节点与Leader之间通信失败,节点会认为集群中没有Leader,就会转为候选者发起竞选,推荐自己成为Leader。

Raft协议中还有一个Term(任期)的概念,任期是随着选举的举行而变化,一般是单调进行递增,比如说集群中当前的任期为1,此时某个节点发现集群中没有Leader,开始发起竞选,此时任期编号就会增加为2,表示进行了新一轮的选举。一般会为Term较大的那个节点进行投票,当某个节点收到了过半Quorum的投票数(一般是集群中的节点数/2 + 1),将会被选举为Leader。

DLedger选主源码分析

在Broker启动的时候,会判断是否开启了DLedger,如果开启会创建角色变更处理器DLedgerRoleChangeHandler, 然后获取CommitLog转为DLedgerCommitLog类型,并添加创建的角色变更处理器:

public class BrokerController {      public boolean initialize() throws CloneNotSupportedException {         result = result && this.consumerOffsetManager.load();         result = result && this.subscriptionGroupManager.load();         result = result && this.consumerFilterManager.load();         if (result) {             try {                 this.messageStore = new DefaultMessageStore(this.messageStoreConfig, this.brokerStatsManager, this.messageArrivingListener, this.brokerConfig);                 // 如果开启了DLeger                 if (messageStoreConfig.isEnableDLegerCommitLog()) {                     // 创建DLedgerRoleChangeHandler                     DLedgerRoleChangeHandler roleChangeHandler = new DLedgerRoleChangeHandler(this, (DefaultMessageStore) messageStore);                     // 获取CommitLog并转为DLedgerCommitLog类型,并添加角色变更处理器DLedgerRoleChangeHandler                     ((DLedgerCommitLog)((DefaultMessageStore) messageStore).getCommitLog()).getdLedgerServer().getdLedgerLeaderElector().addRoleChangeHandler(roleChangeHandler);                 }                 // ...             } catch (IOException e) {                 result = false;                 log.error("Failed to initialize", e);             }         }         // ...      } } 

DefaultMessageStore构造函数中可以看到,如果开启了DLedger,使用的是DLedgerCommitLog,所以上面可以将CommitLog转换为DLedgerCommitLog

public class DefaultMessageStore implements MessageStore {     public DefaultMessageStore(final MessageStoreConfig messageStoreConfig, final BrokerStatsManager brokerStatsManager,         //...         // 如果开启DLeger         if (messageStoreConfig.isEnableDLegerCommitLog()) {             this.commitLog = new DLedgerCommitLog(this); // 创建DLedgerCommitLog类型的CommitLog         } else {             this.commitLog = new CommitLog(this);         }         // ...     } } 

进入到DLedgerCommitLog,可以看到它引用了DLedgerServer,并在start方法中对其进行了启动,而在DLedgerServer中又启动了DLedgerLeaderElector进行Leader选举:

// DLedgerCommitLog public class DLedgerCommitLog extends CommitLog {     // DLedgerServer     private final DLedgerServer dLedgerServer;     @Override     public void start() {         // 启动DLedgerServer         dLedgerServer.startup();     } }  // DLedgerServer public class DLedgerServer implements DLedgerProtocolHander {     public void startup() {         this.dLedgerStore.startup();         this.dLedgerRpcService.startup();         this.dLedgerEntryPusher.startup();         // 启动Leader选择         this.dLedgerLeaderElector.startup();         this.executorService.scheduleAtFixedRate(this::checkPreferredLeader, 1000L, 1000L, TimeUnit.MILLISECONDS);     } } 

DLedgerLeaderElector中,引用了StateMaintainer,并在startup方法中启动了StateMaintainer,然后遍历RoleChangeHandler,调用其startup进行启动:

public class DLedgerLeaderElector {     // 实例化StateMaintainer     private StateMaintainer stateMaintainer = new StateMaintainer("StateMaintainer", logger);      public void startup() {         // 启动StateMaintainer         stateMaintainer.start();         // 遍历RoleChangeHandler         for (RoleChangeHandler roleChangeHandler : roleChangeHandlers) {             // 启动角色变更处理器             roleChangeHandler.startup();         }     } } 

StateMaintainerDLedgerLeaderElector的内部类,继承了ShutdownAbleThread,所以这里其实是开启了一个线程会不断执行doWork方法,在doWork方法中调用了maintainState方法维护状态:

public class DLedgerLeaderElector {    public class StateMaintainer extends ShutdownAbleThread {          @Override public void doWork() {             try {                 if (DLedgerLeaderElector.this.dLedgerConfig.isEnableLeaderElector()) {                     DLedgerLeaderElector.this.refreshIntervals(dLedgerConfig);                     // 维护状态                     DLedgerLeaderElector.this.maintainState();                 }                 // 睡眠10ms                 sleep(10);             } catch (Throwable t) {                 DLedgerLeaderElector.logger.error("Error in heartbeat", t);             }         }      } } 

maintainState方法中,可以看到对节点的角色进行了判断:

  1. 如果当前节点是Leader,调用maintainAsLeader方法处理;
  2. 如果当前节点是Follower,调用maintainAsFollower方法处理;
  3. 如果当前节点是Candidate,调用maintainAsCandidate方法处理;
public class DLedgerLeaderElector {    private void maintainState() throws Exception {         if (memberState.isLeader()) { // 如果是Leader             maintainAsLeader();         } else if (memberState.isFollower()) { // 如果是Follower             maintainAsFollower();         } else { // 如果是Candidate             maintainAsCandidate();         }     } } 

MemberState中可以看到role的值默认为CANDIDATE,所以初始状态下,各个节点的角色为CANDIDATE,接下来进入到maintainAsCandidate方法看下如何发起选举:

public class MemberState {     // 默认CANDIDATE角色     private volatile Role role = CANDIDATE; } 

Candidate发起竞选

needIncreaseTermImmediately:默认为false,为true时表示需要增加投票轮次Term的值,并立刻发起新一轮选举。

currTerm:当前选举的投票轮次。

LedgerEndIndex:当前记录的CommitLog日志的index。

LedgerEndTerm:Leader节点的投票轮次,也就是最近一次Leader选举成功时的那个Term,会记录在LedgerEndIndex中。

在Candidate候选者角色下可以选举Leader,发起选举的过程如下:

  1. 判断当时时间是否小于下一次投票开始时间并且needIncreaseTermImmediately为false,如果未到开始时间并且needIncreaseTermImmediately为false,直接返回,等待下一次投票;
  2. 校验当前角色是否是Candidate,如果不是直接返回;
  3. 由于Leader选举可能会失败,所以先判断上一次选举的结果,对以下两个条件进行判断,满足两个条件之一,会增加Terem的值,为新一轮竞选做准备,反之使用当前的Term即可:
    (1)如果是WAIT_TO_VOTE_NEXT状态,也就是等待下一次重新进行选举;
    (2)needIncreaseTermImmediately为true;
  4. 如果needIncreaseTermImmediately为true,需要重置其状态为false,并调用getNextTimeToRequestVote更新下一次发起选举的时间;
  5. 调用voteForQuorumResponses方法向其他节点发起投票请求;
  6. 处理投票结果,这里先省略,稍后再讲;
public class DLedgerLeaderElector {     private final MemberState memberState;      private void maintainAsCandidate() throws Exception {         // 判断当时时间是否小于下一次投票开始时间并且needIncreaseTermImmediately为false         if (System.currentTimeMillis() < nextTimeToRequestVote && !needIncreaseTermImmediately) {             return;         }         long term;         long ledgerEndTerm;         long ledgerEndIndex;         synchronized (memberState) {             // 如果不是Candidate直接返回             if (!memberState.isCandidate()) {                 return;             }             // 如果上一次选举Leader之后的结果是等待下一下重新进行选举或者如果需要立刻增加任期             if (lastParseResult == VoteResponse.ParseResult.WAIT_TO_VOTE_NEXT || needIncreaseTermImmediately) {                 long prevTerm = memberState.currTerm();                 term = memberState.nextTerm(); // 增加Term                 logger.info("{}_[INCREASE_TERM] from {} to {}", memberState.getSelfId(), prevTerm, term);                 lastParseResult = VoteResponse.ParseResult.WAIT_TO_REVOTE;             } else {                 // 使用获取当前的Term                 term = memberState.currTerm();             }             // 获取CommitLog日志的index             ledgerEndIndex = memberState.getLedgerEndIndex();             // 获取Leader的投票轮次             ledgerEndTerm = memberState.getLedgerEndTerm();         }         // 如果needIncreaseTermImmediately为true         if (needIncreaseTermImmediately) {             // 更新下次选举的时间             nextTimeToRequestVote = getNextTimeToRequestVote();             // 恢复needIncreaseTermImmediately的默认状态             needIncreaseTermImmediately = false;             return;         }         long startVoteTimeMs = System.currentTimeMillis();         // 发起投票请求         final List<CompletableFuture<VoteResponse>> quorumVoteResponses = voteForQuorumResponses(term, ledgerEndTerm, ledgerEndIndex);                 // 处理投票结果,先省略         // ...     } } 

nextTerm

nextTerm方法用于增加投票轮次Term的值,不过在增加之前会先判断当前节点维护的集群中已知的最大Term也就是knownMaxTermInGroup的值是否大于currTerm,如果是则使用knownMaxTermInGroup的值作为下一次投票的轮次,否则才对当前的TermcurrTerm做自增操作:

public class MemberState {     public synchronized long nextTerm() {         // 校验角色         PreConditions.check(role == CANDIDATE, DLedgerResponseCode.ILLEGAL_MEMBER_STATE, "%s != %s", role, CANDIDATE);         // 如果已知集群中最大的Term大于当前的Term,返回集群中最大的Term大         if (knownMaxTermInGroup > currTerm) {             currTerm = knownMaxTermInGroup;         } else {             // 否则对Term自增             ++currTerm;         }         currVoteFor = null;         persistTerm(); // 持久化         return currTerm;     } } 

getNextTimeToRequestVote

getNextTimeToRequestVote用于更新下次发起选举的时间,规则为:当前时间 + 300ms + 随机值(在最大和最小投票时间间隔之间也就是300-1000之间生成随机值)。

public class DLedgerLeaderElector {   // 最小投票时间间隔   private int minVoteIntervalMs = 300;   // 最大投票时间间隔   private int maxVoteIntervalMs = 1000;   private long getNextTimeToRequestVote() {         if (isTakingLeadership()) {             return System.currentTimeMillis() + dLedgerConfig.getMinTakeLeadershipVoteIntervalMs() +                 random.nextInt(dLedgerConfig.getMaxTakeLeadershipVoteIntervalMs() - dLedgerConfig.getMinTakeLeadershipVoteIntervalMs());         }         // 当前时间 + 300ms + 随机值(在最大和最小投票时间间隔之间也就是300-1000之间生成随机值)         return System.currentTimeMillis() + minVoteIntervalMs + random.nextInt(maxVoteIntervalMs - minVoteIntervalMs);   } } 

发送投票请求

voteForQuorumResponses方法中,对当前节点维护的集群中所有节点进行了遍历,向每一个节点发送投票请求:

  1. 构建VoteRequest投票请求;
  2. 设置组信息、LedgerEndIndex、LedgerEndTerm等信息;
  3. 设置Leader节点ID,也就是当前发起投票请求的节点的ID;
  4. 设置本次选举的Term信息;
  5. 设置请求目标节点的ID;
  6. 如果是当前节点自己,直接调用handleVote处理投票,否则调用dLedgerRpcService的vote方法发送投票请求;
public class DLedgerLeaderElector {    private List<CompletableFuture<VoteResponse>> voteForQuorumResponses(long term, long ledgerEndTerm,         long ledgerEndIndex) throws Exception {         List<CompletableFuture<VoteResponse>> responses = new ArrayList<>();         // 遍历节点         for (String id : memberState.getPeerMap().keySet()) {             // 构建投票请求             VoteRequest voteRequest = new VoteRequest();             // 设置组             voteRequest.setGroup(memberState.getGroup());             voteRequest.setLedgerEndIndex(ledgerEndIndex);             voteRequest.setLedgerEndTerm(ledgerEndTerm);             // 设置Leader节点ID             voteRequest.setLeaderId(memberState.getSelfId());             // 设置Term信息             voteRequest.setTerm(term);             // 设置目标节点的ID             voteRequest.setRemoteId(id);             CompletableFuture<VoteResponse> voteResponse;             // 如果是当前节点自己             if (memberState.getSelfId().equals(id)) {                 // 直接调用handleVote处理                 voteResponse = handleVote(voteRequest, true);             } else {                 // 发送请求                 voteResponse = dLedgerRpcService.vote(voteRequest);             }             responses.add(voteResponse);         }         return responses;     } } 

投票请求处理

其他节点收到投票请求后,对请求的处理在handleVote方法中:

  1. 判断发起投票的节点是否在当前节点的集群中,如果不在集群中,拒绝投票,返回状态为REJECT_UNKNOWN_LEADER
  2. 如果不是当前节点发起的请求,但是请求中携带的LeaderID与当前节点ID一致,拒绝投票,返回状态为REJECT_UNEXPECTED_LEADER
  3. 对比请求中的携带的LedgerEndTerm与当前节点记录的LedgerEndTerm
  • 小于:说明请求的LedgerEndTerm比较落后,拒绝投票REJECT_EXPIRED_LEDGER_TERM
  • 相等,但是LedgerEndIndex小于当前节点维护的LedgerEndIndex:说明发起请求的节点日志比较落后,拒绝投票,返回REJECT_SMALL_LEDGER_END_INDEX
  • 其他情况:继续下一步;
  1. 对比请求中的Term与当前节点的Term大小:

    • 小于:说明请求中的Term比较落后,拒绝投票返回状态为REJECT_EXPIRED_LEDGER_TERM
    • 相等:如果当前节点还未投票或者刚好投票给发起请求的节点,进入下一步;如果已经投票给某个Leader,拒绝投票返回REJECT_ALREADY_HAS_LEADER;除此之外其他情况返回REJECT_ALREADY_VOTED
    • 大于:说明当前节点的Term过小已经落后于最新的Term,调用changeRoleToCandidate方法将当前节点更改为Candidate角色,needIncreaseTermImmediately置为true,返回REJECT_TERM_NOT_READY表示当前节点还未准备好进行投票;

    调用changeRoleToCandidate方法时传入了请求中携带的Term的值,在方法内会与当前节点已知的最大Term的值knownMaxTermInGroup做对比,如果knownMaxTermInGroup比请求中的Term小,会更新为请求中的Term的值,在上面maintainAsCandidate方法中可以知道,如果needIncreaseTermImmediately`置为true,会调用nextTerm增加Term,nextTerm方法上面也提到过,这个方法中会判断knownMaxTermInGroup是否大于当前的Term如果是返回knownMaxTermInGroup的值,所以如果当前节点的Term落后于发起选举的Term,不能进行投票,需要在下次更新Term的值后,与发起Leader选举的Term一致时才可以投票;

  2. 如果请求中的TERM小于当前节点的LedgerEndTerm,拒绝投票,返回REJECT_TERM_SMALL_THAN_LEDGER

  3. 投票给发起请求的节点,设置CurrVoteFor的值为发起请求的节点ID,并返回ACCEPT接受投票状态

public CompletableFuture<VoteResponse> handleVote(VoteRequest request, boolean self) {         // 加锁         synchronized (memberState) {             // 判断发起投票的节点是否在当前节点的集群中             if (!memberState.isPeerMember(request.getLeaderId())) {                 logger.warn("[BUG] [HandleVote] remoteId={} is an unknown member", request.getLeaderId());                 return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.REJECT_UNKNOWN_LEADER));             }             // 如果不是当前节点发起的请求,但是请求中的LeaderID与当前节点一致             if (!self && memberState.getSelfId().equals(request.getLeaderId())) {                 logger.warn("[BUG] [HandleVote] selfId={} but remoteId={}", memberState.getSelfId(), request.getLeaderId());                 return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.REJECT_UNEXPECTED_LEADER));             }             // 如果请求中的LedgerEndTerm小于当前节点的LedgerEndTerm,说明请求的Term已过期             if (request.getLedgerEndTerm() < memberState.getLedgerEndTerm()) {                 // 返回REJECT_EXPIRED_LEDGER_TERM                 return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.REJECT_EXPIRED_LEDGER_TERM));             } else if (request.getLedgerEndTerm() == memberState.getLedgerEndTerm() && request.getLedgerEndIndex() < memberState.getLedgerEndIndex()) { // 如果LedgerEndTerm一致但是请求中的LedgerEndIndex小于当前节点的                 // 返回REJECT_SMALL_LEDGER_END_INDEX                 return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.REJECT_SMALL_LEDGER_END_INDEX));             }             // 如果请求中的TERM小于当前节点的Term             if (request.getTerm() < memberState.currTerm()) {                 // 拒绝投票                 return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.REJECT_EXPIRED_VOTE_TERM));             } else if (request.getTerm() == memberState.currTerm()) { // 如果请求中的TERM等于当前节点的Term                 if (memberState.currVoteFor() == null) { // 如果当前节点还未投票                     //let it go                 } else if (memberState.currVoteFor().equals(request.getLeaderId())) { // 如果当前节点刚好投票给发起请求的节点                     //repeat just let it go                 } else {                     if (memberState.getLeaderId() != null) { // 如果已经有Leader                         // 返回REJECT_ALREADY_HAS_LEADER,表示已投过票                         return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.REJECT_ALREADY_HAS_LEADER));                     } else { // 拒绝投票                         return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.REJECT_ALREADY_VOTED));                     }                 }             } else {                 // 走到这里表示请求中的Term大于当前节点记录的Term                 // 当前节点更改为Candidate角色                 changeRoleToCandidate(request.getTerm());                 // needIncreaseTermImmediately置为true,在下次执行时增加Term                 needIncreaseTermImmediately = true;                 // 返回REJECT_TERM_NOT_READY                 return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.REJECT_TERM_NOT_READY));             }             // 如果请求中的TERM小于当前节点的LedgerEndTerm             if (request.getTerm() < memberState.getLedgerEndTerm()) {                 return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.getLedgerEndTerm()).voteResult(VoteResponse.RESULT.REJECT_TERM_SMALL_THAN_LEDGER));             }             if (!self && isTakingLeadership() && request.getLedgerEndTerm() == memberState.getLedgerEndTerm() && memberState.getLedgerEndIndex() >= request.getLedgerEndIndex()) {                 return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.REJECT_TAKING_LEADERSHIP));             }             // 投票给发起请求的节点             memberState.setCurrVoteFor(request.getLeaderId());             // 返回ACCEPT接收投票的状态             return CompletableFuture.completedFuture(new VoteResponse(request).term(memberState.currTerm()).voteResult(VoteResponse.RESULT.ACCEPT));         }     } 

处理投票响应结果

回到maintainAsCandidate方法,继续看处理投票结果的部分,给集群中每个节点发起投票请求之后,会等待每个请求返回响应,并进行处理:

  1. ACCEPT:表示同意投票给当前节点,接受投票的节点数量acceptedNum加1;
  2. REJECT_ALREADY_VOTED或者REJECT_TAKING_LEADERSHIP:表示拒绝投票给当前节点;
  3. REJECT_ALREADY_HAS_LEADER:表示已经投票给了其他节点,alreadyHasLeader设置为true;
  4. REJECT_EXPIRED_VOTE_TERM:表示反映响应的节点的Term比当前节点的大,此时判断返回的Term是否大于当前节点记录的最大Term的值,如果是对knownMaxTermInGroup进行更新;
  5. REJECT_SMALL_LEDGER_END_INDEX:表示返回响应节点的LedgerEndIndex比当前节点的大,biggerLedgerNum加1;
  6. REJECT_TERM_NOT_READY:表示有节点还未准备好进行投票,notReadyTermNum加1;
public class DLedgerLeaderElector {     private void maintainAsCandidate() throws Exception {         // ...                  // 发起投票         final List<CompletableFuture<VoteResponse>> quorumVoteResponses = voteForQuorumResponses(term, ledgerEndTerm, ledgerEndIndex);         final AtomicLong knownMaxTermInGroup = new AtomicLong(term);         final AtomicInteger allNum = new AtomicInteger(0);         final AtomicInteger validNum = new AtomicInteger(0);         // 记录接受投票的节点个数         final AtomicInteger acceptedNum = new AtomicInteger(0);         final AtomicInteger notReadyTermNum = new AtomicInteger(0);         final AtomicInteger biggerLedgerNum = new AtomicInteger(0);         // 记录是否有节点投票给了其他节点         final AtomicBoolean alreadyHasLeader = new AtomicBoolean(false);          CountDownLatch voteLatch = new CountDownLatch(1);         // 处理投票响应结果         for (CompletableFuture<VoteResponse> future : quorumVoteResponses) {             future.whenComplete((VoteResponse x, Throwable ex) -> {                 try {                     if (ex != null) {                         throw ex;                     }                     logger.info("[{}][GetVoteResponse] {}", memberState.getSelfId(), JSON.toJSONString(x));                     if (x.getVoteResult() != VoteResponse.RESULT.UNKNOWN) {                         validNum.incrementAndGet();                     }                     synchronized (knownMaxTermInGroup) {                         switch (x.getVoteResult()) { // 判断投票结果                             case ACCEPT: // 如果接受投票                                 acceptedNum.incrementAndGet();                                 break;                             case REJECT_ALREADY_VOTED: // 拒绝投票                             case REJECT_TAKING_LEADERSHIP:                                 break;                             case REJECT_ALREADY_HAS_LEADER: // 如果已经投票了其他节点                                 alreadyHasLeader.compareAndSet(false, true);                                 break;                             case REJECT_TERM_SMALL_THAN_LEDGER:                             case REJECT_EXPIRED_VOTE_TERM: // 如果响应中的Term大于当前节点发送请求时的Term                                 // 判断响应中的Term是否大于当前节点已知的最大Term                                 if (x.getTerm() > knownMaxTermInGroup.get()) {                                      knownMaxTermInGroup.set(x.getTerm()); // 进行更新                                 }                                 break;                             case REJECT_EXPIRED_LEDGER_TERM:                             case REJECT_SMALL_LEDGER_END_INDEX:// 如果返回响应节点的LedgerEndIndex比当前节点的大                                 biggerLedgerNum.incrementAndGet();                                 break;                             case REJECT_TERM_NOT_READY: // 如果还未准备好                                 notReadyTermNum.incrementAndGet();                                 break;                             default:                                 break;                         }                     }                     if (alreadyHasLeader.get()                         || memberState.isQuorum(acceptedNum.get())                         || memberState.isQuorum(acceptedNum.get() + notReadyTermNum.get())) {                         voteLatch.countDown();                     }                 } catch (Throwable t) {                     logger.error("vote response failed", t);                 } finally {                     allNum.incrementAndGet();                     if (allNum.get() == memberState.peerSize()) {                         voteLatch.countDown();                     }                 }             });          }         // 判断投票结果,先省略....     } } 

经过以上处理,等待(2000 + 一个随机数)毫秒之后,接下来判断本次选举是否成功:

  1. 如果其他节点返回的响应中有比当前节点的Term大的,说明本次选举的Term已经落后其他节点,使用请求中返回的较大的那个Term作为下次竞选的Term,并计算下次发起选举的时间,等待下一次进行选举,对应状态为WAIT_TO_VOTE_NEXT
  2. 如果有节点已经投票给了其他节点,说明有其他节点在竞争Leader,需要等待下一次进行选举,对应状态为WAIT_TO_REVOTE
  3. 如果收到的有效投票数未过半,等待下一次进行选举,对应状态为WAIT_TO_REVOTE
  4. 如果收到有效投票数减去比当前节点ledgerEndIndex大的节点个数未过半,如果走到这一个条件中,说明收到有效投票个数是过半的(如果未过半会先进入条件3),但是其中有些节点的ledgerEndIndex大于当前节点,将这部分减去之后还未过半,意味着本次选举没获得过半的有效投票数不能成功选举,等待下一次进行选举,对应状态为WAIT_TO_REVOTE
  5. 如果收到的投票数过半也就是达到了Quorum,本轮选举成功,对应状态PASS;
  6. 如果接受投票的节点个数+未准备好的节点数过半,表示有部分节点Term落后,与当前选举的Term不一致,立刻进行下一次投票,对应状态为REVOTE_IMMEDIATELY;
  7. 其他情况,等待下一次投票,对应状态为WAIT_TO_VOTE_NEXT;

如果进入到第6步,意味着选举成功,此时会调用changeRoleToLeader转为Leader角色:

public class DLedgerLeaderElector {     private void maintainAsCandidate() throws Exception {         // 发起投票         // ...         // 处理投票响应结果         // ...         try {             // 等待             voteLatch.await(2000 + random.nextInt(maxVoteIntervalMs), TimeUnit.MILLISECONDS);         } catch (Throwable ignore) {         }         lastVoteCost = DLedgerUtils.elapsed(startVoteTimeMs);         VoteResponse.ParseResult parseResult;         // 判断投票结果         if (knownMaxTermInGroup.get() > term) { // 1.如果其他节点返回的响应中有比当前节点的Term大的             // 等待下一次选举             parseResult = VoteResponse.ParseResult.WAIT_TO_VOTE_NEXT;              // 计算下次发起选举的时间             nextTimeToRequestVote = getNextTimeToRequestVote();              // 转为Candidate,传入knownMaxTermInGroup,下次会使用knownMaxTermInGroup的值进选举             changeRoleToCandidate(knownMaxTermInGroup.get());          } else if (alreadyHasLeader.get()) {// 2.如果有节点已经投票给了其他节点             parseResult = VoteResponse.ParseResult.WAIT_TO_REVOTE;             // 设置下次选举时间             nextTimeToRequestVote = getNextTimeToRequestVote() + heartBeatTimeIntervalMs * maxHeartBeatLeak;         } else if (!memberState.isQuorum(validNum.get())) { // 3.如果收到的有效投票数未过半             parseResult = VoteResponse.ParseResult.WAIT_TO_REVOTE;             nextTimeToRequestVote = getNextTimeToRequestVote();         } else if (!memberState.isQuorum(validNum.get() - biggerLedgerNum.get())) {// 4.如果收到有效投票数减去比当前节点ledgerEndIndex大的节点个数未过半             parseResult = VoteResponse.ParseResult.WAIT_TO_REVOTE;             nextTimeToRequestVote = getNextTimeToRequestVote() + maxVoteIntervalMs;         } else if (memberState.isQuorum(acceptedNum.get())) {             // 5.投票数如果达到了Quorum,选举通过             parseResult = VoteResponse.ParseResult.PASSED;          } else if (memberState.isQuorum(acceptedNum.get() + notReadyTermNum.get())) {             // 6. 如果接受投票数+未准备好的节点数过半,立刻进行下一次投票             parseResult = VoteResponse.ParseResult.REVOTE_IMMEDIATELY;         } else {             // 7.其他情况,等待下一次投票             parseResult = VoteResponse.ParseResult.WAIT_TO_VOTE_NEXT;             nextTimeToRequestVote = getNextTimeToRequestVote();         }         lastParseResult = parseResult;         logger.info("[{}] [PARSE_VOTE_RESULT] cost={} term={} memberNum={} allNum={} acceptedNum={} notReadyTermNum={} biggerLedgerNum={} alreadyHasLeader={} maxTerm={} result={}",             memberState.getSelfId(), lastVoteCost, term, memberState.peerSize(), allNum, acceptedNum, notReadyTermNum, biggerLedgerNum, alreadyHasLeader, knownMaxTermInGroup.get(), parseResult);         // 如果选举通过         if (parseResult == VoteResponse.ParseResult.PASSED) {             logger.info("[{}] [VOTE_RESULT] has been elected to be the leader in term {}", memberState.getSelfId(), term);             // 选举成功,转为Leader角色             changeRoleToLeader(term);         }     } } 

成为Leadr

节点收到集群中大多数投票后,调用changeRoleToLeader方法转为Leader:

  1. 调用changeToLeader方法将角色更改为Leader;
  2. 调用handleRoleChange方法触发角色变更事件;
public class DLedgerLeaderElector {     public void changeRoleToLeader(long term) {         synchronized(this.memberState) {             // 如果Term一致             if (this.memberState.currTerm() == term) {                 // 转为Leader角色                 this.memberState.changeToLeader(term);                 this.lastSendHeartBeatTime = -1L;                 // 触发角色改变事件                 this.handleRoleChange(term, Role.LEADER);                 logger.info("[{}] [ChangeRoleToLeader] from term: {} and currTerm: {}", new Object[]{this.memberState.getSelfId(), term, this.memberState.currTerm()});             } else {                 logger.warn("[{}] skip to be the leader in term: {}, but currTerm is: {}", new Object[]{this.memberState.getSelfId(), term, this.memberState.currTerm()});             }          }     } } 

成为Leader角色之后,下次执行StateMaintainer的doWork方法时,调用DLedgerLeaderElector.this.maintainState()后,会进入到Leader角色的处理逻辑,也就是maintainAsLeader方法中,在方法中会判断上次发送心跳的时间是否大于心跳发送间隔,如果是做如下处理:

  1. 校验是否是Leader角色,如果不是直接返回;
  2. 调用sendHeartbeats方法,向集群中其他节点发送心跳包;

也就是说,如果某个节点成为了Leader角色,会定期执行进入到maintainAsLeader方法中,如果距离上次发送心跳的时间超过了心跳发送间隔,向其他节点发送心跳包保持通信。

public class DLedgerLeaderElector {     private void maintainAsLeader() throws Exception {         // 如果上次发送心跳的时间大于心跳发送间隔         if (DLedgerUtils.elapsed(lastSendHeartBeatTime) > heartBeatTimeIntervalMs) {             long term;             String leaderId;             synchronized (memberState) {                 // 校验是否是Leader                 if (!memberState.isLeader()) {                     return;                 }                 term = memberState.currTerm();                 leaderId = memberState.getLeaderId();                 // 更新发送心跳的时间                 lastSendHeartBeatTime = System.currentTimeMillis();             }             // 向集群中其他节点发送心跳包             sendHeartbeats(term, leaderId);         }     } } 

计算时间差

DLedgerUtilselapsed方法用于计算时间差,使用当前时间减去参数传入的时间,后面会看到某些情况下会将上次发送心跳的时间置为-1,这里相减之后,返回值会大于心跳时间间隔,所以会立刻发送心跳包:

public class DLedgerUtils {     public static long elapsed(long start) {         return System.currentTimeMillis() - start;     } } 

发送心跳包

sendHeartbeats方法中遍历当前节点维护的集群中所有节点,向除自己以外的其他节点发送心跳请求:

  1. 构建HeartBeatRequest请求;
  2. 请求中设置本次选举的相关信息,包括组信息、当前节点的ID、目标节点的ID、LeaderID、当前的Term;
  3. 调用heartBeat发送心跳请求;
  4. 处理心跳请求返回的响应数据,这个稍后再讲;
public class DLedgerLeaderElector {     private void sendHeartbeats(long term, String leaderId) throws Exception {         final AtomicInteger allNum = new AtomicInteger(1);         final AtomicInteger succNum = new AtomicInteger(1);         final AtomicInteger notReadyNum = new AtomicInteger(0);         final AtomicLong maxTerm = new AtomicLong(-1);         final AtomicBoolean inconsistLeader = new AtomicBoolean(false);         final CountDownLatch beatLatch = new CountDownLatch(1);         long startHeartbeatTimeMs = System.currentTimeMillis();         // 遍历集群中的节点         for (String id : memberState.getPeerMap().keySet()) {             // 如果是当前节点自己,跳过             if (memberState.getSelfId().equals(id)) {                 continue;             }             // 构建心跳请求             HeartBeatRequest heartBeatRequest = new HeartBeatRequest();             heartBeatRequest.setGroup(memberState.getGroup()); // 设置组信息             heartBeatRequest.setLocalId(memberState.getSelfId());// 设置当前节点的ID             heartBeatRequest.setRemoteId(id);// 设置目标节点的ID             heartBeatRequest.setLeaderId(leaderId); // 设置LeaderID             heartBeatRequest.setTerm(term); // 设置Term             // 发送心跳请求             CompletableFuture<HeartBeatResponse> future = dLedgerRpcService.heartBeat(heartBeatRequest);             // 先省略心跳响应处理             // ...         }         // ...     } } 

心跳请求处理

lastLeaderHeartBeatTime:最近一次收到Leader心跳请求的时间,用于在Follower角色下判断心跳时间是否超时使用,如果长时间未收到心跳包,会认为Master故障,转为Candidate角色进行竞选。

集群中其他节点收到心跳请求后,对请求的处理在handleHeartBeat方法中:

  1. 判断发送心跳请求的节点是否在当前节点维护的集群中,如果不在返回状态为UNKNOWN_MEMBER

  2. 判断心跳请求中携带的LeaderID是否是当前节点,如果是,返回UNEXPECTED_MEMBER

  3. 对比请求中携带的Term与当前节点的Term:

    • 小于:返回EXPIRED_TERM表示请求中的Term已过期;
    • 相等:如果请求中的LeaderID与当前节点维护的LeaderID一致,表示之前已经同意节点成为Leader,更新收到心跳包的时间lastLeaderHeartBeatTime为当前时间,返回成功即可;
  4. 再次对比请求中的Term与当前节点的Term:

    (1)小于:说明请求的Term已落后,返回EXPIRED_TERM;

    (2)相等:

    • 如果当前节点记录的LeaderId为空,调用changeRoleToFollower转为Follower角色,返回成功
    • 如果请求中的LeaderId与当前节点的Leader一致,表示之前已经同意节点成为Leader,更新收到心跳包的时间lastLeaderHeartBeatTime为当前时间,返回成功;
    • 其他情况:主要是为了容错处理,返回INCONSISTENT_LEADER

    (3)大于:说明当前节点Term比较落后,此时调用changeRoleToCandidate转为Candidate角色,然后将needIncreaseTermImmediately置为true,返回TERM_NOT_READY,表示未准备好(与选举投票时的处理逻辑一致);

public class DLedgerLeaderElector {     public CompletableFuture<HeartBeatResponse> handleHeartBeat(HeartBeatRequest request) throws Exception {         // 判断发送心跳请求的节点是否在集群中         if (!memberState.isPeerMember(request.getLeaderId())) {             logger.warn("[BUG] [HandleHeartBeat] remoteId={} is an unknown member", request.getLeaderId());             // 返回UNKNOWN_MEMBER             return CompletableFuture.completedFuture(new HeartBeatResponse().term(memberState.currTerm()).code(DLedgerResponseCode.UNKNOWN_MEMBER.getCode()));         }         // 判断心跳请求中携带的LeaderID是否是当前节点         if (memberState.getSelfId().equals(request.getLeaderId())) {             logger.warn("[BUG] [HandleHeartBeat] selfId={} but remoteId={}", memberState.getSelfId(), request.getLeaderId());             // 返回UNEXPECTED_MEMBER             return CompletableFuture.completedFuture(new HeartBeatResponse().term(memberState.currTerm()).code(DLedgerResponseCode.UNEXPECTED_MEMBER.getCode()));         }         // 对比Term         if (request.getTerm() < memberState.currTerm()) { // 请求中的Term如果小于当前节点的Term             // 返回EXPIRED_TERM表示请求中的Term已过期             return CompletableFuture.completedFuture(new HeartBeatResponse().term(memberState.currTerm()).code(DLedgerResponseCode.EXPIRED_TERM.getCode()));         } else if (request.getTerm() == memberState.currTerm()) { // 如果相等             // 如果请求中的LeaderID与当前节点维护的LeaderID一致,表示已经同意节点成为Leader             if (request.getLeaderId().equals(memberState.getLeaderId())) {                  // 更新为当前时间                 lastLeaderHeartBeatTime = System.currentTimeMillis();                 // 返回成功                 return CompletableFuture.completedFuture(new HeartBeatResponse());             }         }         synchronized (memberState) {             // 请求中的Term如果小于当前节点的Term             if (request.getTerm() < memberState.currTerm()) {                  // 返回EXPIRED_TERM                 return CompletableFuture.completedFuture(new HeartBeatResponse().term(memberState.currTerm()).code(DLedgerResponseCode.EXPIRED_TERM.getCode()));             } else if (request.getTerm() == memberState.currTerm()) {  // 请求中的Term于当前节点的Term相等                 if (memberState.getLeaderId() == null) { // 如果当前节点记录的LeaderId为空                     // 转为Follower角色                     changeRoleToFollower(request.getTerm(), request.getLeaderId());                     // 返回成功                     return CompletableFuture.completedFuture(new HeartBeatResponse());                 } else if (request.getLeaderId().equals(memberState.getLeaderId())) { // 如果请求中的LeaderId与当前节点的Leader一致                     lastLeaderHeartBeatTime = System.currentTimeMillis();                     // 返回成功                     return CompletableFuture.completedFuture(new HeartBeatResponse());                 } else {                     logger.error("[{}][BUG] currTerm {} has leader {}, but received leader {}", memberState.getSelfId(), memberState.currTerm(), memberState.getLeaderId(), request.getLeaderId());                     // 返回INCONSISTENT_LEADER                     return CompletableFuture.completedFuture(new HeartBeatResponse().code(DLedgerResponseCode.INCONSISTENT_LEADER.getCode()));                 }             } else { // 如果请求中的Term大于当前节点的Term                 // 转为Candidate                 changeRoleToCandidate(request.getTerm());                 // needIncreaseTermImmediately置为true                 needIncreaseTermImmediately = true;                 // 返回TERM_NOT_READY                 return CompletableFuture.completedFuture(new HeartBeatResponse().code(DLedgerResponseCode.TERM_NOT_READY.getCode()));             }         }     } } 

心跳响应结果处理

回到sendHeartbeats方法,当请求返回响应之后,会对返回响应状态进行判断:

  1. SUCCESS:表示成功,记录心跳发送成功的节点个数,succNum加1;
  2. EXPIRED_TERM:表示当前节点的Term已过期落后于其他节点,将较大的那个Term记录在maxTerm中;
  3. INCONSISTENT_LEADER:将inconsistLeader置为true;
  4. TERM_NOT_READY:表示有节点还未准备好,也就是Term较小,此时记录未准备节点的数量,notReadyNum加1;

接下来根据上面的处理结果进行判断:

  1. 如果集群中过半节点对心跳包返回了成功的状态,更新心跳包成功的时间lastSendHeartBeatTime的值;
  2. 如果未过半进行以下判断:
    • 如果成功的个数+未准备好的个数过半,lastSendHeartBeatTime值置为-1,下次进入maintainAsLeader方法会认为已经超过心跳发送时间间隔,所以会立刻发送心跳包;
    • 如果maxTerm值大于当前节点的Term,表示当前节点Term已过期,调用changeRoleToCandidate转为Candidate,并使用maxTerm做为下次选举的Term,等待下次选举;
    • inconsistLeader为true,调用changeRoleToCandidate转为Candidate,等待下次选举;
    • 如果上次成功发送心跳的时间大于maxHeartBeatLeak(最大心跳时间) * heartBeatTimeIntervalMs(心跳发送间隔),调用changeRoleToCandidate转为Candidate,等待下次选举;
public class DLedgerLeaderElector {     private void sendHeartbeats(long term, String leaderId) throws Exception {         final AtomicInteger allNum = new AtomicInteger(1);         final AtomicInteger succNum = new AtomicInteger(1);         final AtomicInteger notReadyNum = new AtomicInteger(0);         final AtomicLong maxTerm = new AtomicLong(-1);         final AtomicBoolean inconsistLeader = new AtomicBoolean(false);         final CountDownLatch beatLatch = new CountDownLatch(1);         long startHeartbeatTimeMs = System.currentTimeMillis();         // 遍历集群中的节点         for (String id : memberState.getPeerMap().keySet()) {             // 如果是当前节点自己,跳过             if (memberState.getSelfId().equals(id)) {                 continue;             }             // 构建心跳请求             HeartBeatRequest heartBeatRequest = new HeartBeatRequest();             heartBeatRequest.setGroup(memberState.getGroup()); // 设置组信息             heartBeatRequest.setLocalId(memberState.getSelfId());// 设置当前节点的ID             heartBeatRequest.setRemoteId(id);// 设置目标节点的ID             heartBeatRequest.setLeaderId(leaderId); // 设置LeaderID             heartBeatRequest.setTerm(term); // 设置Term             // 发送心跳             CompletableFuture<HeartBeatResponse> future = dLedgerRpcService.heartBeat(heartBeatRequest);             future.whenComplete((HeartBeatResponse x, Throwable ex) -> {                 try {                     if (ex != null) {                         memberState.getPeersLiveTable().put(id, Boolean.FALSE);                         throw ex;                     }                     switch (DLedgerResponseCode.valueOf(x.getCode())) {                         case SUCCESS: // 如果成功                             // 记录成功的数量                             succNum.incrementAndGet();                             break;                         case EXPIRED_TERM: // 如果Term过期                             // 使用响应返回的较大的那个Term记录在maxTerm中                             maxTerm.set(x.getTerm());                             break;                         case INCONSISTENT_LEADER: // 如果是INCONSISTENT_LEADER                             // inconsistLeader置为true                             inconsistLeader.compareAndSet(false, true);                             break;                         case TERM_NOT_READY:// 如果未准备                             // 记录未准备节点的数量                             notReadyNum.incrementAndGet();                             break;                         default:                             break;                     }                    // ...                 } catch (Throwable t) {                     logger.error("heartbeat response failed", t);                 } finally {                     allNum.incrementAndGet();                     if (allNum.get() == memberState.peerSize()) {                         beatLatch.countDown();                     }                 }             });         }         beatLatch.await(heartBeatTimeIntervalMs, TimeUnit.MILLISECONDS);         // 如果集群中过半节点对心跳包返回了成功的状态         if (memberState.isQuorum(succNum.get())) {             // 记录心跳成功的时间             lastSuccHeartBeatTime = System.currentTimeMillis();         } else {             logger.info("[{}] Parse heartbeat responses in cost={} term={} allNum={} succNum={} notReadyNum={} inconsistLeader={} maxTerm={} peerSize={} lastSuccHeartBeatTime={}",                 memberState.getSelfId(), DLedgerUtils.elapsed(startHeartbeatTimeMs), term, allNum.get(), succNum.get(), notReadyNum.get(), inconsistLeader.get(), maxTerm.get(), memberState.peerSize(), new Timestamp(lastSuccHeartBeatTime));             if (memberState.isQuorum(succNum.get() + notReadyNum.get())) { // 如果成功的个数+未准备好的个数                 // 上次发送心跳的时间间隔置为-1                 lastSendHeartBeatTime = -1;             } else if (maxTerm.get() > term) { // 如果Term信息过期                 // 转为Candidate重新选举,这里传入的是maxTerm的值                 changeRoleToCandidate(maxTerm.get());              } else if (inconsistLeader.get()) { // 如果inconsistLeader为true                  // 转为Candidate重新选举                 changeRoleToCandidate(term);             } else if (DLedgerUtils.elapsed(lastSuccHeartBeatTime) > maxHeartBeatLeak * heartBeatTimeIntervalMs) {                 // 如果上次成功发送心跳的时间大于 最大心跳时间* 心跳发送间隔                 changeRoleToCandidate(term);             }         }     } } 

Follower

当节点收到心跳包并同意发起选举的节点成为Leader时,会转为Follower角色,在下次执行doWork方法时会进入到maintainAsFollower的处理逻辑,会判断上次收到心跳包的实际是否超过了两倍的发送心跳间隔,如果超过,判断当前节点是否是Follower并且上次收到心跳包的时间大于最大心跳时间 * 每次发送心跳的时间间隔,如果成立,会调用changeRoleToCandidate方法 转为Candidate发起竞选,也就是说如果Follower节点长时间未收到Leader节点的心跳请求,会认为Leader出现了故障,所以会转为Candidate重新发起竞选

public class DLedgerLeaderElector {     private void maintainAsFollower() {         // 上次收到心跳包的时间是否超过了两倍的发送心跳间隔         if (DLedgerUtils.elapsed(lastLeaderHeartBeatTime) > 2 * heartBeatTimeIntervalMs) {             synchronized (memberState) {                 // 如果是Follower并且上次收到心跳包的时间大于 最大心跳时间 * 每次发送心跳的时间间隔                 if (memberState.isFollower() && (DLedgerUtils.elapsed(lastLeaderHeartBeatTime) > maxHeartBeatLeak * heartBeatTimeIntervalMs)) {                     logger.info("[{}][HeartBeatTimeOut] lastLeaderHeartBeatTime: {} heartBeatTimeIntervalMs: {} lastLeader={}", memberState.getSelfId(), new Timestamp(lastLeaderHeartBeatTime), heartBeatTimeIntervalMs, memberState.getLeaderId());                     // 转为Candidate发起竞选                     changeRoleToCandidate(memberState.currTerm());                 }             }         }     } } 

总结
【RocketMQ】DLedger选主源码分析
【RocketMQ】DLedger选主源码分析

参考

【中间件兴趣圈】源码分析 RocketMQ DLedger 多副本之 Leader 选主

RocketMQ源码分析之Dledger模式

RocketMQ版本:4.9.3

发表评论

相关文章

当前内容话题