使用 Docker 部署

本篇文档将指导你使用 Docker 部署单机版 MatrixOne。

步骤 1：下载安装 Docker

1. 点击 Get Docker，进入 Docker 的官方文档页面，根据你的操作系统，下载安装对应的 Docker。

2. 安装完成后，通过下述代码行确认 Docker 版本，验证 Docker 安装是否成功：

   docker --version

   安装成功，代码示例如下：

   Docker version 20.10.17, build 100c701

3. 在你终端里执行如下命令，启动 Docker 并查看运行状态是否成功：

   systemctl start docker
   systemctl status docker

   表示 Docker 正在运行的代码示例如下，出现 Active: active (running) 即表示 Docker 已经在运行中。

   docker.service - Docker Application Container Engine
      Loaded: loaded (/usr/lib/systemd/system/docker.service; disabled; vendor preset: disabled)
      Active: active (running) since Sat 2022-11-26 17:48:32 CST; 6s ago
        Docs: https://docs.docker.com
    Main PID: 234496 (dockerd)
       Tasks: 8
      Memory: 23.6M

步骤 2：获取 MatrixOne 镜像并启动

使用以下命令将从 Docker Hub 中拉取 MatrixOne 镜像，你可以选择稳定版本镜像，或开发版本镜像。

稳定版本的镜像（0.6.0）开发版本的镜像

docker pull matrixorigin/matrixone:0.6.0
docker run -d -p 6001:6001 --name matrixone matrixorigin/matrixone:0.6.0

获取最新开发版本的镜像，参见Docker Hub，找到最新Tag，拉取镜像。拉取镜像代码示例如下：

docker pull matrixorigin/matrixone:nightly-commitnumber
docker run -d -p 6001:6001 --name matrixone matrixorigin/matrixone:nightly-commitnumber

Note: 如上面代码所示，nightly 为标识的 Tag 版本每天都进行更新，请注意获取最新的镜像。

如需挂载数据目录或配置自定义文件，参见挂载目录到 Docker 容器。

步骤 3：连接 MatrixOne

安装并配置 MySQL 客户端

1. 点击 MySQL Community Downloads，进入到 MySQL 客户端下载安装页面，根据你的操作系统和硬件环境，下拉选择 Select Operating System，再下拉选择 Select OS Version，按需选择下载安装包进行安装。

   Note: 建议 MySQL 客户端版本为 8.0.30 版本及以上。

2. 配置 MySQL 客户端环境变量：

   1. 打开一个新的终端，输入如下命令：

      cd ~
      sudo vim /etc/profile

   2. 回车执行上面的命令后，需要输入 root 用户密码，即你在安装 MySQL 客户端时，你在安装窗口设置的 root 密码；如果没有设置密码，则直接回车跳过即可。

   3. 输入/跳过 root 密码后，即进入了. bash_profile，点击键盘上的 i 进入 insert 状态，即可在文件下方输入如下命令：

      export PATH=/software/mysql/bin:$PATH

   4. 输入完成后，点击键盘上的 esc 退出 insert 状态，并在最下方输入 :wq 保存退出。

   5. 输入命令 source /etc/profile，回车执行，运行环境变量。

   6. 测试 MySQL 是否可用：

      • 方式一：输入命令 mysql -u root -p，回车执行，需要 root 用户密码，显示 mysql> 即表示 MySQL 客户端已开启。

      • 方式二：执行命令 mysql --version，安装成功提示：mysql Ver 8.0.31 for Linux on x86_64 (Source distribution)

   7. MySQL 如可用，关闭当前终端，继续浏览下一章节连接 MatrixOne 服务。

   Tips: 目前，MatrixOne 只兼容 Oracle MySQL 客户端，因此一些特性可能无法在 MariaDB、Percona 客户端下正常工作。

连接 MatrixOne

• 你可以使用 MySQL 命令行客户端来连接 MatrixOne。打开一个新的终端，直接输入以下指令：

  mysql -h IP -P PORT -uUsername -p

  输入完成上述命令后，终端会提示你提供用户名和密码。你可以使用我们的内置帐号：

  · user: dump
  · password: 111

• 你也可以使用 MySQL 客户端下述命令行，输入密码，来连接 MatrixOne 服务：

  mysql -h 127.0.0.1 -P 6001 -udump -p
  Enter password:

目前，MatrixOne 只支持 TCP 监听。