前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >云原生 PostgreSQL 集群 - PGO:5分钟快速上手

云原生 PostgreSQL 集群 - PGO:5分钟快速上手

作者头像
为少
发布2022-03-31 19:33:22
1.4K0
发布2022-03-31 19:33:22
举报
文章被收录于专栏:黑客下午茶黑客下午茶

目录

  • 前提条件
  • 安装
  • 第 1 步:下载示例
  • 第 2 步:安装 PGO,即 Postgres Operator
  • 创建 Postgres 集群
  • 连接到 Postgres 集群
  • 通过终端中的 psql 连接
  • 实战 Keycloak 连接 PostgreSQL 集群
  • 更多

前提条件

请确保您的主机上安装了以下实用程序:

  • kubectl
  • git

安装

第 1 步:下载示例

首先,转到 GitHub 并 fork Postgres Operator 示例存储库:

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

一旦你分叉了这个 repo,你可以使用类似下面的命令将它下载到你的工作环境中:

代码语言:javascript
复制
YOUR_GITHUB_UN="<your GitHub username>"
git clone --depth 1 "git@github.com:${YOUR_GITHUB_UN}/postgres-operator-examples.git"
cd postgres-operator-examples

第 2 步:安装 PGO,即 Postgres Operator

您可以使用以下命令安装 PGO,即来自 Crunchy DataPostgres Operator

代码语言:javascript
复制
kubectl apply -k kustomize/install

这将创建一个名为 postgres-operator 的命名空间,并创建部署 PGO 所需的所有对象。

要检查安装状态,可以运行以下命令:

代码语言:javascript
复制
kubectl -n postgres-operator get pods \
  --selector=postgres-operator.crunchydata.com/control-plane=postgres-operator \
  --field-selector=status.phase=Running

如果 PGO Pod 运行良好,您应该会看到类似于以下内容的输出:

代码语言:javascript
复制
NAME                                READY   STATUS    RESTARTS   AGE
postgres-operator-9dd545d64-t4h8d   1/1     Running   0          3s

创建 Postgres 集群

让我们创建一个简单的 Postgres 集群。您可以通过执行以下命令来执行此操作:

代码语言:javascript
复制
kubectl apply -k kustomize/postgres

注意:

  • 注意,你的集群已经有一个默认的 Storage Class

这将在 postgres-operator 命名空间中创建一个名为 hippoPostgres 集群。您可以使用以下命令跟踪集群的进度:

代码语言:javascript
复制
kubectl -n postgres-operator describe postgresclusters.postgres-operator.crunchydata.com hippo

连接到 Postgres 集群

作为创建 Postgres 集群的一部分,Postgres Operator 创建一个 PostgreSQL 用户帐户。此帐户的凭据存储在名为 <clusterName>-pguser-<userName>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 数据库的所有信息。

请注意,所有连接都使用 TLSPGO 为您的 Postgres 集群设置 PKI。您也可以选择自带 PKI / certificate authority;这将在文档后面介绍。

PgBouncer

  • https://www.pgbouncer.org/

通过终端中的 psql 连接

直接连接

如果您与 PostgreSQL 集群位于同一网络上,则可以使用以下命令直接连接到它:

代码语言:javascript
复制
psql $(kubectl -n postgres-operator get secrets hippo-pguser-hippo -o go-template='{{.data.uri | base64decode}}')

使用端口转发连接

在新终端中,创建一个端口转发:

代码语言:javascript
复制
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 集群的连接。

代码语言:javascript
复制
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/
代码语言:javascript
复制
cat <<EOF >> 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 集群已启动并运行,还连接了一个应用程序!👏 👏 👏

您可以通过文档和 kubectl explain 了解有关 postgresclusters 自定义资源定义的更多信息,即:

代码语言:javascript
复制
kubectl explain postgresclusters

postgresclusters 自定义资源定义

  • https://access.crunchydata.com/documentation/postgres-operator/5.0.4/references/crd/
本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2022-02-23,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 黑客下午茶 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 目录
  • 前提条件
  • 安装
    • 第 1 步:下载示例
      • 第 2 步:安装 PGO,即 Postgres Operator
      • 创建 Postgres 集群
      • 连接到 Postgres 集群
        • 通过终端中的 psql 连接
        • 实战 Keycloak 连接 PostgreSQL 集群
        相关产品与服务
        数据库
        云数据库为企业提供了完善的关系型数据库、非关系型数据库、分析型数据库和数据库生态工具。您可以通过产品选择和组合搭建,轻松实现高可靠、高可用性、高性能等数据库需求。云数据库服务也可大幅减少您的运维工作量,更专注于业务发展,让企业一站式享受数据上云及分布式架构的技术红利!
        领券
        问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档