云原生 PostgresQL 集群 - PGO：五分鐘快速上手

作者：為少 2022-02-23 20:38:32

云計(jì)算

云原生 本篇帶給大家五分鐘快速安裝并創(chuàng)建PostgreSQL 集群的相關(guān)內(nèi)容，希望能夠幫助到你！

十余年的曲江網(wǎng)站建設(shè)經(jīng)驗(yàn)，針對(duì)設(shè)計(jì)、前端、開(kāi)發(fā)、售后、文案、推廣等六對(duì)一服務(wù)，響應(yīng)快，48小時(shí)及時(shí)工作處理。成都營(yíng)銷網(wǎng)站建設(shè)的優(yōu)勢(shì)是能夠根據(jù)用戶設(shè)備顯示端的尺寸不同，自動(dòng)調(diào)整曲江建站的顯示方式，使網(wǎng)站能夠適用不同顯示終端，在瀏覽器中調(diào)整網(wǎng)站的寬度，無(wú)論在任何一種瀏覽器上瀏覽網(wǎng)站，都能展現(xiàn)優(yōu)雅布局與設(shè)計(jì)，從而大程度地提升瀏覽體驗(yàn)。創(chuàng)新互聯(lián)從事“曲江網(wǎng)站設(shè)計(jì)”,“曲江網(wǎng)站推廣”以來(lái)，每個(gè)客戶項(xiàng)目都認(rèn)真落實(shí)執(zhí)行。

前提條件

請(qǐng)確保您的主機(jī)上安裝了以下實(shí)用程序：

• kubectl
• git

安裝

第 1 步：下載示例

首先，轉(zhuǎn)到 GitHub 并 fork Postgres Operator 示例存儲(chǔ)庫(kù)：

https://github.com/CrunchyData/postgres-operator-examples/fork

一旦你分叉了這個(gè) repo，你可以使用類似下面的命令將它下載到你的工作環(huán)境中：

YOUR_GITHUB_UN=""
git clone --depth 1 "git@github.com:${YOUR_GITHUB_UN}/postgres-operator-examples.git"
cd postgres-operator-examples

第 2 步：安裝 PGO，即 Postgres Operator

您可以使用以下命令安裝 PGO，即來(lái)自 Crunchy Data 的 Postgres Operator：

kubectl apply -k kustomize/install

這將創(chuàng)建一個(gè)名為 postgres-operator 的命名空間，并創(chuàng)建部署 PGO 所需的所有對(duì)象。

要檢查安裝狀態(tài)，可以運(yùn)行以下命令：

kubectl -n postgres-operator get pods \
  --selector=postgres-operator.crunchydata.com/control-plane=postgres-operator \
  --field-selector=status.phase=Running

如果 PGO Pod 運(yùn)行良好，您應(yīng)該會(huì)看到類似于以下內(nèi)容的輸出：

NAME                                READY   STATUS    RESTARTS   AGE
postgres-operator-9dd545d64-t4h8d   1/1     Running   0          3s

創(chuàng)建 Postgres 集群

讓我們創(chuàng)建一個(gè)簡(jiǎn)單的 Postgres 集群。您可以通過(guò)執(zhí)行以下命令來(lái)執(zhí)行此操作：

kubectl apply -k kustomize/postgres

注意：

• 注意，你的集群已經(jīng)有一個(gè)默認(rèn)的 Storage Class

這將在 postgres-operator 命名空間中創(chuàng)建一個(gè)名為 hippo 的 Postgres 集群。您可以使用以下命令跟蹤集群的進(jìn)度：

kubectl -n postgres-operator describe postgresclusters.postgres-operator.crunchydata.com hippo

連接到 Postgres 集群

作為創(chuàng)建 Postgres 集群的一部分，Postgres Operator 創(chuàng)建一個(gè) PostgreSQL 用戶帳戶。此帳戶的憑據(jù)存儲(chǔ)在名為 -pguser- 的 Secret 中。

此 Secret 中的屬性提供了讓您登錄 PostgreSQL 集群的信息。這些包括：

• user: 用戶帳戶的名稱。
• password: 用戶帳戶的密碼。
• dbname: 默認(rèn)情況下用戶有權(quán)訪問(wèn)的數(shù)據(jù)庫(kù)的名稱。
• host: 數(shù)據(jù)庫(kù)主機(jī)的名稱。這引用了主 Postgres 實(shí)例的 Service。
• port: 數(shù)據(jù)庫(kù)正在偵聽(tīng)的端口。
• uri: 一個(gè) PostgreSQL 連接 URI，它提供了登錄 Postgres 數(shù)據(jù)庫(kù)的所有信息。
• jdbc-uri: 一個(gè) PostgreSQL JDBC 連接 URI，它提供了通過(guò) JDBC driver 登錄到 Postgres 數(shù)據(jù)庫(kù)的所有信息。

如果您使用 PgBouncer 連接池部署 Postgres 集群，則用戶 Secret 中會(huì)填充其他值，包括：

• pgbouncer-host: PgBouncer 連接池的主機(jī)名。這引用了 PgBouncer 連接池的 Service。
• pgbouncer-port: PgBouncer 連接池正在偵聽(tīng)的端口。
• pgbouncer-uri: 一個(gè) PostgreSQL 連接 URI，它提供了通過(guò) PgBouncer 連接池登錄到 Postgres 數(shù)據(jù)庫(kù)的所有信息。
• pgbouncer-jdbc-uri: 一個(gè) PostgreSQL JDBC 連接 URI，它提供了使用 JDBC driver 通過(guò) PgBouncer 連接池登錄到 Postgres 數(shù)據(jù)庫(kù)的所有信息。

請(qǐng)注意，所有連接都使用 TLS。PGO 為您的 Postgres 集群設(shè)置 PKI。您也可以選擇自帶 PKI / certificate authority;這將在文檔后面介紹。

PgBouncer

• https://www.pgbouncer.org/

通過(guò)終端中的 psql 連接

直接連接

如果您與 PostgreSQL 集群位于同一網(wǎng)絡(luò)上，則可以使用以下命令直接連接到它：

psql $(kubectl -n postgres-operator get secrets hippo-pguser-hippo -o go-template='{{.data.uri | base64decode}}')

使用端口轉(zhuǎn)發(fā)連接

在新終端中，創(chuàng)建一個(gè)端口轉(zhuǎn)發(fā)：

PG_CLUSTER_PRIMARY_POD=$(kubectl get pod -n postgres-operator -o name \
  -l postgres-operator.crunchydata.com/cluster=hippo,postgres-operator.crunchydata.com/role=master)
kubectl -n postgres-operator port-forward "${PG_CLUSTER_PRIMARY_POD}" 5432:5432

建立與 PostgreSQL 集群的連接。

PG_CLUSTER_USER_SECRET_NAME=hippo-pguser-hippo

PGPASSWORD=$(kubectl get secrets -n postgres-operator "${PG_CLUSTER_USER_SECRET_NAME}" -o go-template='{{.data.password | base64decode}}') \
PGUSER=$(kubectl get secrets -n postgres-operator "${PG_CLUSTER_USER_SECRET_NAME}" -o go-template='{{.data.user | base64decode}}') \
PGDATABASE=$(kubectl get secrets -n postgres-operator "${PG_CLUSTER_USER_SECRET_NAME}" -o go-template='{{.data.dbname | base64decode}}') \
psql -h localhost

實(shí)戰(zhàn) Keycloak 連接 PostgreSQL 集群

用戶 Secret 中提供的信息將允許您將應(yīng)用程序直接連接到您的 PostgreSQL 數(shù)據(jù)庫(kù)。

例如，讓我們連接 Keycloak。Keycloak 是一種流行的開(kāi)源身份管理工具，由 PostgreSQL 數(shù)據(jù)庫(kù)支持。使用我們創(chuàng)建的 hippo 集群，我們可以部署以下清單文件：

Keycloak

• https://www.keycloak.org/

cat <> keycloak.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: keycloak
  namespace: postgres-operator
  labels:
    app.kubernetes.io/name: keycloak
spec:
  selector:
    matchLabels:
      app.kubernetes.io/name: keycloak
  template:
    metadata:
      labels:
        app.kubernetes.io/name: keycloak
    spec:
      containers:
      - image: quay.io/keycloak/keycloak:latest
        name: keycloak
        args: ["start-dev"]
        env:
        - name: DB_VENDOR
          value: "postgres"
        - name: DB_ADDR
          valueFrom: { secretKeyRef: { name: hippo-pguser-hippo, key: host } }
        - name: DB_PORT
          valueFrom: { secretKeyRef: { name: hippo-pguser-hippo, key: port } }
        - name: DB_DATABASE
          valueFrom: { secretKeyRef: { name: hippo-pguser-hippo, key: dbname } }
        - name: DB_USER
          valueFrom: { secretKeyRef: { name: hippo-pguser-hippo, key: user } }
        - name: DB_PASSWORD
          valueFrom: { secretKeyRef: { name: hippo-pguser-hippo, key: password } }
        - name: KEYCLOAK_ADMIN
          value: "admin"
        - name: KEYCLOAK_ADMIN_PASSWORD
          value: "admin"
        - name: PROXY_ADDRESS_FORWARDING
          value: "true"
        ports:
        - name: http
          containerPort: 8080
        - name: https
          containerPort: 8443
      restartPolicy: Always
EOF
kubectl apply -f keycloak.yaml
kubectl -n postgres-operator port-forward ${KEYCLOAK_POD} 8086:8080 --address='0.0.0.0'
# Forwarding from 0.0.0.0:8086 -> 8080

轉(zhuǎn)到 http://127.0.0.1:8086

在 kustomize/keycloak 文件夾中有一個(gè)關(guān)于如何使用 Postgres Operator 部署 Keycloak 的完整示例。

注意：

• quay.io/keycloak/keycloak:latest，科學(xué)拉取鏡像
• 對(duì) keycloak.yaml 進(jìn)行了上述修改

恭喜，您的 Postgres 集群已啟動(dòng)并運(yùn)行，還連接了一個(gè)應(yīng)用程序!

您可以通過(guò)文檔和 kubectl explain 了解有關(guān) postgresclusters 自定義資源定義的更多信息，即：

kubectl explain postgresclusters

postgresclusters 自定義資源定義

• https://access.crunchydata.com/documentation/postgres-operator/5.0.4/references/crd/

分享文章：云原生PostgreSQL集群-PGO：五分鐘快速上手
鏈接地址：http://www.dlmjj.cn/article/dpesgis.html