stackgres/operator

StackGres 主OCI镜像文档

镜像概述和主要用途

StackGres主OCI镜像是StackGres平台的核心组件，内置用于部署和管理StackGres集群的operator。StackGres是一款企业级PostgreSQL数据库管理平台，提供自动化部署、高可用性保障、备份恢复等能力。该镜像作为部署StackGres的基础载体，通过operator实现对StackGres集群全生命周期的自动化管理。

核心功能和特性

• 内置Operator组件：集成StackGres operator，作为集群部署和管理的核心控制组件
• 自动化部署能力：支持通过operator自动化完成StackGres集群的部署流程，简化手动操作
• 集群生命周期管理：提供对StackGres集群创建、升级、扩缩容、删除等全生命周期管理
• 生态兼容性：与StackGres平台其他组件（如数据库实例、监控插件等）无缝集成，确保整体功能完整性

使用场景和适用范围

• 企业级PostgreSQL部署：适用于需要构建高可用、可扩展的企业级PostgreSQL数据库集群场景
• 自动化运维环境：适合对数据库集群有自动化部署、监控和管理需求的运维场景
• Kubernetes环境：主要面向Kubernetes集群环境，利用容器编排能力实现StackGres的弹性部署和管理

详细使用方法和配置说明

前提条件

• 容器运行时环境（如Docker、containerd等）
• Kubernetes集群（推荐环境，满足StackGres运行的基础资源要求）
• 网络策略允许容器与Kubernetes API Server通信（用于operator执行集群管理操作）

部署示例

基础容器运行（测试环境）

bash
docker run -d \
  --name stackgres-operator \
  --restart=always \
  stackgres/stackgres-operator:latest

Kubernetes环境部署（生产推荐）

通过Kubernetes资源清单部署（官方推荐使用Helm或kubectl）：

bash
# 使用kubectl部署最新版operator
kubectl apply -f https://downloads.stackgres.io/stackgres-operator/latest/stackgres-operator.yaml

配置说明

核心配置方式

operator的主要配置通过Kubernetes自定义资源（CR）实现，关键自定义资源包括：

• StackGresCluster：定义StackGres集群规格，包含实例数量、CPU/内存资源、存储配置、备份策略等
• StackGresConfig：配置集群全局参数，如PostgreSQL版本、连接池设置、监控配置等

环境变量配置

可通过环境变量调整operator运行参数，常用参数包括：

• LOG_LEVEL：日志级别，可选值：DEBUG、INFO、WARN、ERROR（默认INFO）
• KUBERNETES_API_QPS：Kubernetes API请求QPS限制（默认100）
• KUBERNETES_API_BURST：Kubernetes API请求突发限制（默认200）

注意事项

• 版本兼容性：镜像版本需与目标部署的StackGres集群版本匹配，避免版本不兼容问题
• 资源要求：根据集群规模调整operator资源配置，建议最小配置为2CPU/4Gi内存
• 权限配置：部署时需确保operator具有足够的Kubernetes RBAC权限（如集群管理员权限）以执行集群管理操作
• 详细配置请参考官方文档：更多高级配置（如备份存储配置、监控集成等）可查阅StackGres官方文档获取最新指南