容器化MogDB安装

本文档主要介绍MogDB容器版安装过程。MogDB容器版本不支持 MogHA工具、OM工具，目前最多支持一主八备。MogDB 3.1容器版支持最新版的compat-tools和插件功能。

由于考虑尽可能缩减容器镜像的大小，以方便快速下载和部署，从2.0版本开始，容器化MogDB在容器里运行的操作系统在x86和ARM架构下分别运行在Ubuntu和Debian之上。

x86-64架构的MogDB容器运行在Ubuntu 18.04操作系统中。

ARM64架构的MogDB容器运行在Debian 10 操作系统中。

Docker部署

准备工作

容器化MogDB的安装与宿主机的操作系统无关，能够运行容器引擎的所有操作系统均可支持，比如Linux，Windows，macOS。在安装容器版MogDB之前，您需要先安装容器运行时环境，比如Docker。

Docker是一个开源的应用容器引擎，基于Go语言并遵从Apache2.0协议开源。Docker可以让开发者打包他们的应用以及依赖包到一个轻量级、可移植的容器中，然后发布到任何流行的Linux机器上，也可以实现虚拟化。

Docker Desktop下载地址：https://www.docker.com/products/docker-desktop

安装步骤

启动Docker服务。
输入以下命令获取最新版MogDB镜像文件：
```
docker pull swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:5.1.0
```
说明：MogDB镜像支持运行在x86和ARM架构中，会根据发起命令的服务器架构自动下载相应的镜像，无需手工指定。
输入以下命令为MogDB创建运行目录，下文以“mogdb”为例：
```
mkdir /mogdb
```
继续输入以下命令创建一个新的容器，将容器命名为“mogdb”，以启动MogDB实例：
```
docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Enmo@123  -v /mogdb:/var/lib/mogdb  -p 15432:5432  swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:5.1.0
```
对于Windows系统而言：
- 如果Docker使用Hyper-V做引擎，请依次执行以下命令，在Hyper-V中创建卷的逻辑对象mogdata，然后创建容器：
```
docker volume create mogdata

docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Enmo@123 -v mogdata:/var/lib/mogdb -p 15453:5432  swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:5.1.0
```
- 如果Docker启用WSL 2做引擎，请执行以下命令创建容器：
```
docker run --name mogdb --privileged=true -d -e GS_PASSWORD=Enmo@123 -v C:\mogdb:/var/lib/mogdb -p 15432:5432  swr.cn-north-4.myhuaweicloud.com/mogdb/mogdb:5.1.0
```
注意：
- MogDB的默认监听启动在容器内的5432端口上，如果想要从容器外部访问数据库，则需要在docker run的时候指定-p参数。比如以上命令将允许使用15432端口访问容器数据库。
- 容器一旦被删除，容器内的所有数据和配置也均会丢失，而从镜像重新运行一个容器的话，则所有数据又都是呈现在初始化状态，因此对于数据库容器来说，为了防止因为容器的消亡或者损坏导致的数据丢失，需要进行持久化存储数据的操作。通过在docker run的时候指定-v参数来实现。比如以上命令将会指定将MogDB的所有数据文件存储在宿主机的/mogdb下。如果使用podman，会有目标路径检查，需要预先创建宿主机目标路径（步骤4）。
进入容器终端：
```
docker exec -it mogdb bash
```
至此，MogDB容器版安装完成。

使用MogDB

安装完成并进入容器后，通过su - omm切换为omm用户，即可通过gsql进行数据库访问以正常体验MogDB各项功能：

root@384ac97543bd:/# su - omm
omm@384ac97543bd:~$ gsql -d postgres
gsql ((MogDB x.x.x build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr  )
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.

MogDB=#

环境变量

为了更灵活地使用MogDB镜像，可以设置额外的参数。未来我们会扩充更多的可控制参数，当前版本支持以下变量的设定。

GS_PASSWORD

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

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

MogDB的密码有复杂度要求，密码长度8个字符以上，必须同时包含大写字母、小写字母、数字、以及特殊符号（特殊符号仅包含( # ? ! @ $ % ^ & * - )，并且 ! $ & 需要用转义符"\"进行转义。

GS_NODENAME

指定数据库节点名称，默认为mogdb。

GS_USERNAME

指定数据库连接用户名，默认为mogdb。

GS_PORT

指定数据库端口，默认为5432。

Kubernetes部署

MogDB 2.1版本以后支持Kubernetes部署。

$ kubectl apply -f https://gitee.com/enmotech/enmotech-docker-mogdb/raw/master/5.1.0/k8s.yaml
pod/mogdb created

k8s连接pod

进入容器内通过gsql命令登录MogDB。

$ kubectl exec -it mogdb -- bash
root@mogdb:/# su - omm
omm@mogdb:~$ gsql -d postgres
gsql ((MogDB x.x.x build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr  )
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.
  
MogDB=#

Mogila样本数据集

MogDB容器版内置了一个样本数据库mogila，该数据库是一个关于DVD出租店信息的数据库，包含有关电影（如标题、类别、女演员）、出租店（如地址、工作人员、客户）和出租的信息，其中一位顾客通过店员从一家商店租了一部影片。安装完MogDB容器版之后，您可以使用mogila数据库进行各种功能测试。

安装完成并进入容器后，通过su - omm切换为omm用户，执行gsql -d mogila即可访问mogila数据库。

root@07456ed8f523:/# su - omm
omm@07456ed8f523:~$ gsql -d mogila
gsql ((MogDB x.x.x build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr  )
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.

MogDB=#\dt
                             List of relations
 Schema |     Name      | Type  | Owner |             Storage
--------+---------------+-------+-------+----------------------------------
 public | actor         | table | mogdb | {orientation=row,compression=no}
 public | address       | table | mogdb | {orientation=row,compression=no}
 public | category      | table | mogdb | {orientation=row,compression=no}
 public | city          | table | mogdb | {orientation=row,compression=no}
 public | country       | table | mogdb | {orientation=row,compression=no}
 public | customer      | table | mogdb | {orientation=row,compression=no}
 public | film          | table | mogdb | {orientation=row,compression=no}
 public | film_actor    | table | mogdb | {orientation=row,compression=no}
 public | film_category | table | mogdb | {orientation=row,compression=no}
 public | inventory     | table | mogdb | {orientation=row,compression=no}
 public | language      | table | mogdb | {orientation=row,compression=no}
 public | payment       | table | mogdb | {orientation=row,compression=no}
 public | rental        | table | mogdb | {orientation=row,compression=no}
 public | staff         | table | mogdb | {orientation=row,compression=no}
 public | store         | table | mogdb | {orientation=row,compression=no}
(15 rows)

MogDB=#

有关mogila样本数据集的详细介绍及查询示例，请参考使用样本数据库集Mogila。

后续步骤

MogDB容器版不支持MogHA工具、OM工具，当前仅用于测试使用，目前最多支持一主八备。MogDB企业版包含MogHA组件。容器版与企业版基础功能完全一致，在生产环境中建议使用MogDB企业版。

反馈