PostgreSQL標準軟件基于Bitnami PostgreSQL 構(gòu)建。當前版本為16.1.0
你可以通過輕云UC部署工具直接安裝部署,也可以手動按如下文檔操作,該項目已經(jīng)全面開源,可以從如下環(huán)境獲取
配置文件地址: https://gitee.com/qingplus/qingcloud-platform
簡介
PostgreSQL是一個功能強大的開源對象關(guān)系型數(shù)據(jù)庫系統(tǒng),他使用和擴展了SQL語言,并結(jié)合了許多安全存儲和擴展最復(fù)雜數(shù)據(jù)工作負載的功能。PostgreSQL 具有可靠性、安全性和可擴展性,并且它具有豐富的可用工具生態(tài)系統(tǒng),因此開發(fā)者將 PostgreSQL 用于各種用例。該軟件在設(shè)計上與所有主流操作系統(tǒng)(包括 Linux、Windows 和 Macintosh)兼容,并支持文本、圖像、聲音和視頻,這使其成為具有多樣化需求的人員和公司的常用數(shù)據(jù)庫。PostgreSQL 被普遍認為是僅次于 MySQL 的開發(fā)者最喜歡的數(shù)據(jù)庫技術(shù)。
連接到其他容器
使用Docker 容器網(wǎng)絡(luò),應(yīng)用程序容器可以輕松訪問容器內(nèi)運行的 PostgreSQL 服務(wù)器。
連接到同一網(wǎng)絡(luò)的容器可以使用容器名稱作為主機名來相互通信。
使用命令行
在此示例中,我們將創(chuàng)建一個 PostgreSQL 客戶端實例,該實例將連接到與客戶端在同一 docker 網(wǎng)絡(luò)上運行的服務(wù)器實例。
第 1 步:創(chuàng)建網(wǎng)絡(luò)
docker network create app-tier --driver bridge
步驟 2:啟動 PostgreSQL 服務(wù)器實例
使用命令--network app-tier的參數(shù)docker run將 PostgreSQL 容器連接到網(wǎng)絡(luò)app-tier。
docker run -d --name postgresql-server \
--network app-tier \
registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest
第 3 步:啟動 PostgreSQL 客戶端實例
最后,我們創(chuàng)建一個新的容器實例來啟動 PostgreSQL 客戶端并連接到上一步中創(chuàng)建的服務(wù)器:
docker run -it --rm \
--network app-tier \
registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest psql -h postgresql-server -U postgres
使用 Docker Compose 文件
如果未指定,Docker Compose 會自動設(shè)置一個新網(wǎng)絡(luò)并將所有已部署的服務(wù)附加到該網(wǎng)絡(luò)。但是,我們將顯式定義一個bridge名為 的新網(wǎng)絡(luò)app-tier。在此示例中,我們假設(shè)您希望從您自己的自定義應(yīng)用程序映像連接到 PostgreSQL 服務(wù)器,該映像在以下代碼片段中通過服務(wù)名稱進行標識myapp。
version: '2'
networks:
app-tier:
driver: bridge
services:
postgresql:
image: 'registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest'
networks:
- app-tier
myapp:
image: 'YOUR_APPLICATION_IMAGE'
networks:
- app-tier
重要:
替換YOUR_APPLICATION_IMAGE占位符
在您的應(yīng)用程序容器中,使用主機名postgresql連接到 PostgreSQL 服務(wù)器
啟動容器:
docker-compose up -d
配置
容器啟動時
當容器執(zhí)行時,初始化或啟動postgresql之前,它會執(zhí)行位于/docker-entrypoint-preinitdb.d的擴展名為.sh的文件。
為了將自定義文件放入 docker 映像中,您可以將它們安裝為卷。
將額外的命令行標志傳遞給 PostgreSQL
可以通過以下環(huán)境變量將額外的命令行標志傳遞給 postgresql 服務(wù)命令:
- POSTGRESQL_EXTRA_FLAGS:要附加到postgres啟動命令的標志。無默認值
初始化一個新實例
當容器第一次執(zhí)行時,它將執(zhí)行擴展名為.sh, .sql 和 .sql.gz的文件,位于/docker-entrypoint-initdb.d目錄下.
為了將自定義文件放入 docker 映像中,您可以將它們安裝為卷。
首次運行時設(shè)置 root 密碼
在上面的命令中您可能已經(jīng)注意到環(huán)境變量的使用POSTGRESQL_PASSWORD。首次運行映像時傳遞環(huán)境變量POSTGRESQL_PASSWORD會將postgres用戶的密碼設(shè)置為POSTGRESQL_PASSWORD的值(或POSTGRESQL_PASSWORD_FILE變量中指定的文件的內(nèi)容)。
docker run --name postgresql -e POSTGRESQL_PASSWORD=password123 registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest
或者通過修改docker-compose.yml文件:
services:
postgresql:
...
environment:
- POSTGRESQL_PASSWORD=password123
...
注意! 該postgres用戶是超級用戶,擁有 PostgreSQL 數(shù)據(jù)庫的完全管理訪問權(quán)限。
首次運行時創(chuàng)建數(shù)據(jù)庫
POSTGRESQL_DATABASE通過在第一次運行鏡像時傳遞環(huán)境變量,將創(chuàng)建一個數(shù)據(jù)庫。如果您的應(yīng)用程序要求數(shù)據(jù)庫已存在,這非常有用,使您不必使用 PostgreSQL 客戶端手動創(chuàng)建數(shù)據(jù)庫。
docker run --name postgresql -e POSTGRESQL_DATABASE=my_database registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest
或者通過修改docker-compose.yml文件:
services:
postgresql:
...
environment:
- POSTGRESQL_DATABASE=my_database
...
首次運行時創(chuàng)建數(shù)據(jù)庫用戶
您還可以創(chuàng)建一個受限數(shù)據(jù)庫用戶,該用戶僅具有使用環(huán)境變量創(chuàng)建的數(shù)據(jù)庫的權(quán)限POSTGRESQL_DATABASE。為此,請?zhí)峁㏄OSTGRESQL_USERNAME環(huán)境變量。
docker run --name postgresql -e POSTGRESQL_USERNAME=my_user -e POSTGRESQL_PASSWORD=password123 -e POSTGRESQL_DATABASE=my_database registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest
或者通過修改docker-compose.yml文件:
services:
postgresql:
...
environment:
- POSTGRESQL_USERNAME=my_user
- POSTGRESQL_PASSWORD=password123
- POSTGRESQL_DATABASE=my_database
...
注意!POSTGRESQL_USERNAME指定后,postgres user不會分配密碼,因此您無法以該postgres用戶身份遠程登錄 PostgreSQL 服務(wù)器。如果您仍想使用用戶postgres進行訪問,請設(shè)置POSTGRESQL_POSTGRES_PASSWORD環(huán)境變量(或POSTGRESQL_POSTGRES_PASSWORD_FILE指定文件中內(nèi)容)。
審計
PostgreSQL image默認啟用 pgAudit 模塊。因此,可以使用以下環(huán)境變量在容器中啟用審核信息:
- POSTGRESQL_PGAUDIT_LOG:以逗號分隔的列表,其中包含要審核的不同操作。沒有默認值。
- POSTGRESQL_PGAUDIT_LOG_CATALOG:在語句中的所有關(guān)系都在 pg_catalog 中的情況下啟用會話日志記錄。沒有默認值。
- POSTGRESQL_LOG_CONNECTIONS:添加登錄日志條目。沒有默認值。
- POSTGRESQL_LOG_DISCONNECTIONS:添加注銷日志條目。沒有默認值。
- POSTGRESQL_LOG_HOSTNAME:記錄客戶端主機名。沒有默認值。
- POSTGRESQL_LOG_LINE_PREFIX:定義日志條目行的格式。在PostgreSQL 官方文檔中查找字符串參數(shù)。沒有默認值。
- POSTGRESQL_LOG_TIMEZONE:設(shè)置日志條目時間戳的時區(qū)。沒有默認值。
會話設(shè)置
PostgreSQL 映像允許配置多個連接和會話管理參數(shù):
- POSTGRESQL_USERNAME_CONNECTION_LIMIT:如果創(chuàng)建了不同的用戶postgres,請設(shè)置連接限制。沒有默認值。
- POSTGRESQL_POSTGRES_CONNECTION_LIMIT:設(shè)置用戶的連接限制postgres。沒有默認值。
- POSTGRESQL_STATEMENT_TIMEOUT:設(shè)置語句超時時間。沒有默認值。
- POSTGRESQL_TCP_KEEPALIVES_INTERVAL:TCP ?;铋g隔。沒有默認值。
- POSTGRESQL_TCP_KEEPALIVES_IDLE:TCP keepalive 空閑時間。沒有默認值。
- POSTGRESQL_TCP_KEEPALIVES_COUNT:TCP ?;钣嫈?shù)。沒有默認值。
配置時區(qū)
PostgreSQL 映像允許使用以下環(huán)境變量配置 PostgreSQL 的時區(qū):
- POSTGRESQL_TIMEZONE:設(shè)置顯示和解釋時間戳的時區(qū)。
- POSTGRESQL_LOG_TIMEZONE:設(shè)置寫入服務(wù)器日志的時間戳所使用的時區(qū)。
修改pg_hba.conf
默認情況下,PostgreSQL image會生成local、md5 在pg_hba.conf文件。為了適應(yīng)任何其他要求或標準,可以通過以下方式更改 pg_hba.conf 文件:
- 掛載你自己的pg_hba.conf 到文件/bitnami/postgresql/conf
- POSTGRESQL_PGHBA_REMOVE_FILTERS將與以逗號分隔的模式列表一起使用。所有與任何模式匹配的行都將被刪除。例如,如果我們想要刪除所有l(wèi)ocal和md5驗證(例如,僅支持hostssl連接),請設(shè)置POSTGRESQL_PGHBA_REMOVE_FILTERS=local, md5.
預(yù)加載共享庫
可以通過設(shè)置 .postgresql 文件來修改 PostgreSQL 在啟動時預(yù)加載的庫列表POSTGRESQL_SHARED_PRELOAD_LIBRARIES。默認值為POSTGRESQL_SHARED_PRELOAD_LIBRARIES=pgaudit。例如,如果您想將pg_stat_statements庫添加到預(yù)加載中,請設(shè)置POSTGRESQL_SHARED_PRELOAD_LIBRARIES=pgaudit, pg_stat_statements。
設(shè)置流式復(fù)制
可以使用以下環(huán)境變量設(shè)置流復(fù)制集群:
- POSTGRESQL_REPLICATION_MODE:復(fù)制模式??赡艿闹祄aster/ slave。沒有默認值。
- POSTGRESQL_REPLICATION_USER:首次運行時在主服務(wù)器上創(chuàng)建的復(fù)制用戶。沒有默認值。
- POSTGRESQL_REPLICATION_PASSWORD:復(fù)制用戶密碼。沒有默認值。
- POSTGRESQL_REPLICATION_PASSWORD_FILE:包含復(fù)制用戶密碼的文件的路徑。這將覆蓋 中指定的值POSTGRESQL_REPLICATION_PASSWORD。沒有默認值。
- POSTGRESQL_MASTER_HOST:復(fù)制主機的主機名/IP(從機參數(shù))。沒有默認值。
- POSTGRESQL_MASTER_PORT_NUMBER:復(fù)制主機的服務(wù)器端口(從機參數(shù))。默認為5432.
在復(fù)制集群中,您可以擁有一個主服務(wù)器和零個或多個從服務(wù)器。啟用復(fù)制后,主節(jié)點處于讀寫模式,而從節(jié)點處于只讀模式。為了獲得最佳性能,建議限制對從屬設(shè)備的讀取。
第 1 步:創(chuàng)建復(fù)制主服務(wù)器
第一步是啟動master。
docker run --name postgresql-master \
-e POSTGRESQL_REPLICATION_MODE=master \
-e POSTGRESQL_USERNAME=my_user \
-e POSTGRESQL_PASSWORD=password123 \
-e POSTGRESQL_DATABASE=my_database \
-e POSTGRESQL_REPLICATION_USER=my_repl_user \
-e POSTGRESQL_REPLICATION_PASSWORD=my_repl_password \
registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest
在此命令中,我們使用參數(shù)將容器配置為主容器POSTGRESQL_REPLICATION_MODE=master。POSTGRESQL_REPLICATION_USER使用和參數(shù)指定復(fù)制用戶POSTGRESQL_REPLICATION_PASSWORD。
第2步:創(chuàng)建復(fù)制從站
接下來我們啟動一個復(fù)制從屬容器。
docker run --name postgresql-slave \
--link postgresql-master:master \
-e POSTGRESQL_REPLICATION_MODE=slave \
-e POSTGRESQL_MASTER_HOST=master \
-e POSTGRESQL_MASTER_PORT_NUMBER=5432 \
-e POSTGRESQL_REPLICATION_USER=my_repl_user \
-e POSTGRESQL_REPLICATION_PASSWORD=my_repl_password \
registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest
在上面的命令中,容器被配置為slave使用POSTGRESQL_REPLICATION_MODE參數(shù)。在復(fù)制從屬啟動之前,從屬容器使用POSTGRESQL_MASTER_HOST和POSTGRESQL_MASTER_PORT_NUMBER參數(shù)連接到主服務(wù)器并從主服務(wù)器復(fù)制初始數(shù)據(jù)庫。POSTGRESQL_REPLICATION_PASSWORD和POSTGRESQL_REPLICATION_USER用于向主服務(wù)器進行身份驗證。為了更改pg_hba.conf默認設(shè)置,從站需要知道是否POSTGRESQL_PASSWORD已設(shè)置。
通過這兩個命令,您現(xiàn)在已經(jīng)啟動并運行了一個兩節(jié)點 PostgreSQL 主從流復(fù)制集群。您可以通過添加/刪除從屬服務(wù)器來擴展集群,而不會導(dǎo)致任何停機。
注意:集群會完整復(fù)制主節(jié)點,其中包括所有用戶和數(shù)據(jù)庫。
如果主服務(wù)器出現(xiàn)故障,您可以重新配置從服務(wù)器以充當主服務(wù)器,并通過創(chuàng)建觸發(fā)器文件開始接受寫入/tmp/postgresql.trigger.5432。例如,以下命令重新配置postgresql-slave為充當主服務(wù)器:
docker exec postgresql-slave touch /tmp/postgresql.trigger.5432
注意:集群中其他從站的配置需要更新,以便它們知道新的主站。--link postgresql-slave:master這將要求您按照我們的示例重新啟動其他從站。
通過 Docker Compose,可以使用以下命令設(shè)置主從復(fù)制:
version: '2'
services:
postgresql-master:
image: 'registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest'
ports:
- '5432'
volumes:
- 'postgresql_master_data:/bitnami/postgresql'
environment:
- POSTGRESQL_REPLICATION_MODE=master
- POSTGRESQL_REPLICATION_USER=repl_user
- POSTGRESQL_REPLICATION_PASSWORD=repl_password
- POSTGRESQL_USERNAME=my_user
- POSTGRESQL_PASSWORD=my_password
- POSTGRESQL_DATABASE=my_database
postgresql-slave:
image: 'registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest'
ports:
- '5432'
depends_on:
- postgresql-master
environment:
- POSTGRESQL_REPLICATION_MODE=slave
- POSTGRESQL_REPLICATION_USER=repl_user
- POSTGRESQL_REPLICATION_PASSWORD=repl_password
- POSTGRESQL_MASTER_HOST=postgresql-master
- POSTGRESQL_PASSWORD=my_password
- POSTGRESQL_MASTER_PORT_NUMBER=5432
volumes:
postgresql_master_data:
使用以下方法擴展從站數(shù)量:
docker-compose up --detach --scale postgresql-master=1 --scale postgresql-slave=3
上面的命令將 Slave 的數(shù)量增加到3。您可以用同樣的方法縮小規(guī)模。
注意:您不應(yīng)增加/減少主節(jié)點的數(shù)量。始終只有一個主節(jié)點運行。
同步提交
默認情況下,從屬實例配置為異步復(fù)制。為了保證更多的數(shù)據(jù)穩(wěn)定性(以一些性能為代價),可以使用以下環(huán)境設(shè)置同步提交(即事務(wù)提交在被寫入一組副本之前不會向客戶端返回成功)變量。
- POSTGRESQL_SYNCHRONOUS_COMMIT_MODE:建立同步提交的類型??捎眠x項有:
on,remote_apply,remote_write,localandoff。默認值為on。 - POSTGRESQL_NUM_SYNCHRONOUS_REPLICAS:建立將啟用同步復(fù)制的副本數(shù)量。該數(shù)量不得超過您在集群中配置的從站數(shù)量。
使用 Docker Compose,可以按如下方式設(shè)置具有同步提交的主從復(fù)制:
version: '2'
services:
postgresql-master:
image: 'registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest'
ports:
- '5432'
volumes:
- 'postgresql_master_data:/bitnami/postgresql'
environment:
- POSTGRESQL_REPLICATION_MODE=master
- POSTGRESQL_REPLICATION_USER=repl_user
- POSTGRESQL_REPLICATION_PASSWORD=repl_password
- POSTGRESQL_USERNAME=my_user
- POSTGRESQL_PASSWORD=my_password
- POSTGRESQL_DATABASE=my_database
- POSTGRESQL_SYNCHRONOUS_COMMIT_MODE=on
- POSTGRESQL_NUM_SYNCHRONOUS_REPLICAS=1
volumes:
- '/path/to/postgresql-persistence:/bitnami/postgresql'
postgresql-slave:
image: 'registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest'
ports:
- '5432'
depends_on:
- postgresql-master
environment:
- POSTGRESQL_REPLICATION_MODE=slave
- POSTGRESQL_REPLICATION_USER=repl_user
- POSTGRESQL_REPLICATION_PASSWORD=repl_password
- POSTGRESQL_MASTER_HOST=postgresql-master
- POSTGRESQL_MASTER_PORT_NUMBER=5432
postgresql-slave2:
image: 'registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest'
ports:
- '5432'
depends_on:
- postgresql-master
environment:
- POSTGRESQL_REPLICATION_MODE=slave
- POSTGRESQL_REPLICATION_USER=repl_user
- POSTGRESQL_REPLICATION_PASSWORD=repl_password
- POSTGRESQL_MASTER_HOST=postgresql-master
- POSTGRESQL_MASTER_PORT_NUMBER=5432
在上面的示例中,提交需要寫入主服務(wù)器和從服務(wù)器之一才能被接受。另一個從站將繼續(xù)使用異步復(fù)制。使用以下 SQL 查詢檢查它:
postgres=# select application_name as server, state,
postgres-# sync_priority as priority, sync_state
postgres-# from pg_stat_replication;
| server | state | priority | sync_state |
|-------------|-----------|----------|------------|
| walreceiver | streaming | 0 | sync |
| walreceiver | streaming | 0 | async |
注意:對于更高級的設(shè)置,您可以application_name通過設(shè)置POSTGRESQL_CLUSTER_APP_NAME環(huán)境變量來使用參數(shù)定義不同的復(fù)制組。
LDAP認證
為了使用 LDAP 身份驗證,您需要將環(huán)境變量設(shè)置POSTGRESQL_ENABLE_LDAP為yes來啟用它。
有兩種設(shè)置 LDAP 配置的方法:
通過配置POSTGRESQL_LDAP_URL,您可以在其中配置URL中的所有關(guān)聯(lián)參數(shù)。
獨立設(shè)置參數(shù)POSTGRESQL_LDAP_xxxx。
LDAP相關(guān)參數(shù)有:POSTGRESQL_LDAP_SERVER:要連接的 LDAP 服務(wù)器的 IP 地址或名稱。用空格分隔。
POSTGRESQL_LDAP_PORT:LDAP 服務(wù)器上要連接的端口號
POSTGRESQL_LDAP_SCHEME:設(shè)置為ldaps使用 LDAPS。默認為無。
POSTGRESQL_LDAP_TLS:設(shè)置為1使用 TLS 加密。默認為無。
POSTGRESQL_LDAP_PREFIX:形成要綁定的 DN 時要添加到用戶名前面的字符串。默認為無。
POSTGRESQL_LDAP_SUFFIX:形成要綁定的 DN 時附加到用戶名的字符串。默認為無。
POSTGRESQL_LDAP_BASE_DN:開始搜索用戶的根 DN。默認為無。
POSTGRESQL_LDAP_BIND_DN:要綁定到 LDAP 的用戶的 DN。默認為無。
POSTGRESQL_LDAP_BIND_PASSWORD:綁定LDAP的用戶密碼。默認為無。
POSTGRESQL_LDAP_SEARCH_ATTR:與搜索中的用戶名匹配的屬性。默認為無。
POSTGRESQL_LDAP_SEARCH_FILTER:進行搜索+綁定身份驗證時使用的搜索過濾器。默認為無。
POSTGRESQL_LDAP_URL:要連接的 URL,格式為:ldap[s]://host[:port]/basedn[?[attribute][?[scope][?[filter]]]]。
保護 PostgreSQL 流量
PostgreSQL 支持使用 SSL/TLS 協(xié)議對連接進行加密。如果您希望啟用此可選功能,您可以使用以下環(huán)境變量來配置應(yīng)用程序:
- POSTGRESQL_ENABLE_TLS:是否對流量啟用 TLS。默認為no.
- POSTGRESQL_TLS_CERT_FILE:包含 TLS 流量證書文件的文件。沒有默認值。
- POSTGRESQL_TLS_KEY_FILE:包含證書密鑰的文件。沒有默認值。
- POSTGRESQL_TLS_CA_FILE:包含證書 CA 的文件。如果提供,PostgreSQL 將通過請求證書來驗證 TLS/SSL 客戶端(請參閱ref)。沒有默認值。
- POSTGRESQL_TLS_CRL_FILE:包含證書吊銷列表的文件。沒有默認值。
- POSTGRESQL_TLS_PREFER_SERVER_CIPHERS:是否使用服務(wù)器的 TLS 密碼首選項而不是客戶端的。默認為yes.
啟用 TLS 時,PostgreSQL 默認情況下將支持標準流量和加密流量,但更喜歡后者。下面是一些有關(guān)如何快速設(shè)置 TLS 流量的示例:
使用docker run
```console
$ docker run \
-v /path/to/certs:/opt/bitnami/postgresql/certs \
-e ALLOW_EMPTY_PASSWORD=yes \
-e POSTGRESQL_ENABLE_TLS=yes \
-e POSTGRESQL_TLS_CERT_FILE=/opt/bitnami/postgresql/certs/postgres.crt \
-e POSTGRESQL_TLS_KEY_FILE=/opt/bitnami/postgresql/certs/postgres.key \
registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest
```
修改docker-compose.yml文件:
```yaml
services:
postgresql:
...
environment:
...
- POSTGRESQL_ENABLE_TLS=yes
- POSTGRESQL_TLS_CERT_FILE=/opt/bitnami/postgresql/certs/postgres.crt
- POSTGRESQL_TLS_KEY_FILE=/opt/bitnami/postgresql/certs/postgres.key
...
volumes:
...
- /path/to/certs:/opt/bitnami/postgresql/certs
...
```
或者,您也可以在自定義配置文件中提供此配置。
配置文件
該圖像在 中查找postgresql.conf文件/opt/bitnami/postgresql/conf/。您可以在以下位置安裝卷/bitnami/postgresql/conf/并復(fù)制/編輯. 如果該目錄為空,則默認配置將被填充到該目錄中。postgresql.conf/path/to/postgresql-persistence/conf/conf/
/path/to/postgresql-persistence/conf/
└── postgresql.conf
0 directories, 1 file
由于 PostgreSQL 映像是非 root 的,因此您需要為主機中的掛載目錄設(shè)置適當?shù)臋?quán)限:
sudo chown 1001:1001 /path/to/postgresql-persistence/conf/
第 1 步:運行 PostgreSQL 映像
運行 PostgreSQL 映像,從主機安裝目錄。
docker run --name postgresql \
-v /path/to/postgresql-persistence/conf/:/bitnami/postgresql/conf/ \
registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest
或使用 Docker Compose:
version: '2'
services:
postgresql:
image: 'registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest'
ports:
- '5432:5432'
volumes:
- /path/to/postgresql-persistence/conf/:/bitnami/postgresql/conf/
第 2 步:編輯配置
使用您喜歡的編輯器編輯主機上的配置。
vi /path/to/postgresql-persistence/conf/postgresql.conf
第三步:重啟PostgreSQL
更改配置后,重新啟動 PostgreSQL 容器以使更改生效。
docker restart postgresql
或使用 Docker Compose:
docker-compose restart postgresql
有關(guān)配置選項的完整列表,請參閱服務(wù)器配置手冊。
允許從默認文件以外的文件加載設(shè)置postgresql.conf
除了使用自定義之外postgresql.conf,您還可以包含.conf以conf.d目錄結(jié)尾的文件/bitnami/postgresql/conf/。為此,默認postgresql.conf包含以下部分:
##------------------------------------------------------------------------------
## CONFIG FILE INCLUDES
##------------------------------------------------------------------------------
## These options allow settings to be loaded from files other than the
## default postgresql.conf.
include_dir = 'conf.d' # Include files ending in '.conf' from directory 'conf.d'
在您的主機中,您應(yīng)該在目錄下創(chuàng)建擴展配置文件conf.d:
mkdir -p /path/to/postgresql-persistence/conf/conf.d/
vi /path/to/postgresql-persistence/conf/conf.d/extended.conf
如果您使用自定義的postgresql.conf,您應(yīng)該在配置文件中創(chuàng)建(或取消注釋)上述部分,在這種情況下,/path/to/postgresql-persistence/conf/結(jié)構(gòu)應(yīng)該類似于
/path/to/postgresql-persistence/conf/
├── conf.d
│ └── extended.conf
└── postgresql.conf
1 directory, 2 files
指定 initdb 參數(shù)
使用以下環(huán)境變量可以輕松指定額外的 initdb 參數(shù):
- POSTGRESQL_INITDB_ARGS:指定 initdb 命令的額外參數(shù)。沒有默認值。
- POSTGRESQL_INITDB_WAL_DIR:定義事務(wù)日志的自定義位置。沒有默認值。
docker run --name postgresql \
-e POSTGRESQL_INITDB_ARGS="--data-checksums" \
-e POSTGRESQL_INITDB_WAL_DIR="/bitnami/waldir" \
registry.cn-hangzhou.aliyuncs.com/qingcloudtech/postgresql:latest
或者通過修改docker-compose.yml文件:
services:
postgresql:
...
environment:
- POSTGRESQL_INITDB_ARGS=--data-checksums
- POSTGRESQL_INITDB_WAL_DIR=/bitnami/waldir
...
停止設(shè)置
您可以使用以下命令控制初始化過程中用于停止 postgresql 的參數(shù):
- POSTGRESQL_PGCTLTIMEOUT這將設(shè)置命令的超時pg_ctl。
- POSTGRESQL_SHUTDOWN_MODE這將指示所使用的關(guān)閉模式。
安裝額外的語言環(huán)境
Dockerfile 提供了兩個參數(shù)來在構(gòu)建時配置額外的區(qū)域設(shè)置:
- WITH_ALL_LOCALES:啟用所有支持的區(qū)域設(shè)置。默認值:否
- EXTRA_LOCALES:要啟用的額外區(qū)域設(shè)置的逗號分隔列表。無默認值
例如,要構(gòu)建支持區(qū)域設(shè)置的映像es_ES.UTF-8 UTF-8,您可以將以下參數(shù)添加到構(gòu)建命令中:
docker build --build-arg EXTRA_LOCALES="es_ES.UTF-8 UTF-8" ...
環(huán)境變量別名
容器允許兩組不同的環(huán)境變量。請參閱下表中的環(huán)境變量別名列表:
| 環(huán)境變量 | 別名 |
|---|---|
| POSTGRESQL_USERNAME | POSTGRES_USER |
| POSTGRESQL_DATABASE | POSTGRES_DB |
| POSTGRESQL_PASSWORD | POSTGRES_PASSWORD |
| POSTGRESQL_PASSWORD_FILE | POSTGRES_PASSWORD_FILE |
| POSTGRESQL_POSTGRES_PASSWORD | POSTGRES_POSTGRES_PASSWORD |
| POSTGRESQL_POSTGRES_PASSWORD_FILE | POSTGRES_POSTGRES_PASSWORD_FILE |
| POSTGRESQL_PORT_NUMBER | POSTGRES_PORT_NUMBER |
| POSTGRESQL_INITDB_ARGS | POSTGRES_INITDB_ARGS |
| POSTGRESQL_INITDB_WAL_DIR | POSTGRES_INITDB_WAL_DIR |
| POSTGRESQL_DATA_DIR | PGDATA |
| POSTGRESQL_REPLICATION_USER | POSTGRES_REPLICATION_USER |
| POSTGRESQL_REPLICATION_MODE | POSTGRES_REPLICATION_MODE |
| POSTGRESQL_REPLICATION_PASSWORD | POSTGRES_REPLICATION_PASSWORD |
| POSTGRESQL_REPLICATION_PASSWORD_FILE | POSTGRES_REPLICATION_PASSWORD_FILE |
| POSTGRESQL_CLUSTER_APP_NAME | POSTGRES_CLUSTER_APP_NAME |
| POSTGRESQL_MASTER_HOST | POSTGRES_MASTER_HOST |
| POSTGRESQL_MASTER_PORT_NUMBER | POSTGRES_MASTER_PORT_NUMBER |
| POSTGRESQL_NUM_SYNCHRONOUS_REPLICAS | POSTGRES_NUM_SYNCHRONOUS_REPLICAS |
| POSTGRESQL_SYNCHRONOUS_COMMIT_MODE | POSTGRES_SYNCHRONOUS_COMMIT_MODE |
| POSTGRESQL_SHUTDOWN_MODE | POSTGRES_SHUTDOWN_MODE |
重要信息:更改POSTGRES_USER不會更改數(shù)據(jù)庫的所有者,數(shù)據(jù)庫的所有者將繼續(xù)作為用戶postgres。要更改數(shù)據(jù)庫所有者,請使用postgres用戶 ( $ psql -U postgres ...) 訪問并執(zhí)行以下命令:
alter database POSTGRES_DATABASE owner to POSTGRES_USER;
可以更改 PostgreSQL 用于執(zhí)行 init 腳本的用戶。為此,請使用以下環(huán)境變量:
| 環(huán)境變量 | 描述 |
|---|---|
| POSTGRESQL_INITSCRIPTS_USERNAME | 將用于執(zhí)行初始化腳本的用戶 |
| POSTGRESQL_INITSCRIPTS_PASSWORD | POSTGRESQL_INITSCRIPT_USERNAME 中指定的用戶的密碼 |
默認 toast 壓縮
默認的 toast 壓縮是pglz,但您可以通過將環(huán)境變量設(shè)置POSTGRES_DEFAULT_COMPRESSION為所需的值來修改它。例如:POSTGRES_DEFAULT_COMPRESSION='lz4'。
日志
docker logs postgresql
或使用 Docker Compose:
docker-compose logs postgresql
你可以通過輕云UC部署工具直接安裝部署,也可以手動按如下文檔操作,該項目已經(jīng)全面開源,可以從如下環(huán)境獲取