Locality 管理 · k8s原理與實踐

[TOC] # Locality 管理概述 Locality 描述了表、表組或租戶下副本的分布情況。這里的副本分布情況指在 Zone 或 Region 上包含的副本的數量以及副本的類型，不同的租戶在同一個集群內可以配置不同的 Locality 并且彼此之間相互獨立不受影響。 ## Locality 語義 Locality 基本語法結構型為如下所示： ~~~ replicas{量詞}@location ~~~ 下述表格展示了語法中各元素的意義 <table data-tag="table" id="table-jwj-2qj-i6r" class="table"><colgroup width="360" span="1" data-tag="col" id="col-dsv-fi3-euy" colwidth="1*" colnum="1" colname="col1" style="width:25%" class="col"></colgroup><colgroup width="360" span="1" data-tag="col" id="col-bke-jg3-l3q" colwidth="3*" colnum="2" colname="col2" style="width:75%" class="col"></colgroup><thead id="thead-yyi-s0i-n3t" class="thead"><tr id="tr-xm9-yru-ent"><th id="td-sf7-9ov-8rd">元素</th><th id="td-w91-n8k-y2j">說明</th></tr></thead><tbody data-tag="tbody" id="tbody-mdu-oej-9sr" class="tbody"><tr data-tag="tr" id="tr-tgr-b5w-mrc" class="tr"><td data-tag="td" id="td-9qf-a4i-5hz" class="td">replicas</td><td data-tag="td" id="td-h4g-eei-zns" class="td">表示副本類型，副本類型相關說明請參見 <a href="replica-overview" id="a-yqa-gyc-97z" data-tag="xref" baseurl="t1940577_v2_0_1.xdita" data-node="2784705" data-root="66771" class="xref">副本概述</a> 章節。 <code data-tag="code" class="code">replicas</code>的值為副本名稱，您可以在副本類型說明表中的名稱列獲得支持的值（支持全名和簡寫）。</td></tr><tr data-tag="tr" id="tr-s0v-2ct-5mb" class="tr"><td data-tag="td" id="td-8ph-hsf-tvp" class="td">location</td><td data-tag="td" id="td-k40-cj8-txr" class="td">表示位置。它是系統已知的一組枚舉值。 <code data-tag="code" class="code">location</code>的值為 Zone 的名稱。</td></tr><tr data-tag="tr" id="tr-08k-trs-gv3" class="tr"><td data-tag="td" id="td-r0d-puu-bxw" class="td">量詞</td><td data-tag="td" id="td-fhg-e2d-6n1" class="td">不指定量詞的時候，表示一個副本。用 <code data-tag="code" class="code">{n}</code>表示 n 個副本。有一種特殊的量詞 <code data-tag="code" class="code">{all_server}</code>表示副本數和可用的 Server 的數量相同。一個分區在一個 Zone 中最多有一個全功能或日志型副本（這些類型的副本是 Paxos 復制組的成員），只讀型副本在同一個 Zone 中可以有多個。</td></tr></tbody></table> **說明** * 表和表組的 Locality 可以為空，表示繼承自所屬租戶。租戶的 Locality 不可以為空。 * 當租戶的 Locality 發生變更時，在該租戶下，所有 Locality 為空的表的副本的分布情況也會隨之變化。Locality 不為空的表在租戶的 Locality 變更時，其對應副本的分布情況不會改變。 **示例:** 下述示例展示了在一個擁有五個 Zone（z1~z5）的 OceanBase 集群中，可以容納不同 Locality 的多個租戶和它們的 Locality 情況： * sys tenant 的 Locality：`F@z1,F@z2,F@z3,F@z4,F@z5` * tenant1 的 Locality：`F@z1,F@z2,F,R{ALL_SERVER}@z3` * tenant2 的 Locality：`F@z1` ## Locality 變更規則 Locality 的變更需要遵循以下規則： * 變更進度與 tenant/table 級變更限制 * 在舊的一輪租戶 Locality 沒有完成變更時，新一輪的租戶 Locality 變更不允許被執行。 * 表級 Locality Zone List 必須是租戶級 Locality Zone List 的子集。 * Paxos 副本數變更規則 * Locality 變更的類型轉換目前僅支持 F->R、R->F 和 F->L 三種： * F->R 從 full 副本轉換為 readonly 副本，是減 Paxos 副本操作，每次減的 Paxos 副本數需小于變更后 Paxos 的副本數。 * R->F 從 readonly 副本轉換為 full 副本，是加 Paxos 副本操作，每次加的 paxos 副本數需小于變更前 Paxos 的副本數。 * F->L 從 full 副本轉換為 logonly 副本，不涉及 Paxos 副本數量的變化。F->L 的變更不能與任何加或減 Paxos 副本的操作同時發生。 * 非 Paxos 副本的變化可以和上述任何變更同時發生，沒有數量限制。 ## Locality 應用場景 Locality 的設置通常用于集群的副本數升級、降級或集群的搬遷： * 集群副本數升級以租戶為粒度，對集群中的每一個租戶，增加租戶下 Partition 的副本數。例如，將 Locality 由`F@z1,F@z2,F@z3`變更為`F@z1,F@z2,F@z3,F@z4,F@z5`，租戶從 3 副本變為 5 副本。 * 集群副本數降級以租戶為粒度，對集群內的每一個租戶減少其中 Partition 的副本數。例如，將 Locality 由`F@z1,F@z2,F@z3,F@z4,F@z5`變更為`F@z1,F@z2,F@z3,F@z4`，租戶從 5 副本變為 4 副本。 * 集群搬遷以租戶為粒度，對集群內的每一個租戶通過若干次 Locality 變更。比如，將 Locality 從`F@hz1,F@hz2,F@hz3`變更為`F@hz1,F@sh1,F@sh2`即代表將原集群中屬于杭州的兩個 Zone 遷到上海。