15501059069/opengauss

openGauss容器镜像文档

镜像概述

openGauss容器镜像是openGauss数据库的容器化部署版本，旨在提供简单、快速的数据库环境搭建方式。openGauss是一款开源的关系型数据库管理系统，具备高性能、高可用、安全可靠等特性，容器化版本进一步简化了部署流程，适合开发、测试及轻量级生产环境使用。

核心功能与特性

• 便捷部署：通过Docker容器快速启动openGauss数据库，无需复杂的环境配置
• 环境变量配置：支持通过环境变量设置数据库管理员密码，灵活定制部署参数
• 后台运行：支持后台模式运行，不阻塞终端操作
• 特权模式支持：通过特权模式运行，确保容器内数据库服务正常启动

使用场景

• 开发环境快速搭建：开发者可快速部署独立的openGauss数据库进行应用开发测试
• 学习与评估：方便用户体验和学习openGauss数据库功能
• 轻量级生产环境：适用于对资源要求不高的小型应用或服务

使用方法

基本部署命令

使用以下命令部署openGauss容器：

bash
docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Lee@1234 docker.xuanyuan.run/15501059069/opengauss:tagname

参数说明

• --name opengauss：指定容器名称为opengauss
• --privileged=true：以特权模式运行容器，确保数据库服务正常启动
• -d：后台运行容器
• -e GS_PASSWORD=Lee@1234：设置环境变量GS_PASSWORD，指定数据库管理员密码（需替换为实际密码）
• 15501059069/opengauss:tagname：镜像名称及标签，需将tagname替换为具体版本标签（如latest）

验证部署

容器启动后，可通过以下命令进入容器内部：

bash
docker exec -it opengauss bash

进入容器后，可使用gsql工具连接数据库：

bash
gsql -d postgres -U gaussdb -W 'Lee@1234' -h localhost -p 5432

配置说明

环境变量

• GS_PASSWORD：必填，设置openGauss数据库管理员（gaussdb用户）的密码，密码需满足复杂度要求（建议包含大小写字母、数字及特殊符号）

注意事项

• 特权模式（--privileged=true）是容器正常运行的必要条件，请勿省略
• 密码需妥善保管，避免使用弱密码
• 生产环境中建议配合数据卷（-v参数）持久化存储数据库数据，避免容器删除导致数据丢失