OceanBase 在windows上使用docker部署数据库（obce-mini）

操作系统的版本

windows 21H1

docker镜像

oceanbase/obce-mini

Docker Desktop（windows）的下载与安装

下载地址

• docker-desktop

安装包的大小为485M。

安装步骤

保存文件，关闭程序，重启计算机

报错与调试 WSL 2 installation is incomplete

根据提示框内的链接，获取到的两个解决方法

• 旧版 WSL 的手动安装步骤

• 安装 WSL

在powershell中，尝试运行wsl --install

PS C:\Windows\system32> wsl --install
版权所有(c) Microsoft Corporation。保留所有权利。

用法: wsl.exe [Argument] [Options...] [CommandLine]

运行 Linux 二进制文件的参数:

    如果未提供命令行，wsl.exe 将启动默认 shell。

    --exec, -e <CommandLine>
        在不使用默认 Linux Shell 的情况下执行指定的命令。

    --
        按原样传递其余命令行。

选项:
    --cd <Directory>
        将指定目录设置为当前工作目录。
        如果使用了 ~，则将使用 Linux 用户的主页路径。如果路径
        以 / 字符开头，将被解释为绝对 Linux 路径。
        否则，该值一定是绝对 Windows 路径。

    --distribution, -d <Distro>
        运行指定分发。

    --user, -u <UserName>
        以指定用户身份运行。

管理适用于 Linux 的 Windows 子系统的参数:

    --help
        显示用法信息。

    --install [选项]
        安装额外的适用于 Linux 的 Windows 子系统分发。
         要获得有效分发列表，请使用“wsl --list --online”。

        选项:
            --distribution, -d [参数]
                按名称下载并安装分发。

                参数:
                    有效分发名称(不区分大小写)。

                示例:
                    wsl --install -d Ubuntu
                    wsl --install --distribution Debian

    --set-default-version <Version>
        更改新分发的默认安装版本。

      --shutdown
         立即终止所有运行的分发及 WSL 2
        轻型工具虚拟机。

         --status
           显示适用于 Linux 的 Windows 子系统的状态。

    --update [选项]
        如果未指定任何选项，则 WSL 2 内核将更新
        到最新版本。

             选项:
         --rollback
                还原到 WSL 2 内核的先前版本。

用于管理适用于 Linux 的 Windows 子系统中的分发的参数:

    --export <Distro> <FileName>
         将分发导出到 tar 文件。
        对于标准输出，文件名可以是 –。

    --import <Distro> <InstallLocation> <FileName> [Options]
            将指定的 tar 文件作为新分发导入。
          对于标准输入，文件名可以是 –。

        选项:
            --version <Version>
                指定要用于新分发的版本。

    --list, -l [Options]
        列出分发。

        选项:
            --all
                列出所有分发，包括
        当前正在安装或卸载的分发。

            --running
                仅列出当前正在运行的分发。

            --quiet, -q
                仅显示分发名称。

            --verbose, -v
                显示所有分发的详细信息。

            --online, -o
                显示使用“wsl --install”进行安装的可用分发列表。

    --set-default, -s <分发>
        将分发设置为默认值。

    --set-version <分发> <版本>
        更改指定分发的版本。

    --terminate, -t <分发>
        终止指定的分发。

    --unregister <分发>
        注销分发并删除根文件系统。

初步判定：当前设备已经安装了wsl，可能是因为没有更新而引起的问题。

windows功能与更新包

• 安装Docker Desktop报错WSL 2 installation is incomplete.

• WSL 2 installation is incomplete.报错

“控制面板-程序-启用或关闭windows功能"中查看"适用于linux的windows子功能”，确认其处于开启状态。

下载更新包

• wsl_update_x64.msi

更新包安装完成后，重启电脑。

docker正常启动

根据课程中的步骤部署oceanbase

PS C:\Windows\system32> docker search oceanbase
NAME                             DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
oceanbase/oceanbase-xe           OceanBase Database 2.2 Express Edition          3
oceanbase/obce-mini              obce-mini is a mini standalone test image fo…   2
obpilot/oceanbase-ce             3 steps to run an OceanBase-CE docker in you…   2
zibuyu886/oceanbase-ce-cluster   OceanBase ce cluster                            1
oceanbase/oceanbase-ce           OceanBase is open source now. This is the do…   1
huweijie/oceanbase-ce-deploy                                                     0
oceanbase/centos7                                                                0
superbigfu/oceanbase                                                             0
hongweiqin/anolisos-oceanbase    A tentative deploy of oceanbase.                0
stutiredboy/centos_ob            Build environment for OceanBase 3.1 CE. Crea…   0

PS C:\Windows\system32> docker pull oceanbase/obce-mini
Using default tag: latest
latest: Pulling from oceanbase/obce-mini
13add961a70d: Pull complete
7e25e159732e: Pull complete
6387a3280aea: Pull complete
Digest: sha256:a2891f3c3235d81e797e90b370c55582af2caea5ffb11f13da59fc4e0f260e9d
Status: Downloaded newer image for oceanbase/obce-mini:latest
docker.io/oceanbase/obce-mini:latest

PS C:\Windows\system32> docker run -p 2881:2881 --name obce-mini -d -e OB_HOME_PATH="/root/obce" -e OB_TENANT_NAME="obmysql" oceanbase/obce-mini
90da3100acaa7172f546e58313daf6db12bbb1a2bbf38e393712cdb628b4e9e2

PS C:\Windows\system32> docker exec -it obce-mini bash

[root@90da3100acaa /]# obd cluster list
[ERROR] obd is running

[root@90da3100acaa /]# obd cluster list
+--------------------------------------------------------+
|                      Cluster List                      |
+---------+----------------------------+-----------------+
| Name    | Configuration Path         | Status (Cached) |
+---------+----------------------------+-----------------+
| mini-ce | /root/.obd/cluster/mini-ce | running         |
+---------+----------------------------+-----------------+

• 备注：如果运行 obd cluster list 得到的结果是 [ERROR] obd is running，那么需要等待几分钟，程序在自动部署，需要一些时间。

[root@90da3100acaa /]# ob-mysql sys
login as root@sys
Command is: obclient -h127.1 -uroot@sys -A -Doceanbase -P2881
Welcome to the OceanBase.  Commands end with ; or \g.
Your MySQL connection id is 3221487625
Server version: 5.7.25 OceanBase 3.1.0 (r-00672c3c730c3df6eef3b359eae548d8c2db5ea2) (Built Jun 22 2021 12:46:28)

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MySQL [oceanbase]> show processlist;
+------------+------+-----------------+-----------+---------+------+--------+------------------+
| Id         | User | Host            | db        | Command | Time | State  | Info             |
+------------+------+-----------------+-----------+---------+------+--------+------------------+
| 3221487625 | root | 127.0.0.1:37578 | oceanbase | Query   |    0 | ACTIVE | show processlist |
+------------+------+-----------------+-----------+---------+------+--------+------------------+
1 row in set (0.002 sec)

MySQL [oceanbase]> \q
Bye
[root@90da3100acaa /]#

[root@90da3100acaa /]# exit
exit
PS C:\Windows\system32>

参考资料

• 旧版 WSL 的手动安装步骤
• 安装 WSL
• 安装Docker Desktop报错WSL 2 installation is incomplete.
• WSL 2 installation is incomplete.报错

学习资源

• OceanBase 文档中心
• OceanBase 社区版入门到实战
• 第一届 OceanBase 技术征文大赛来啦！
• B站 美少女Amber宝宝
• OceanBase 官网
• 墨天轮社区

欢迎各位同学一起来交流学习心得！