munanqing/opengauss

openGauss Docker镜像文档

镜像概述

本镜像基于openGauss-2.0.1-CentOS-64bit.tar.bz2构建，提供便捷的openGauss 2.0.1数据库部署方案，支持通过Docker快速启动和运行openGauss数据库服务，适用于开发、测试等场景。

核心功能与特性

• 快速部署：通过Docker命令一键启动openGauss数据库服务
• 数据持久化：支持通过卷挂载实现数据持久化存储
• 端口映射：默认映射5432端口，便于外部访问
• 默认配置：提供默认数据库、用户名及密码，简化初始连接

使用场景

• 开发环境中快速搭建openGauss数据库
• 测试环境中部署独立的openGauss数据库实例
• 需要便捷管理和迁移的小型数据库应用

使用方法

1. 拉取镜像

使用以下命令拉取镜像：

shell
docker pull munanqing/opengauss:2.0.1

2. 启动容器

通过以下命令启动容器，需指定必填环境变量GS_PASSWORD，并配置卷挂载和端口映射：

shell
sudo docker run --name opengauss --privileged=true -p 5432:5432 -d -e GS_PASSWORD=Enmo@123 -v /opengauss:/var/lib/opengauss munanqing/opengauss:2.0.1

参数说明：

• --name opengauss：指定容器名称为opengauss
• --privileged=true：赋予容器特权模式，确保数据库正常运行
• -p 5432:5432：将容器内5432端口映射到主机5432端口
• -d：后台运行容器
• -e GS_PASSWORD=Enmo@123：设置环境变量，数据库密码（必填，暂不支持变更）
• -v /opengauss:/var/lib/opengauss：将主机/opengauss目录挂载到容器内/var/lib/opengauss，实现数据持久化

3. 连接数据库

容器启动后，可通过数据库客户端连接，默认配置如下：

• 数据库名称：postgres
• 用户名：gaussdb
• 密码：Enmo@123
• 端口：5432（若主机端口映射有变更，需使用映射后的主机端口）

连接示例（以navicat为例）：

• 选择PostgreSQL连接类型
• 输入主机IP、端口（默认5432）、数据库名（postgres）、用户名（gaussdb）、密码（Enmo@123），点击连接即可。

注意事项

• GS_PASSWORD环境变量为必填项，当前版本暂不支持变更，固定为Enmo@123
• 卷挂载目录（如/opengauss）需确保主机目录存在且有读写权限
• 若需修改端口映射，可调整-p参数（格式：主机端口:容器端口）
• 容器运行需--privileged=true特权模式支持