Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CN/modules/ROOT/pages/v4.6/1.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ IvorySQL 4.6,基于PostgreSQL 17.6,并修复了多个问题。有关更新

4. 新增IvorySQL 在线体验平台
+
提供一个基于 Web 的平台,用户可直接通过浏览器界面在线体验 IvorySQL V4.5 并进行数据库交互。
提供一个基于 Web 的平台,用户可直接通过浏览器界面在线体验 IvorySQL V4.6 并进行数据库交互。

5. 容器化部署支持 (Docker Swarm)
+
Expand All @@ -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. 文档:更新社区贡献流程。
Expand Down
38 changes: 19 additions & 19 deletions CN/modules/ROOT/pages/v4.6/32.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
:sectnumlevels: 5

:imagesdir: ./_images
= **IvorySQL社区协作流程**
== **IvorySQL社区协作流程**

IvorySQL 社区采用一套 闭环式开源协作流程,确保从问题提出到版本发布,每一个环节都能闭合反馈、持续改进。这一流程鼓励用户与开发者形成良性互动,让社区开发始终围绕实际需求持续演进。

Expand Down Expand Up @@ -45,7 +45,7 @@ image::p23.jpg[]

通过这套完整的闭环协作机制,IvorySQL 实现了问题响应 → 开发贡献 → 质量保障 → 发布反馈的全流程闭合,推动项目持续健康演进。

= **IvorySQL社区贡献指南**
== **IvorySQL社区贡献指南**

IvorySQL是一个由核心开发团队主导、社区共同维护的开源项目。我们欢迎用户、贡献者和维护者的加入,共同推动IvorySQL的发展。如果您希望看到您的代码或文档更改被添加到IvorySQL并出现在将来的版本中,本节的内容介绍是您需要知道的。

Expand All @@ -61,47 +61,47 @@ IvorySQL是一个由核心开发团队主导、社区共同维护的开源项目

📢 请务必阅读并遵守我们的 https://github.com/IvorySQL/IvorySQL/blob/master/CODE_OF_CONDUCT_CN.md[IvorySQL社区行为准则]。

== 注册Github账号
=== 注册Github账号

无论您是要提交 Issue、参与讨论,还是贡献代码与文档,您都需要使用 GitHub 账号登录并与 IvorySQL 项目进行交互。

请参考<https://docs.github.com/en/get-started/start-your-journey>注册您的github账号,并熟悉Git工具和工作流。

IvorySQL源码托管在github: <https://github.com/IvorySQL>。

== 用户
=== 用户

作为用户,您在使用 IvorySQL 过程中扮演着重要角色。我们鼓励您:

=== 反馈问题与需求
==== 反馈问题与需求

* 发现 Bug、性能缺陷或文档不准确?

* 有新的功能建议或使用体验改进?

如果您准备向社区上报 Bug 或者提交需求,请在 IvorySQL 社区对应的仓库上提交 Issue,并参考Issue xref:./33.adoc[提交指南]。

=== 参与社区讨论
==== 参与社区讨论

* 通过 https://lists.ivorysql.org[邮件列表]进行讨论

* 加入 https://github.com/IvorySQL/IvorySQL/discussions[GitHub讨论],补充信息或验证问题

* 在 微信、Discord等聊天群参与技术交流

== 贡献者
=== 贡献者

我们欢迎代码、文档、测试等各类贡献。

=== 签署CLA
==== 签署CLA
在提交代码或文档贡献之前,为了确保代码合法合规,个人或企业贡献者需要签署贡献者许可协议(CLA)。签署CLA是IvorySQL社区接受贡献的必要条件,以确保您的贡献被合法分发。请根据下列链接下载CLA进行签署并将签署后的CLA发送至 cla@ivorysql.org。

* https://www.ivorysql.org/zh-CN/assets/files/individual_cla-a81f001209eb5ce0f8ea7c3be4cc69b5.pdf[个人贡献者]
* https://www.ivorysql.org/zh-CN/assets/files/corporate_cla-76e89b6f17b0bc102cbc1105d438a917.pdf[企业贡献者]

未签署CLA的Pull Request将无法进入评审阶段。

=== 找到您感兴趣的项目
==== 找到您感兴趣的项目

我们将仓库划分为多个子项目,您可以从如下列表中找到感兴趣的项目及其代码仓库

Expand All @@ -119,17 +119,17 @@ IvorySQL源码托管在github: <https://github.com/IvorySQL>。
|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账户中。

==== 编码
===== 编码

使用如下命令将项目克隆到本地进行开发:

Expand All @@ -139,7 +139,7 @@ git checkout -b feature/your-feature-name

在提交代码前,请确保通过回归测试

==== 创建一个Pull Request并提交
===== 创建一个Pull Request并提交

打开你 Fork 的仓库: https://github.com/$user/IvorySQL.git

Expand All @@ -156,25 +156,25 @@ leave a comment

点击Create pull request 按钮即可提交。

== 维护者
=== 维护者
维护者负责进行IvorySQL代码的管理,PR审查,主导版本发布与IvorySQL发展方向。

=== 社区规划
==== 社区规划
* 制定版本规划和 Roadmap

* 跟踪与评估社区需求

* 维护公开的 TODO 列表

=== 代码管理
==== 代码管理
* 参与 Pull Request 评审

* 审查安全问题,保障项目健康

=== 流程与治理机制
==== 流程与治理机制
* 优化协作机制(代码贡献指南、PR 模板等)

* 建立漏洞响应机制和行为守则

== 致谢
=== 致谢
感谢每一位参与 IvorySQL 的开发者、文档编辑者、测试人员和使用者。正是有了你们的付出,IvorySQL 才能不断成长!我们欢迎所有人参与 IvorySQL 社区贡献,我们的目标是发展一个由贡献者组成的活跃、健康的社区。
24 changes: 1 addition & 23 deletions CN/modules/ROOT/pages/v4.6/38.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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服务
Expand All @@ -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端口
```
Expand Down
24 changes: 1 addition & 23 deletions EN/modules/ROOT/pages/v4.6/38.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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.
```
Expand Down