镜像安装(单机)
平台适配
当前,支持镜像安装的平台包括:
| 操作系统 | CPU 架构 |
|---|---|
| 所有 Linux 操作系统 | Amd64 |
| Arm64 |
下载镜像
使用 VexDB 提供的官方镜像。使用命令 docker pull 来下载镜像。
其中,tagname 用于标识同一个镜像的不同版本,请查阅 DockerHub 获取当前支持的 Tag 版本。
docker pull shuzhiyinhang/vexdb:tagname
启动容器
启动 VexDB 实例:
docker run --name vexdb --privileged=true -d -e GS_PASSWORD=Vexdb@123 -e DBCOMPATIBILITY=A -e GS_USERNAME=vexdb shuzhiyinhang/vexdb:tagname -v ./data:/home/postgres/data -v ./etc:/home/postgres/vexdb/etc shuzhiyinhang/vexdb:tagname
docker run 参数说明:
- --name:给容器指定一个名称。
- --privileged=true:开启特权模式,赋予容器几乎所有的内核权限和能力,让容器几乎可以像宿主机上的进程一样访问所有硬件和系统资源。
- -d: 后台运行容器并返回容器 ID。
- -e: 设置环境变量。
- GS_PASSWORD:表示数据库初始化用户的密码。长度至少为8位,且必须包含大写字母、小写字母、数字、符号中的三种字符。
- GS_USERNAME:自动创建的用户名称,和初始用户共享密码。
- DBCOMPATIBILITY:表示数据库兼容模式,VexDB 默认的数据库兼容模式是 A,即 Oracle 兼容模式。
- -v:数据库文件默认存储在容器内,一旦更新镜像或删除容器,会导致数据丢失。建议通过
-v参数将数据持久化到本地存储。
连接数据库
使用 VexDB 提供的命令行工具 vsql,打开一个数据库的客户端连接。
# 外部连接命令
vsql -d postgres -U vexdb -W 'Vexdb@123' -h host_ip -p 15432
# 容器内部访问
docker exec -it -u postgres vexdb bash
vsql
vsql 参数说明请参考 vsql 工具。
