前提條件
請確保您的主機上安裝了以下實用程序:
kubectlgit安裝第 1 步:下載示例
首先,轉到 GitHub 并 fork Postgres Operator 示例存儲庫:
https://github.com/CrunchyData/postgres-operator-examples/fork
一旦你分叉了這個 repo,你可以使用類似下面的命令將它下載到你的工作環境中:
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,即來自 Crunchy Data 的 Postgres Operator:
kubectl apply -k kustomize/install
這將創建一個名為 postgres-operator 的命名空間,并創建部署 PGO 所需的所有對象。
要檢查安裝狀態,可以運行以下命令:
kubectl -n postgres-operator get pods
--selector=postgres-operator.crunchydata.com/control-plane=postgres-operator
--field-selector=status.phase=Running
如果 PGO Pod 運行良好,您應該會看到類似于以下內容的輸出:
NAME READY STATUS RESTARTS AGE
postgres-operator-9dd545d64-t4h8d 1/1 Running 0 3s創建 Postgres 集群
讓我們創建一個簡單的 Postgres 集群。您可以通過執行以下命令來執行此操作:
kubectl apply -k kustomize/postgres
注意:
注意,你的集群已經有一個默認的 Storage Class
這將在 postgres-operator 命名空間中創建一個名為 hippo 的 Postgres 集群。您可以使用以下命令跟蹤集群的進度:
kubectl -n postgres-operator describe postgresclusters.postgres-operator.crunchydata.com hippo連接到 Postgres 集群
作為創建 Postgres 集群的一部分,Postgres Operator 創建一個 PostgreSQL 用戶帳戶。此帳戶的憑據存儲在名為 -pguser- 的 Secret 中。
此 Secret 中的屬性提供了讓您登錄 PostgreSQL 集群的信息。這些包括:
user: 用戶帳戶的名稱。password: 用戶帳戶的密碼。dbname: 默認情況下用戶有權訪問的數據庫的名稱。host: 數據庫主機的名稱。這引用了主 Postgres 實例的 Service。port: 數據庫正在偵聽的端口。uri: 一個 PostgreSQL 連接 URI,它提供了登錄 Postgres 數據庫的所有信息。jdbc-uri: 一個 PostgreSQL JDBC 連接 URI,它提供了通過 JDBC driver 登錄到 Postgres 數據庫的所有信息。
如果您使用 PgBouncer 連接池部署 Postgres 集群,則用戶 Secret 中會填充其他值,包括:
pgbouncer-host: PgBouncer 連接池的主機名。這引用了 PgBouncer 連接池的 Service。pgbouncer-port: PgBouncer 連接池正在偵聽的端口。pgbouncer-uri: 一個 PostgreSQL 連接 URI,它提供了通過 PgBouncer 連接池登錄到 Postgres 數據庫的所有信息。pgbouncer-jdbc-uri: 一個 PostgreSQL JDBC 連接 URI,它提供了使用 JDBC driver 通過 PgBouncer 連接池登錄到 Postgres 數據庫的所有信息。
請注意,所有連接都使用 TLS。PGO 為您的 Postgres 集群設置 PKI。您也可以選擇自帶 PKI / certificate authority;這將在文檔后面介紹。
PgBouncer
https://www.pgbouncer.org/
通過終端中的 psql 連接
直接連接
如果您與 PostgreSQL 集群位于同一網絡上,則可以使用以下命令直接連接到它:
psql $(kubectl -n postgres-operator get secrets hippo-pguser-hippo -o go-template='{{.data.uri | base64decode}}')
使用端口轉發連接
在新終端中,創建一個端口轉發:
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實戰 Keycloak 連接 PostgreSQL 集群
用戶 Secret 中提供的信息將允許您將應用程序直接連接到您的 PostgreSQL 數據庫。
例如,讓我們連接 Keycloak。Keycloak 是一種流行的開源身份管理工具,由 PostgreSQL 數據庫支持。使用我們創建的 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
轉到 http://127.0.0.1:8086
在 kustomize/keycloak 文件夾中有一個關于如何使用 Postgres Operator 部署 Keycloak 的完整示例。
注意:
quay.io/keycloak/keycloak:latest,科學拉取鏡像對 keycloak.yaml 進行了上述修改
恭喜,您的 Postgres 集群已啟動并運行,還連接了一個應用程序!
本文鏈接:http://www.www897cc.com/showinfo-119-2177-0.html云原生 PostgreSQL 集群 - PGO:五分鐘快速上手
聲明:本網頁內容旨在傳播知識,若有侵權等問題請及時與本網聯系,我們將在第一時間刪除處理。郵件:2376512515@qq.com
上一篇: 混合云:如何讓「混亂」回歸秩序 譯文