openGauss多系统配置

For Windows User

在docker中使用openGauss

• 拉取openGauss镜像
  在控制台输入

docker pull enmotech/opengauss:latest

• 等待下载
  
  中途可能会出现卡住的情况。可以按Ctrl+C之后重新运行拉取镜像的的指令。直到所有都显示Download complete

• 如果实在是下载不了就给docker换个源
  打开C盘下的用户（或者User）文件夹–>点开当前用户对应的用户文件夹–>找到.docker文件夹
  编辑其中的daemon.json，添加镜像源的地址。

{
"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn/","https://hub-mirror.c.163.com","https://registry.docker-cn.com"],
"insecure-registries": ["10.0.0.12:5000"]
}

再次运行在控制台运行

docker pull enmotech/opengauss:latest

• 启动docker镜像

在你使用openGauss镜像的时候，必须设置该参数。该参数值不能为空或者不定义。该参数设置了openGauss数据库的超级用户omm以及测试用户gaussdb的密码。openGauss安装时默认会创建omm超级用户，该用户名暂时无法修改。测试用户gaussdb是在entrypoint.sh中自定义创建的用户。

openGauss镜像配置了本地信任机制，因此在容器内连接数据库无需密码，但是如果要从容器外部（其它主机或者其它容器）连接则必须要输入密码。

openGauss的密码有复杂度要求，需要：密码长度8个字符及以上，必须同时包含英文字母大小写，数字，以及特殊符号

openGauss的默认监听启动在容器内的5432端口上，如果想要从容器外部访问数据库，则需要在docker run的时候指定 -p 参数。比如以下命令将允许使用15432端口访问容器数据库。

docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Secretpassword@123(这里是你的密码) -p 15432(端口号):5432 enmotech/opengauss:latest

在上述命令正常启动容器数据库之后，可以通过外部的gsql进行数据库访问。（复制的时候记得删除括号内的内容和填上自己的密码和端口号，当然也可以不修改，这里的端口号是15432）

gsql -d postgres -U gaussdb -W'Secretpassword@123' -h your-host-ip -p15432

当然也可以通过其他软件数据库连接的软件（dbms）进行连接。如：datagrip等软件

启动完毕进入docker-cli

显示这样的界面就说明启动成功了

要使用OpenGauss需要切换到omm账户，故运行su - omm

gsql -d postgres -U gaussdb -W'Secretpassword@123' -h your-host-ip -p15432

显示出openGauss的控制台，说明安装成功

在上述命令正常启动容器数据库之后，可以通过外部的gsql进行数据库访问。（复制的时候记得删除括号内的内容和填上自己的密码和端口号，当然也可以不修改，这里的端口号是15432）

For Linux User

linux用户可以通过控制台安装docker软件，使用包管理器进行安装。在控制台运行。Arch用户：

sudo pacman -S docker

• 拉取openGauss镜像
  在控制台输入

docker pull enmotech/opengauss:latest

在linux平台下换源，编辑/etc/docker/daemon.json文件，在"registry-mirrors"中添加镜像源地址。

{
"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn/","https://hub-mirror.c.163.com","https://registry.docker-cn.com"],
"insecure-registries": ["10.0.0.12:5000"]
}

• 运行dokcer
  openGauss的默认监听启动在容器内的5432端口上，如果想要从容器外部访问数据库，则需要在docker run的时候指定 -p 参数。比如以下命令将允许使用15432端口访问容器数据库。

docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Secretpassword@123(这里是你的密码) -p 15432(端口号):5432 enmotech/opengauss:latest

参考资料

https://hub.docker.com/r/enmotech/opengauss