xxnzx/opengauss

aht-boot-opengauss:5.0.3 镜像文档

镜像概述

aht-boot-opengauss:5.0.3 是一个自定义构建的 openGauss 数据库镜像，基于官方提供的方式构建，旨在提供稳定、可靠的 openGauss 数据库服务环境，方便用户快速部署和使用 openGauss 数据库。

核心功能和特性

• 官方兼容：基于官方方式构建，确保与 openGauss 数据库核心功能兼容
• 持久化存储：支持通过卷挂载实现数据持久化，避免容器重启导致数据丢失
• 环境变量配置：通过环境变量灵活配置数据库密码
• 自动重启：默认配置为容器退出时自动重启，提高服务可用性
• 特权模式：需启用特权模式（privileged: true）以确保数据库正常运行

使用场景和适用范围

• 开发环境：为应用开发提供本地 openGauss 数据库环境
• 测试环境：用于应用程序的数据库功能测试和兼容性验证
• 小型生产环境：适用于对资源要求不高的小型应用的数据库服务部署

使用方法和配置说明

基本部署方式

推荐使用 docker-compose 进行部署，配置文件示例如下：

yaml
version: "3"
services:
  ld-boot-opengauss:
    image: aht-boot-opengauss:5.0.3  # 指定使用的镜像
    container_name: ld-boot-opengauss  # 容器名称
    hostname: ld-boot-opengauss  # 容器主机名
    restart: always  # 容器退出时自动重启
    privileged: true  # 必要参数，启用特权模式
    ports:
      - "15432:5432"  # 端口映射，主机端口:容器端口
    environment:
      GS_PASSWORD: ${GS_PASSWORD:-Aht@opengauss321}  # 数据库密码，默认值为 Aht@opengauss321
    volumes:
      - ld-boot-opengauss:/var/lib/opengauss  # 卷挂载，用于数据持久化
volumes:
  ld-boot-opengauss:
    driver: local  # 使用本地卷驱动

参数说明

必要参数

• privileged: true：必须启用，确保容器内有足够权限运行 openGauss 数据库

端口映射

• ports: "15432:5432"：将容器内的 5432 端口（openGauss 默认端口）映射到主机的 *** 端口，可根据需要修改主机端口

环境变量

• GS_PASSWORD：设置 openGauss 数据库的管理员密码，默认值为 Aht@opengauss321，建议通过环境变量自定义设置以提高安全性

数据持久化

• volumes: ld-boot-opengauss:/var/lib/opengauss：通过命名卷 ld-boot-opengauss 挂载容器内的 /var/lib/opengauss 目录，实现数据库数据的持久化存储，即使容器删除或重建，数据也不会丢失

启动步骤

1. 创建 docker-compose.yml 文件，复制上述配置内容
2. （可选）通过环境变量设置自定义密码：export GS_PASSWORD=自定义密码
3. 执行启动命令：docker-compose up -d
4. 验证服务状态：docker-compose ps，确认容器状态为 "Up"

连接数据库

使用数据库客户端连接时，连接信息如下：

• 主机：部署容器的主机 IP
• 端口：***（如未修改端口映射）
• 用户名：默认管理员用户（通常为 omm）
• 密码：通过 GS_PASSWORD 设置的密码（默认 Aht@opengauss321）