Skip to content

Commit df9afaf

Browse files
committed
update readme
1 parent f7cc55e commit df9afaf

File tree

1 file changed

+63
-12
lines changed

1 file changed

+63
-12
lines changed

README.md

Lines changed: 63 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,16 +13,17 @@ Battery-Included, Local-First **PostgreSQL** Distribution as a Free & Better **R
1313
1414
[Website](https://pigsty.io/) | [Org](https://github.com/pgsty) | [Docs](https://pigsty.io/docs/) | [Extensions](https://pigsty.io/ext/) | [Values](https://pigsty.io/about/values) | [Demo](https://demo.pigsty.cc) | [Blog](https://pigsty.io/blog) | [Discuss](https://github.com/orgs/pgsty/discussions) | [Support](https://pigsty.io/price) | [中文站点](https://pigsty.cc) | [博客](https://pigsty.cc/blog)
1515

16-
[**Get Started**](https://pigsty.io/docs/setup/install/) with the latest [**v3.4.1**](https://github.com/pgsty/pigsty/releases/tag/v3.4.1): `curl -fsSL https://repo.pigsty.io/get`
16+
[**Get Started**](https://pigsty.io/docs/setup/install/) with the latest [**v3.4.1**](https://github.com/pgsty/pigsty/releases/tag/v3.4.1): `curl -fsSL https://repo.pigsty.io/get | bash -s v3.4.1`
1717

1818
[![pigsty-desc](https://pigsty.io/img/pigsty/banner.en.jpg)](https://pigsty.io/about/values)
1919

20+
> Self-Hosting PostgreSQL RDS like a Pro!
2021
2122
--------
2223

2324
## Features
2425

25-
- [**Extensible**](https://pigsty.io/about/extensibility/): **405** [**PG Extensions**](https://pigsty.io/ext/list) & **8** [**PG Kernel**](https://pigsty.io/docs/kernel) available (e.g. [**MSSQL**](https://pigsty.io/docs/kernel/babelfish/), [**Oracle**](https://pigsty.io/docs/kernel/ivorysql/), [**MYSQL**](https://pigsty.io/docs/kernel/openhalo/)...
26+
- [**Extensible**](https://pigsty.io/about/extensibility/): **405** [**PG Extensions**](https://pigsty.io/ext/list) & **8** [**PG Kernel**](https://pigsty.io/docs/kernel) available, with [**MsSQL**](https://pigsty.io/docs/kernel/babelfish/), [**Oracle**](https://pigsty.io/docs/kernel/ivorysql/), [**MySQL**](https://pigsty.io/docs/kernel/openhalo/), [**Mongo**](https://pigsty.io/docs/ferret) compatibility
2627
- [**Reliable**](https://pigsty.io/about/reliability/): Self-healing [**HA**](https://pigsty.io/docs/concept/ha/) clusters with pre-configured [**PITR**](https://pigsty.io/docs/pgsql/arch#point-in-time-recovery) and built-in [**ACL**](https://pigsty.io/docs/pgsql/acl), [**CA & SSL**](https://pigsty.io/docs/reference/param/#ca) secure best practice.
2728
- [**Observable**](https://pigsty.io/about/observability/): SOTA monitoring for [**PG**](https://demo.pigsty.cc/d/pgrds-instance/pgrds-instance) / [**Infra**](https://pigsty.io/docs/infra) / [**Node**](https://pigsty.io/docs/node) based on **Prometheus** & **Grafana** stack: [**Demo**](https://demo.pigsty.cc) & [**Gallery**](https://github.com/pgsty/pigsty/wiki/Gallery).
2829
- [**Scalable**](https://pigsty.io/about/scalability/): Auto-routed & pooled customizable database [**Services**](https://pigsty.io/docs/concept/svc#default-service) [**Access**](https://pigsty.io/docs/concept/svc#access-service) with **haproxy**, **pgbouncer**, and **VIP**.
@@ -317,7 +318,7 @@ The cluster keeps serving as long as **ANY** instance survives, with excellent f
317318
## Customization
318319

319320
Pigsty is highly customizable, You can describe the entire database and infra deployment with **300+** [**parameters**](https://pigsty.io/docs/reference/param/) in a single config file and materialize them with one command.
320-
There are many built-in configuration [templates](https://pigsty.io/docs/conf) that can be used directly.
321+
There are many built-in configuration [templates](https://pigsty.io/docs/conf).
321322

322323
<details><summary>Example: Sandbox (4-node) with two PG cluster</summary><br>
323324

@@ -428,14 +429,18 @@ pg-meta-delay: # delayed instance for pg-meta (1 hour ago)
428429
429430
</details>
430431
431-
You can deploy different kinds of PostgreSQL instance such as primary, replica, offline, delayed, sync standby, etc.,
432-
and customize with scene-optimize [**templates**](https://github.com/pgsty/pigsty/tree/dev/conf), pre-defined [**stacks**](https://pigsty.io/docs/pgext/usage/stack) and all **405** [**extensions**](https://pigsty.io/ext/list).
433432
434-
You can define [**Users**](https://pigsty.io/docs/pgsql/user/), [**Databases**](https://pigsty.io/docs/pgsql/db/), [**Service**](https://pigsty.io/docs/pgsql/svc/), [**HBAs**](https://pigsty.io/docs/pgsql/hba/) and other entities in code and provision them in one pass.
435-
You can even replace the vanilla [**`PostgreSQL`**](https://pigsty.io/docs/pgsql) [**Kernel**](https://pigsty.io/docs/kernel/) with other forks as an in-place replacement: [**`Babelfish`**](https://pigsty.io/docs/kernel/babelfish/) for MSSQL compatibility,
436-
[**`IvorySQL`**](https://pigsty.io/docs/kernel/ivorysql) and [**`PolarDB`**](https://pigsty.io/docs/kernel/polardb/) for ORACLE compatibility, [**OpenHalo**](https://pigsty.io/docs/kernel/openhalo/) for MySQL compatibility, [**OrioleDB**](https://pigsty.io/docs/kernel/orioledb/) for extreme OLTP performance, and so on...
433+
--------
434+
435+
You can deploy different kinds of PostgreSQL instance such as [`primary`](https://pigsty.io/docs/pgsql/config/#primary), [`replica`](https://pigsty.io/docs/pgsql/config/#replica), [`offline`](https://pigsty.io/docs/pgsql/config/#offline), [`delayed`](https://pigsty.io/docs/pgsql/config/#delayed-cluster), [`sync standby`](https://pigsty.io/docs/pgsql/config/#sync-standby), etc.,
436+
and customize with scene-optimize [**config templates**](https://pigsty.io/docs/conf/) and all **405** [**extensions**](https://pigsty.io/ext/list) out-of-the-box.
437+
438+
You can define [**Users**](https://pigsty.io/docs/pgsql/user/), [**Databases**](https://pigsty.io/docs/pgsql/db/), [**Service**](https://pigsty.io/docs/pgsql/svc/), [**HBAs**](https://pigsty.io/docs/pgsql/hba/) and other entities with code and provision them in one pass.
439+
440+
You can even replace the vanilla [**`PostgreSQL`**](https://pigsty.io/docs/pgsql) [**Kernel**](https://pigsty.io/docs/kernel/) with exotic forks as an in-place replacement: [**`Babelfish`**](https://pigsty.io/docs/kernel/babelfish/) for MSSQL compatibility,
441+
[**`IvorySQL`**](https://pigsty.io/docs/kernel/ivorysql) and [**`PolarDB`**](https://pigsty.io/docs/kernel/polardb/) for Oracle compatibility, [**`OpenHalo`**](https://pigsty.io/docs/kernel/openhalo/) for MySQL compatibility, [**`OrioleDB`**](https://pigsty.io/docs/kernel/orioledb/) for extreme OLTP performance, and so on...
437442

438-
<details><summary>Example: Babelfish Cluster (MSSQL Compatible)</summary><br>
443+
<details><summary>Example: Babelfish Cluster (MsSQL Compatible)</summary><br>
439444

440445
The [`conf/mssql.yml`](https://github.com/pgsty/pigsty/blob/main/conf/mssql.yml) Provision a [Babelfish](https://pigsty.io/docs/kernel/babelfish/) cluster with Microsoft SQL Server compatibility:
441446

@@ -526,9 +531,56 @@ pg-ivory:
526531
</details>
527532

528533

534+
<details><summary>Example: OpenHalo Cluster (MySQL Compatible)</summary><br>
535+
536+
The [`conf/mysql.yml`](https://github.com/pgsty/pigsty/blob/main/conf/mysql.yml) Provision a [openHalo](https://pigsty.io/docs/kernel/openhalo/) cluster with MySQL compatibility:
537+
538+
```yaml
539+
pg-mysql:
540+
hosts:
541+
10.10.10.11: { pg_seq: 1 ,pg_role: primary }
542+
10.10.10.12: { pg_seq: 2 ,pg_role: replica }
543+
10.10.10.13: { pg_seq: 3 ,pg_role: replica }
544+
vars:
545+
pg_cluster: pg-mysql
546+
pg_mode: mysql
547+
pg_version: 14
548+
pg_databases: [{name: postgres, extensions: [aux_mysql]}]
549+
repo_extra_packages: [ openhalodb ]
550+
pg_packages: [ openhalodb, pgsql-common ]
551+
```
552+
553+
</details>
554+
555+
556+
<details><summary>Example: OrioleDB Cluster (Extreme OLTP)</summary><br>
557+
558+
The [`conf/oriole.yml`](https://github.com/pgsty/pigsty/blob/main/conf/oriole.yml) Provision a [OrioleDB](https://pigsty.io/docs/kernel/oriole/) cluster with another storage engine:
559+
560+
```yaml
561+
pg-oriole:
562+
hosts:
563+
10.10.10.11: { pg_seq: 1 ,pg_role: primary }
564+
10.10.10.12: { pg_seq: 2 ,pg_role: replica }
565+
10.10.10.13: { pg_seq: 3 ,pg_role: replica }
566+
vars:
567+
pg_cluster: pg-oriole
568+
pg_mode: oriole
569+
pg_version: 17
570+
pg_databases: [{name: meta, extensions: [orioledb]}]
571+
pg_packages: [ orioledb, pgsql-common ]
572+
repo_extra_packages: [ orioledb ]
573+
pg_libs: 'orioledb, pg_stat_statements, auto_explain'
574+
```
575+
576+
</details>
577+
578+
579+
--------
580+
529581
You can also wrap existing kernel with add-ons: horizontal sharding with [**`CITUS`**](https://pigsty.io/docs/kernel/citus/),
530582
or self-hosting firebase alternative [**`SUPABASE`**](https://pigsty.io/docs/app/supabase/),
531-
or run enterprise-grade software like [**Odoo**](https://pigsty.io/docs/app/odoo) & [**Dify**](https://pigsty.io/docs/app/dify), ...
583+
or run enterprise-grade software like [**`Odoo`**](https://pigsty.io/docs/app/odoo) & [**`Dify`**](https://pigsty.io/docs/app/dify), ...
532584

533585
<details><summary>Example: Citus Distributed Cluster: 10-Node</summary><br>
534586

@@ -643,9 +695,8 @@ There are other pro, beta, or pilot modules, and there will be more coming in th
643695
[![IVORYSQL](https://img.shields.io/badge/IVORYSQL-%23E8AC52?style=flat&logo=postgresql&labelColor=E8AC52&logoColor=black)](https://pigsty.io/docs/kernel/ivorysql)
644696
[![GREENPLUM](https://img.shields.io/badge/GREENPLUM-%23578B09?style=flat&logo=postgresql&labelColor=578B09&logoColor=black)](https://pigsty.io/docs/kernel/greenplum)
645697
[![CLOUDBERRY](https://img.shields.io/badge/CLOUDBERRY-orange?style=flat&logo=postgresql&labelColor=orange&logoColor=black)](https://pigsty.io/docs/kernel/cloudberry)
646-
[![NEON](https://img.shields.io/badge/NEON-%2366D9C6?style=flat&logo=postgresql&labelColor=66D9C6&logoColor=black)](https://pigsty.io/docs/kernel/neon)
698+
[![HALO](https://img.shields.io/badge/HALO-%2366D9C6?style=flat&logo=postgresql&labelColor=66D9C6&logoColor=black)](https://pigsty.io/docs/kernel/openhalo)
647699
[![SUPABASE](https://img.shields.io/badge/SUPABASE-%233FCF8E?style=flat&logo=supabase&labelColor=3FCF8E&logoColor=white)](https://pigsty.io/docs/kernel/supabase)
648-
649700
[![KAFKA](https://img.shields.io/badge/KAFKA-%23231F20?style=flat&logo=apachekafka&labelColor=231F20&logoColor=white)](https://pigsty.io/docs/pro/kafka)
650701
[![MYSQL](https://img.shields.io/badge/MYSQL-%234479A1?style=flat&logo=mysql&labelColor=4479A1&logoColor=white)](https://pigsty.io/docs/pro/kafka)
651702
[![DUCKDB](https://img.shields.io/badge/DUCKDB-%23FFF000?style=flat&logo=duckdb&labelColor=FFF000&logoColor=white)](https://pigsty.io/docs/pro/duckdb)

0 commit comments

Comments
 (0)