Mac OS系统下使用docker安装华为openGauss数据库指导手册

原创酷哥 2022-03-22

4479

openGauss经验总结

作者：斗豆

一、实验介绍

1.1实验简介

openGauss是关系型数据库，采用客户端/服务器，单进程多线程架构，支持单机和一主多备部署方式，备机可读，支持双机高可用和读扩展。

本实验主要描述在Mac OS系统下使用docker安装华为openGauss数据库。

1.2实验描述

本实验主要描述在Mac OS系统下使用docker安装华为openGauss数据库，并进行简单的数据库相关操作。

1.3实验环境

Mac OS Monterey12.2.1+DataGrip 2021.3.4, build DB-213.6777.22.+Docker 4.5.0

二、安装Docker应用容器引擎

2.1使用 Homebrew 安装（2.1、2.2二选一）

macOS 我们可以使用 Homebrew 来安装 Docker。

Homebrew 的 Cask 已经支持 Docker for Mac，因此可以很方便的使用 Homebrew Cask 来进行安装：

$ brew install --cask --appdir=/Applications docker

==> Creating Caskroom at /usr/local/Caskroom

==> We'll set permissions properly so we won't need sudo in the future

Password: # 输入 macOS 密码

==> Satisfying dependencies

==> Downloading https://download.docker.com/mac/stable/21090/Docker.dmg

######################################################################## 100.0%

==> Verifying checksum for Cask docker

==> Installing Cask docke

r==> Moving App 'Docker.app' to '/Applications/Docker.app'.

docker was successfully installed!

在载入 Docker app 后，点击 Next，可能会询问你的 macOS 登陆密码，你输入即可。之后会弹出一个 Docker 运行的提示窗口，状态栏上也有有个小鲸鱼的图标（）。

2.2手动下载安装

如果需要手动下载，请复制以下链接下载https://docs.docker.com/desktop/mac/install/

如同 macOS 其它软件一样，安装也非常简单，双击下载的 .dmg 文件，然后将鲸鱼图标拖拽到 Application 文件夹即可。

从应用中找到 Docker 图标并点击运行。可能会询问 macOS 的登陆密码，输入即可

点击顶部状态栏中的鲸鱼图标会弹出操作菜单。

第一次点击图标，可能会看到这个安装成功的界面，点击 "Got it!" 可以关闭这个窗口。

2.3安装建议

启动终端后，通过命令可以检查安装后的 Docker 版本（确认是否安装成功）。

$ docker --version

Docker version 17.09.1-ce, build 19e2cf6

上述Docker安装操作若同时进行会有出现两个图标的风险，建议只安装一个。

三、使用Docker拉取openGauss镜像文件并进行配置

3.1操作流程

①打开docker后打开终端（Terminal）使用docker搜索镜像文件

（base）→ - docker search opengauss

②利用命令拉取enmotech/opengauss文件（可选取其他文件，建议选取标星较多的文件）

（base）→ - docker pull enmotech/opengauss

第一次拉取需要几到十几分钟，请耐心等待)

③配置opengauss虚拟镜像并运行

docter run --name opengauss --privileged=true -d -e GS_PASSWORD=openGauss@123

-p 5432:5432 enmotech/opengauss:latest

注意主要格式为“docter run --name 名称 --privileged=true -d -e GS_PASSWORD=密码（受opengauss限制需要有大小写字母及特殊字符） -p 接口号文件：版本号”

此时，docker中已经建立好该容器，点击start进行运行（如此步骤出现闪退，请回顾上述操作是否有误）

④使用命令台与数据库进行连接，检验是否安装成功

(base) → - docker exec -it opengauss bash

root@b26292df61bf:/# su omm

omm@b26292df61bf:/$ gsql -d postgres -U gaussdb -W 'openGauss@123'

gsql ((openGauss 2.1.0 build 590b0f8e) compiled at 2021-09-30 14:29:04 commit 0 last mr )

Non-SSL connection (SSL connection is recommended when requiring high-security)

Type "help" for help.

openGauss=>

输入“- docker exec -it opengauss（自定义文件名） bash”后进入root用户（会需要提供系统密码），而后输入su omm切换到omm用户，最后输入“ gsql -d postgres -U gaussdb -W 'openGauss@123”，若出现以下命令则成功进入。

为与便于在下一步骤操作，在此阶段需再生成一个zjutuser用户。

openGauss=> CREATE USER zjutuser WITH PASSWORD "Bigdata@123";

CREATE ROLE

此时可关闭终端进行下一步配置

3.2操作建议

建议在输入命令过程中多多注意空格、大小写、特殊字符等问题，避免出现操作失败的情况。

四、安装DataGrip多引擎数据库环境

4.1操作流程

①打开DataGrip官网（https://www.jetbrains.com/datagrip/）下载对应版本并安装。（DataGrip免费使用方法：注册Jetbrains账户使用学校给的邮箱“12位学号@zjut.edu.cn”，邮箱具体使用方法请使用精弘网络查询。学生认证后会给予一个License ID，在DataGrip初始使用界面输入后激活或通过账户登入激活。此许可证使用期仅一年，使用期内可免费使用Jetbrains全家桶，到期后需重新认证申请）

②打开DataGrip创建数据源，此时需保持Docker中的opengauss在运行。新建数据源：点击文件——New——Data Source——PostgreSQL,如图所示。（因为华为自研的 openGauss是基于 PostgreSQL的，所以选择该数据源连接）

③打开创建数据源界面后，填写基本信息联入数据库中，填写密码前可先点击左下角测试连接测试软件完整性。数据源名称自定义，主机处填写IP地址（192.168.43.*），端口处填写之前所设的外部端口号，用户处填写之前所设置的用户名称与密码登入。填写完毕后点击确定。

④登入后刷新数据源，确保数据源与数据库连接成功，本实验到此结束

五、参考资料

①0-1-3 zjut在虚拟机+openEuler上安装部署openGauss数据库指导手册1.1.0

②MacOS Docker 安装

https://www.runoob.com/docker/macos-docker-install.html

③centos7.6虚拟机上通过docker成功拉取open gauss镜像并且成功创建容器后，通过Datagrip连接容器

http://t.csdn.cn/q4b26

④Mac/Windows下使用docker安装华为GaussDB/opengauss数据库及JDBC的使用

https://www.bilibili.com/video/BV1Ay4y1573h?spm_id_from=333.337.search-card.all.click

opengauss 经验总结

「喜欢这篇文章，您的关注和赞赏是给作者最好的鼓励」

关注作者