jetstream-api 0.16.0__tar.gz → 0.17.0__tar.gz

{jetstream_api-0.16.0/jetstream_api.egg-info → jetstream_api-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.16.0
+Version: 0.17.0
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003
@@ -60,6 +60,35 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.17.0 변경 - 클러스터 API 를 컨트롤러 정족수 모델로 (자바 v2.13.0 과 같음, 엔진은 해당 판 이상)
+
+판사 · MAIN · SUB 세 정의를 각각 만들던 모델이 **없어졌습니다.** 이제 클러스터 하나에 정의 하나이고, 그 안에 **노드 전부**를 적습니다. 역할은 정의의 종류가 아니라 **노드의 성질**입니다 - 큐 관리자가 있으면 브로커, `coordinator` 를 세우면 컨트롤러이고, 둘은 **겹칠 수 있습니다.**
+
+```python
+c = ILClusterProperty("C1")
+c.nodes = [
+    ILClusterNode("QM1", "10.10.1.12", 12345, 9000, node_id=1),
+    ILClusterNode("QM2", "10.10.1.13", 12345, 9000, node_id=2),
+    ILClusterNode("QM3", "10.10.1.14", 12345, 9000, node_id=3),
+]
+for n in c.nodes:
+    n.coordinator = True          # ilsc 의 COORDS(1,2,3)
+svc.createCluster(c)
+```
+
+- **컨트롤러 포트가 노드마다 하나입니다**(`ILClusterNode.ctrlPort`). 클러스터 한 개에 하나였던 `ilccPort` 는 없어졌습니다.
+- **노드 번호(`nodeId`)는 자리 이름이지 위치가 아닙니다.** 노드를 지우면 번호에 구멍이 남고 메우지 않습니다 - `nodes[n-1]` 로 찾지 말고 `getNode(n)` 을 쓰십시오.
+- 큐 관리자 없이 투표만 하는 노드를 만들 수 있습니다: `ILClusterNode(None, "10.10.1.15", 0, 9000, node_id=4)`.
+- `getBrokerNodes()` / `getControllerNodes()` / `getNode(n)` / `ILClusterNode.getRoles()` 가 새로 있습니다.
+- **`coordinator` 는 참/거짓이 아니라 세 상태입니다** - `True`(맞다) / `False`(아니다) / `None`(**모름**). `is None` 으로 먼저 가르십시오. `isCoordinator()` 도 세 값을 그대로 줍니다.
+- **`replicas` / `minSync` 는 비워 두는 것이 기본이고, 비운 채로 왕복합니다.** 비우면 엔진이 **브로커 역할 노드 전부**를 복제본 수로 치므로 노드를 더하면 따라 늘어납니다. 숫자를 명시하면 그 진술이 고정되어 노드를 더할 때 같이 고쳐 보내야 합니다. **`0` 은 정상값이고 "안 정함" 은 `None` 뿐입니다** - `if not p.replicas` 로 판정하지 마십시오.
+- ☠ **`minSync` 는 Kafka 의 `min.insync.replicas` 와 이름만 같고 계약이 다릅니다.** ISR 이 이 아래로 떨어져도 **쓰기를 거절하지 않습니다** - 가용성을 택하고 내구성을 내립니다.
+- **`setClusterProperty` 는 읽어서 고쳐 되보내십시오.** 정의에는 클라이언트가 읽기만 하는 자리(`clusterId` · `signature` · `(defTerm, defVersion)`)가 있고, `getClusterProperty` 로 받은 객체가 그 바이트를 그대로 들고 있습니다. 새로 만든 객체로 ALTER 하면 그 자리가 빈칸으로 나갑니다.
+- **`createCluster` 는 더 이상 클라이언트에서 규칙을 미리 검사하지 않습니다.** 규칙은 엔진이 정본이고, 클라이언트에 한 벌 더 적으면 두 벌이 갈립니다(옛 `TYPE` 사전검사가 그 경로로 생겼습니다).
+- 와이어 레이아웃이 바뀌었습니다 - 고정부 512 → **768**, 노드 256 → **384**(`ILC.MIMQ_VO_CLUSTER_LEN` / `MIMQ_VO_CLUSTER_NODE_LEN`). 블롭 앞머리에 판 표시 `"V2"` 가 붙고, **표시가 없는 옛 블롭은 거절합니다**(길이로는 가릴 수 없습니다 - 옛 512+5+256 과 새 768+5+0 이 둘 다 773 입니다).
+- **없어진 이름**: `ILClusterProperty.judge()` · `ILClusterProperty.coordinator()`(클래스 메서드) · `clusterType` / `getClusterType` / `setClusterType` · `ilccPort` / `getIlccPort` / `setIlccPort`(클러스터와 노드 양쪽) · `authorityHolder` / `getAuthorityHolder` / `getAuthorityHolderType` · `isJudge` · `ILClusterNode.get_ilcc_address` / `getIlccAddress` · `ILClusterProperty(name, ilcc_port, is_auto_start, cluster_type)` 의 `ilcc_port` · `cluster_type` 인자.
+  없어진 이름에 **대입하면** 무엇으로 바뀌었는지까지 알려 주는 `AttributeError` 가 납니다.
+
 ## 0.16.0 변경 - 세그먼트 이름을 토픽과 같은 형식으로, 오타 대입 거부 (자바 v2.12.0 과 같음)
 
 - **이름 규칙이 정해졌습니다 - 개수는 맨 복수형, 목록은 `...List` 접미.** 토픽이 `partitions` 를 쓰는 형식 그대로입니다.