From 302ba67e2ac5eef1701281a59377481c0ca4dd80 Mon Sep 17 00:00:00 2001 From: JiaoShuntian Date: Wed, 10 Sep 2025 16:58:40 +0800 Subject: [PATCH 1/2] fix some typos --- CN/modules/ROOT/pages/v4.6/1.adoc | 4 ++-- CN/modules/ROOT/pages/v4.6/38.adoc | 24 +----------------------- EN/modules/ROOT/pages/v4.6/38.adoc | 24 +----------------------- 3 files changed, 4 insertions(+), 48 deletions(-) diff --git a/CN/modules/ROOT/pages/v4.6/1.adoc b/CN/modules/ROOT/pages/v4.6/1.adoc index 0f8002ea..bc332235 100644 --- a/CN/modules/ROOT/pages/v4.6/1.adoc +++ b/CN/modules/ROOT/pages/v4.6/1.adoc @@ -42,7 +42,7 @@ IvorySQL 4.6，基于PostgreSQL 17.6，并修复了多个问题。有关更新 4. 新增IvorySQL 在线体验平台 + -提供一个基于 Web 的平台，用户可直接通过浏览器界面在线体验 IvorySQL V4.5 并进行数据库交互。 +提供一个基于 Web 的平台，用户可直接通过浏览器界面在线体验 IvorySQL V4.6 并进行数据库交互。 5. 容器化部署支持 (Docker Swarm) + @@ -59,7 +59,7 @@ IvorySQL云平台当前支持IvorySQL v4数据库的订阅管理，以及其周 - IvorySQL 4.6 问题修复 1. 在aarch64平台上缺少依赖库libcrypt。 -2. p执行make和make install时，前缀test_开头的测试项被错误地编译和安装到extension目录。 +2. 执行make和make install时，前缀test_开头的测试项被错误地编译和安装到extension目录。 3. 文档：修复一些错别字。 4. 文档：修复安装部分的文档错误。 5. 文档：更新社区贡献流程。 diff --git a/CN/modules/ROOT/pages/v4.6/38.adoc b/CN/modules/ROOT/pages/v4.6/38.adoc index 97d944c2..a498a767 100644 --- a/CN/modules/ROOT/pages/v4.6/38.adoc +++ b/CN/modules/ROOT/pages/v4.6/38.adoc @@ -124,17 +124,7 @@ ivorysql=# show ivorysql.compatible_mode; ✔ Container etcd Started 0.1s ``` -当所有节点均部署完成后，检查etcd集群状态 -``` -[root@manager-node1 docker-compose]# docker exec -it etcd etcdctl --write-out=table --endpoints="192.168.21.205:2379,192.168.21.164:2379,192.168.21.51:2379" endpoint status -+---------------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------+ -| ENDPOINT | ID | VERSION | DB SIZE | IS LEADER | IS LEARNER | RAFT TERM | RAFT INDEX | RAFT APPLIED INDEX | ERRORS | -+---------------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------+ -| 192.168.21.205:2379 | 10574d87df892440 | 3.5.8 | 20 kB | true | false | 2 | 13 | 13 | | -| 192.168.21.164:2379 | a47a4fd720eb36e7 | 3.5.8 | 20 kB | false | false | 2 | 13 | 13 | | -| 192.168.21.51:2379 | b76a77d78fdf886f | 3.5.8 | 20 kB | false | false | 2 | 13 | 13 | | -+---------------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------+ -``` + 部署IvorySQL高可用集群 在每个节点上，部署ivyhac服务 @@ -149,19 +139,7 @@ CONTAINER ID IMAGE COMMAND 9d8e04e4f819 quay.io/coreos/etcd:v3.5.8 "/usr/local/bin/etcd" 24 minutes ago Up 24 minutes etcd ``` -待所有节点部署完毕后，检查IvorySQL集群状态 -``` -[root@manager-node1 docker-compose]# docker exec -it ivyhac1 /bin/bash -[ivorysql@manager-node1 /]$ patronictl -c $PATRONICONF/patroni.yml list -+ Cluster: ivory-cluster (7548337408295624728) ------+----+-----------+ -| Member | Host | Role | State | TL | Lag in MB | -+-------------+----------------+---------+-----------+----+-----------+ -| ivypatroni1 | 192.168.21.205 | Leader | running | 1 | | -| ivypatroni2 | 192.168.21.164 | Replica | streaming | 1 | 0 | -| ivypatroni3 | 192.168.21.51 | Replica | streaming | 1 | 0 | -+-------------+----------------+---------+-----------+----+-----------+ -``` 此时，一主两备集群搭建完成 psql连接数据库的Oracle端口及PG端口 ``` diff --git a/EN/modules/ROOT/pages/v4.6/38.adoc b/EN/modules/ROOT/pages/v4.6/38.adoc index 6177f104..3a512c48 100644 --- a/EN/modules/ROOT/pages/v4.6/38.adoc +++ b/EN/modules/ROOT/pages/v4.6/38.adoc @@ -124,17 +124,7 @@ Deploy a three-node etcd cluster, taking node1 as an example ✔ Container etcd Started 0.1s ``` -After all nodes are deployed, check the status of the etcd cluster. -``` -[root@manager-node1 docker-compose]# docker exec -it etcd etcdctl --write-out=table --endpoints="192.168.21.205:2379,192.168.21.164:2379,192.168.21.51:2379" endpoint status -+---------------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------+ -| ENDPOINT | ID | VERSION | DB SIZE | IS LEADER | IS LEARNER | RAFT TERM | RAFT INDEX | RAFT APPLIED INDEX | ERRORS | -+---------------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------+ -| 192.168.21.205:2379 | 10574d87df892440 | 3.5.8 | 20 kB | true | false | 2 | 13 | 13 | | -| 192.168.21.164:2379 | a47a4fd720eb36e7 | 3.5.8 | 20 kB | false | false | 2 | 13 | 13 | | -| 192.168.21.51:2379 | b76a77d78fdf886f | 3.5.8 | 20 kB | false | false | 2 | 13 | 13 | | -+---------------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------+ -``` + Deploy an IvorySQL high-availability cluster. Deploy the ivyhac service on each node, using node1 as an example. @@ -148,19 +138,7 @@ CONTAINER ID IMAGE COMMAND 9d8e04e4f819 quay.io/coreos/etcd:v3.5.8 "/usr/local/bin/etcd" 24 minutes ago Up 24 minutes etcd ``` -After all nodes are deployed, check the status of the IvorySQL cluster. -``` -[root@manager-node1 docker-compose]# docker exec -it ivyhac1 /bin/bash -[ivorysql@manager-node1 /]$ patronictl -c $PATRONICONF/patroni.yml list -+ Cluster: ivory-cluster (7548337408295624728) ------+----+-----------+ -| Member | Host | Role | State | TL | Lag in MB | -+-------------+----------------+---------+-----------+----+-----------+ -| ivypatroni1 | 192.168.21.205 | Leader | running | 1 | | -| ivypatroni2 | 192.168.21.164 | Replica | streaming | 1 | 0 | -| ivypatroni3 | 192.168.21.51 | Replica | streaming | 1 | 0 | -+-------------+----------------+---------+-----------+----+-----------+ -``` At this point, the one-primary-two-standby cluster setup is complete. Connect to the database using psql via Oracle-compatible ports and PostgreSQL ports. ``` From 7aed19a8b509fdf766bc3a90704a0d0d0b429f45 Mon Sep 17 00:00:00 2001 From: JiaoShuntian Date: Wed, 10 Sep 2025 17:12:42 +0800 Subject: [PATCH 2/2] update community contribution --- CN/modules/ROOT/pages/v4.6/32.adoc | 38 +++++++++++++++--------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/CN/modules/ROOT/pages/v4.6/32.adoc b/CN/modules/ROOT/pages/v4.6/32.adoc index d63cd5ac..950d9a56 100644 --- a/CN/modules/ROOT/pages/v4.6/32.adoc +++ b/CN/modules/ROOT/pages/v4.6/32.adoc @@ -3,7 +3,7 @@ :sectnumlevels: 5 :imagesdir: ./_images -= **IvorySQL社区协作流程** +== **IvorySQL社区协作流程** IvorySQL 社区采用一套 闭环式开源协作流程，确保从问题提出到版本发布，每一个环节都能闭合反馈、持续改进。这一流程鼓励用户与开发者形成良性互动，让社区开发始终围绕实际需求持续演进。 @@ -45,7 +45,7 @@ image::p23.jpg[] 通过这套完整的闭环协作机制，IvorySQL 实现了问题响应 → 开发贡献 → 质量保障 → 发布反馈的全流程闭合，推动项目持续健康演进。 -= **IvorySQL社区贡献指南** +== **IvorySQL社区贡献指南** IvorySQL是一个由核心开发团队主导、社区共同维护的开源项目。我们欢迎用户、贡献者和维护者的加入，共同推动IvorySQL的发展。如果您希望看到您的代码或文档更改被添加到IvorySQL并出现在将来的版本中，本节的内容介绍是您需要知道的。 @@ -61,7 +61,7 @@ IvorySQL是一个由核心开发团队主导、社区共同维护的开源项目 📢 请务必阅读并遵守我们的 https://github.com/IvorySQL/IvorySQL/blob/master/CODE_OF_CONDUCT_CN.md[IvorySQL社区行为准则]。 -== 注册Github账号 +=== 注册Github账号 无论您是要提交 Issue、参与讨论，还是贡献代码与文档，您都需要使用 GitHub 账号登录并与 IvorySQL 项目进行交互。 @@ -69,11 +69,11 @@ IvorySQL是一个由核心开发团队主导、社区共同维护的开源项目 IvorySQL源码托管在github: 。 -== 用户 +=== 用户 作为用户，您在使用 IvorySQL 过程中扮演着重要角色。我们鼓励您： -=== 反馈问题与需求 +==== 反馈问题与需求 * 发现 Bug、性能缺陷或文档不准确？ @@ -81,7 +81,7 @@ IvorySQL源码托管在github: 。 如果您准备向社区上报 Bug 或者提交需求，请在 IvorySQL 社区对应的仓库上提交 Issue，并参考Issue xref:./33.adoc[提交指南]。 -=== 参与社区讨论 +==== 参与社区讨论 * 通过 https://lists.ivorysql.org[邮件列表]进行讨论 @@ -89,11 +89,11 @@ IvorySQL源码托管在github: 。 * 在 微信、Discord等聊天群参与技术交流 -== 贡献者 +=== 贡献者 我们欢迎代码、文档、测试等各类贡献。 -=== 签署CLA +==== 签署CLA 在提交代码或文档贡献之前，为了确保代码合法合规，个人或企业贡献者需要签署贡献者许可协议(CLA)。签署CLA是IvorySQL社区接受贡献的必要条件，以确保您的贡献被合法分发。请根据下列链接下载CLA进行签署并将签署后的CLA发送至 cla@ivorysql.org。 * https://www.ivorysql.org/zh-CN/assets/files/individual_cla-a81f001209eb5ce0f8ea7c3be4cc69b5.pdf[个人贡献者] @@ -101,7 +101,7 @@ IvorySQL源码托管在github: 。 未签署CLA的Pull Request将无法进入评审阶段。 -=== 找到您感兴趣的项目 +==== 找到您感兴趣的项目 我们将仓库划分为多个子项目，您可以从如下列表中找到感兴趣的项目及其代码仓库 @@ -119,17 +119,17 @@ IvorySQL源码托管在github: 。 |https://github.com/IvorySQL/ivorysql-wasm[Ivorysql_wasm] | 负责IvorySQL在线易用体验网站的开发和维护 |=== -=== 给自己分配Issue +==== 给自己分配Issue 您可以将自己创建的Issue或者愿意处理的Issue分配给自己。 只需要在评论框内输入/assign，机器人就会将问题分配给您。 每个 Issue 下面可能已经有参与者的交流和讨论，如果您感兴趣，也可以在评论框中发表自己的意见参与 Issue 讨论。 -=== 开发与提交Pull Request +==== 开发与提交Pull Request 对于提交一个PR应该保持一个功能，或者一个bug提交一次。禁止多个功能一次提交。 -==== Fork仓库 +===== Fork仓库 前往项目主页，点击Fork按钮，将IvorySQL项目Fork到您自己的GitHub账户中。 -==== 编码 +===== 编码 使用如下命令将项目克隆到本地进行开发： @@ -139,7 +139,7 @@ git checkout -b feature/your-feature-name 在提交代码前，请确保通过回归测试 -==== 创建一个Pull Request并提交 +===== 创建一个Pull Request并提交 打开你 Fork 的仓库： https://github.com/$user/IvorySQL.git @@ -156,25 +156,25 @@ leave a comment 点击Create pull request 按钮即可提交。 -== 维护者 +=== 维护者 维护者负责进行IvorySQL代码的管理，PR审查，主导版本发布与IvorySQL发展方向。 -=== 社区规划 +==== 社区规划 * 制定版本规划和 Roadmap * 跟踪与评估社区需求 * 维护公开的 TODO 列表 -=== 代码管理 +==== 代码管理 * 参与 Pull Request 评审 * 审查安全问题，保障项目健康 -=== 流程与治理机制 +==== 流程与治理机制 * 优化协作机制（代码贡献指南、PR 模板等） * 建立漏洞响应机制和行为守则 -== 致谢 +=== 致谢 感谢每一位参与 IvorySQL 的开发者、文档编辑者、测试人员和使用者。正是有了你们的付出，IvorySQL 才能不断成长！我们欢迎所有人参与 IvorySQL 社区贡献，我们的目标是发展一个由贡献者组成的活跃、健康的社区。 \ No newline at end of file