vendty/pos

Vendty POS Docker镜像使用指南

[[toc]]

概述

本指南提供了从零创建和配置Vendty POS系统实例的参考框架，通过Docker镜像实现POS系统的自动实例化，简化部署与管理流程。

核心功能

1. 自动配置Vendty POS系统运行环境
2. 支持与MySQL数据库集成
3. 提供容器启动、停止、删除等便捷管理命令
4. 适配Linux系统环境

使用场景

• 零售商户快速部署POS销售点系统
• 开发人员搭建Vendty POS开发测试环境
• 企业批量配置多终端POS设备

最低要求

• Linux 2.6.x及以上版本
• Git 2.x及以上版本
• 拥有Vendty POS代码仓库和Docker镜像仓库的访问权限

安装指南

克隆Docker仓库

第一步，将Docker镜像仓库克隆到用户指定的目录：

bash
git clone https://$GITHUB_USER:$GITHUB_PASSWORD@github.com/vendty/docker-image.git $TARGET_PATH
cd $TARGET_PATH

参数说明：

• $GITHUB_USER：你的GitHub用户名
• $GITHUB_PASSWORD：你的GitHub密码
• $TARGET_PATH（可选）：克隆仓库的目标目录

安装开发环境

进入克隆的仓库目录，执行以下命令安装开发环境：

bash
sudo ./docker.sh setup $GITHUB_USER $GITHUB_PASSWORD $POS_REPO_PATH

参数说明：

• $POS_REPO_PATH：Vendty POS代码仓库的克隆目录

生成POS容器

进入Docker仓库目录，执行以下命令生成POS容器：

bash
sudo ./docker.sh run $MYSQL_HOST $MYSQL_USER $MYSQL_PASSWORD $POS_REPO_PATH

参数说明：

• $MYSQL_HOST：MySQL数据库主机地址（若数据库在本地，需使用主机本地IP，可通过ifconfig命令查看）
• $MYSQL_USER：MySQL数据库用户名
• $MYSQL_PASSWORD：MySQL数据库密码

:::tip 若数据库位于本地主机，$MYSQL_HOST需填写主机的本地IP地址，可通过ifconfig命令获取。 :::

实用命令

启动POS容器

bash
sudo ./docker.sh start

停止POS容器

bash
sudo ./docker.sh stop

删除POS容器

bash
sudo ./docker.sh rm