云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载PostgreSQL 是 Olares 系统默认内置的数据库中间件由基于 Citus 的集群提供开箱即用。本文围绕如何在 Olares 中查看和操作 PostgreSQL 数据这一主题完整讲解两条实操路径一条是通过 Olares 终端以kubectl exec进入容器、用psql命令行直接查询另一条是借助 Bytebase 图形化界面完成数据库实例管理、结构变更与日常巡检。读完本文你将掌握从 Control Hub 获取连接凭据、在容器内执行 SQL、以及搭建 Bytebase 管理入口的完整技能并能理解 Olares 中 PostgreSQL 的底层部署形态与数据流向。获取 PostgreSQL 连接信息无论选择 CLI 还是 Bytebase 方式第一步都是从 Control Hub 获取 PostgreSQL 的连接凭据。Olares 的 Control Hub 提供了统一的应用与中间件管理入口。从 Launchpad 打开Control Hub。在左侧导航窗格中找到Middleware中间件选择Postgres。在Details详情面板中记录以下信息Host用于 Bytebase 连接。User用于 Bytebase 连接。PasswordCLI 与 Bytebase 两种方式都会用到。说明这里的 Host、User、Password 实际上就是 PostgreSQL 集群的管理员级连接信息。从源码看Olares 为 PostgreSQL 集群预置了一个名为pgcluster-admin的 Kubernetes Secret其中保存user与password两个键POSTGRES_USER与POSTGRES_PASSWORD环境变量正是通过SecretKeyRef从该 Secret 注入容器见 templates.go。Control Hub 展示的凭据即来源于此。通过 CLI 访问 PostgreSQLOlares 终端是随系统内置的在线终端无需额外安装 SSH 客户端即可进入集群执行命令。在 Control Hub 左侧导航底部打开Olares 终端。进入 PostgreSQL 容器。容器名称是固定的直接执行kubectl exec -it -n os-platform citus-0 -- sh这条命令的含义是在os-platform命名空间中以交互模式进入名为citus-0的 Pod并启动一个shshell。在容器内连接 PostgreSQL 数据库psql -h citus-0 -U olares按提示输入从 Control Hub 获取的密码即可进入psql交互式命令行执行\l查看数据库列表、\dt查看表、以及任意 SQL 查询。这条命令背后的集群形态从源码可以确认Olares 中的 PostgreSQL 并不是单机部署而是一个以 Citus 为内核的 PostgreSQL 集群StatefulSet集群名为citus所在命名空间为os-platformPlatformNamespace os-platform见 constants.go。Pod 命名遵循 StatefulSet 规范首个副本即citus-0对应集群的主节点master 节点。源码中定义了PG_MASTER_HOST citus-0.citus-headless与PG_PORT 5432见 db_types.go与文档中的连接命令完全一致。容器内的数据库服务名为postgres监听 TCP 5432 端口并配有基于 TCP 探测的存活探针见 templates.go。默认管理员用户名为olaresDefaultPGAdminUser olares见 templates.go数据目录位于/var/lib/postgresql/data/$(POD_NAME)由名为pgdata的宿主机目录卷承载。# 进入容器后也可直接验证版本与扩展 psql -h citus-0 -U olares -c SELECT version(); psql -h citus-0 -U olares -c SELECT extname FROM pg_extension;Olares 内置的 PostgreSQL 镜像beclab/citus对应 PostgreSQL 17 Citus默认启用了citus扩展并预加载了citus、vectors.so、vchord.so等共享库见 Dockerfile因此对向量检索等高级能力也有原生支持。通过 Bytebase 图形化管理CLI 适合快速查询与脚本化操作当需要可视化的数据库管理、多人协作或结构变更Schema Change时Bytebase 是更合适的选择。前置条件先安装 MongoDBBytebase 使用 MongoDB 存储其元数据因此必须先安装 MongoDB再安装 Bytebase顺序不可颠倒。打开Market应用市场搜索 MongoDB。点击Get再点击Install等待服务运行起来。MongoDB 安装完成后在 Market 中搜索 Bytebase。点击Get再点击Install。从平台的中间件模型来看PostgreSQL 与 Redis 属于系统常驻中间件而 MongoDB、MySQL、MariaDB、MinIO 等需要管理员先行安装相关说明见 olares-chart-middleware.md。这也是文档要求先装 MongoDB 的原因。首次启动配置管理员账号第一次启动 Bytebase 时必须完成管理员账号的配置从 Launchpad 打开 Bytebase。跟随屏幕提示用邮箱与密码完成管理员账号设置。⚠️ 请务必牢记这组凭据。只有管理员账号才能创建新的数据库实例。在 Bytebase 中创建 PostgreSQL 实例使用管理员账号登录 Bytebase。在左侧导航栏选择Instances实例点击 Add Instance。数据库类型选择PostgreSQL。使用 Control Hub 中获取的值填写连接字段Host or Socket填写 Control Hub 中的Host地址不要带端口。Port保持默认值通常为5432。Username填写 Control Hub 中的User值。Password填写 Control Hub 中的Password值。点击Test Connection验证连通性确认通过后点击Create。需要特别注意的是在 Bytebase 中创建实例并不会新建数据库。实例创建成功后你可以用对应的客户端工具去检查和管理实际数据数据库本身的创建需要另行通过 SQL 语句或在 Bytebase 中发起。深入理解实例、数据库与凭据的关系结合源码可以进一步理解文档中几处容易混淆的概念Host 不带端口的原因Olares 的 PostgreSQL 通过 headless Servicecitus-headlessClusterIP: None暴露端口固定为5432见 templates.go。Bytebase 的 Host 字段与 Port 字段是分开填写的因此 Host 只填地址。密码与用户是可轮换的pgcluster 控制器负责在集群扩容、镜像升级等场景下同步管理后台用户见 handler.go。如果密码在 Control Hub 中被修改Bytebase 中的连接配置也需要同步更新。Control Hub 如何获取连接信息前端通过/middleware/v1/list接口拉取中间件清单返回的MiddlewareItem结构包含name、namespace、nodes、adminUser、password、proxy.endpoint等字段见 middleware.tsControl Hub 的 Postgres 详情面板即来源于此。总结在 Olares 中查看和管理 PostgreSQL 数据有两条互补路径CLI 方式轻量直接一条kubectl exec加上psql即可完成查询、建表与脚本化运维适合熟悉命令行的开发者Bytebase 方式提供图形化界面适合数据库实例管理、结构变更与可视化巡检是团队协作场景下的首选。两者共用同一套由pgcluster-adminSecret 管理的连接凭据且在 Olares 中 PostgreSQL 以 Citus 集群形态常驻os-platform命名空间端口固定为 5432理解这套底层部署模型将帮助你在排障与二次开发时更加游刃有余。赞分享云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载相关推荐在 Olares 中查看与管理 Elasticsearch 数据从 Market 安装到 Bytebase 图形化操作指南在 Olares 中查看与管理 Elasticsearch 数据从 Market 安装到 Bytebase 图形化操作指南 Elasticsearch 是 O云原生后端运维Olares 中查看与管理 MariaDB 数据CLI 与 Bytebase 实战指南Olares 中查看与管理 MariaDB 数据CLI 与 Bytebase 实战指南 在 Olares 个人云操作系统中MariaDB 以「中间件Mid云原生后端运维Olares 中查看与管理 MongoDB 数据CLI 与 Bytebase 全流程实战指南Olares 中查看与管理 MongoDB 数据CLI 与 Bytebase 全流程实战指南 本篇技术指南以 Olares 内置的 MongoDB 中间件为对云原生后端运维上一篇告别DLL噩梦VisualCppRedist AIO如何一键解决所有Windows运行库问题下一篇HS2-HF Patch专业级Honey Select 2游戏增强与汉化终极解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考