单节点容器化安装
本章节主要介绍通过Docker安装openGauss,方便DevOps用户的安装、配置和环境设置。
构建容器的架构和操作系统版本
x86-64 CentOS 7.6
ARM64 openEuler 20.03 LTS
配置准备
使用 buildDockerImage.sh脚本构建docker镜像,buildDockerImage.sh是一个方便使用的shell脚本,提供SHA256的检查。
创建openGauss docker镜像
说明:
安装前需要提供openGauss二进制安装包,解压后将以bz2结尾的包(openGauss-Server-X.X.X-CentOS7-x86_64.tar.bz2,X.X.X为当前openGauss版本号)放到 dockerfiles/<version>文件夹。二进制包可以从 https://www.opengauss.org/zh/download/下载,确保有正确的yum源。
运行buildDockerImage.sh脚本时,如果不指定-i参数,此时默认提供SHA256检查,需要您手动将校验结果写入sha256_file_amd64文件。
## 修改sha256校验文件内容 cd /soft/openGauss-server/docker/dockerfiles/X.X.X sha256sum openGauss-Server-X.X.X-CentOS7-x86_64.tar.bz2 > sha256_file_amd64
- 安装前需要从华为开源镜像站获取openEuler_aarch64.repo文件,并放到openGauss-server-master/docker/dockerfiles/X.X.X文件夹下面。openEuler_aarch64.repo获取方法:
wget -O openEuler_aarch64.repo https://mirrors.huaweicloud.com/repository/conf/openeuler_aarch64.repo
在dockerfiles文件夹运行buildDockerImage.sh脚本。
[root@ecs-complie dockerfiles]# ./buildDockerImage.sh
Usage: buildDockerImage.sh -v [version] [-i] [Docker build option]
Builds a Docker Image for openGauss
Parameters:
-v: version to build
Choose one of: X.X.X
-i: ignores the SHA256 checksums
LICENSE UPL 1.0
环境变量
为了更灵活的使用openGauss镜像,可以设置额外的参数。未来我们会扩充更多的可控制参数,当前版本支持以下变量的设定。
GS_PASSWORD
使用openGauss镜像的时候,必须设置该参数。该参数值不能为空或者不定义。该参数设置了openGauss数据库的超级用户omm以及测试用户gaussdb的密码。openGauss安装时默认会创建omm超级用户,该用户名暂时无法修改。测试用户gaussdb是在entrypoint.sh中自定义创建的用户。
openGauss镜像配置了本地信任机制,因此在容器内连接数据库无需密码,但是如果要从容器外部(其它主机或者其它容器)连接则必须要输入密码。
openGauss的密码有复杂度要求
密码长度8个字符以上,必须同时包含大写字母、小写字母、数字、以及特殊符号(特殊符号仅包含“#?!@$%^&*-”,并且“!$&”需要用转义符“\”进行转义)。
GS_NODENAME
指定数据库节点名称,默认为gaussdb。
GS_USERNAME
指定数据库连接用户名,默认为gaussdb。
GS_PORT
指定数据库端口,默认为5432。
开启实例
opengauss数据库版本以6.0.0为例命令如下。
$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=XXXXXXXX opengauss:6.0.0
从操作系统层面连接数据库
opengauss数据库版本以6.0.0为例命令如下。
$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=XXXXXXXX -p 8888:5432 opengauss:6.0.0
$ gsql -d postgres -U gaussdb -W'Enmo@123' -h your-host-ip -p 8888 # 宿主机需要安装gsql客户端
数据持久化
opengauss数据库版本以6.0.0为例命令如下。
$ docker run --name opengauss --privileged=true -d -e GS_PASSWORD=Enmo@123 -v /opengauss:/var/lib/opengauss opengauss:6.0.0
说明
对于使用其他版本的数据库构建容器镜像,可以参考
openGauss-server/docker/dockerfiles/X.X.X
里面的配置文件,只需要修改为对应的版本号即可。对于构建openEuler-arm的容器镜像,如果
openeuler-20.03-lts:latest
镜像下载不下来,可以在openEuler官方网站https://repo.openeuler.org/openEuler-20.03-LTS/docker_img/aarch64/
下载容器镜像压缩包openEuler-docker.aarch64.tar.xz
,然后使用docker load -i openEuler-docker.aarch64.tar.xz
导入到本地镜像列表。在进行构建时候,如果遇到yum源下载超时,请检查下代理,也可以在buildDockerImage.sh脚本里面的
docker build
命令后加上--network host
使用宿主机的网络。