Skip to main content

SaaS 介绍

电商推荐 SaaS 操作手册

1. 环境依赖安装​

1.1 硬件配置要求​

推荐使用不低于 4 Core x 8G，50G 剩余硬盘空间的机器。

1.2 操作系统要求​

推荐使用 Ubuntu 20.04 LTS。

如果安装依赖过程中遇到apt --fix-broken install 报错，可以运行一下命令：

1 sudo dpkg -i --force-overwrite /var/cache/apt/archives/linux-tools-common_5.4.0-126.142_all.deb
2 sudo apt -f install

Ubuntu 镜像加速

如果 apt-get 安装软件慢，可以使用华为云 Ubuntu 镜像加速。

  1. 备份配置文件。
1 sudo cp -a /etc/apt/sources.list /etc/apt/sources.list.bak
  1. 修改 sources.list 文件，将 http://archive.ubuntu.com 和 http://security.ubuntu.com 替换成 http://repo.huaweicloud.com， 可以参考如下命令。
1 sudo sed -i "s@http://.*archive.ubuntu.com@http://repo.huaweicloud.com@g" /etc/apt/sources.list
2 sudo sed -i "s@http://.*security.ubuntu.com@http://repo.huaweicloud.com@g" /etc/apt/sources.list
  1. 执行 sudo apt-get update 更新索引。
1 sudo apt-get update

1.3 Docker​

参考：https://docs.docker.com/engine/install/ubuntu/

下面是在 Ubuntu 20.04 上从阿里云安装 Docker 的步骤。

  1. 安装 Docker 官方 PGP key 阿里云镜像。
1 sudo apt-get update && sudo apt-get install -y ca-certificates curl gnupg lsb-release && sudo mkdir -p /etc/apt/keyrings && sudo rm -f /etc/apt/keyrings/docker.gpg && curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  1. 添加 Docker 官方 apt 源阿里云镜像。
1 echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  1. 安装 Docker 和 Docker Compose。
1 sudo apt-get update && sudo apt-get install -y docker-ce=5:20.10.14~3-0~ubuntu-focal docker-ce-cli=5:20.10.14~3-0~ubuntu-focal containerd.io docker-compose-plugin
  1. 将当前用户添加到 docker 组并重新登录。
1 sudo usermod -a -G docker $USER

Docker Compose

如果是参照上述步骤安装 Docker，则 Docker Compose 已安装好。否则可以参考 Install the plugin manually 或以下命令安装 Docker Compose。

1 DOCKER_CONFIG="$(dirname $(dirname $(realpath $(which docker))))/libexec/docker"
2 sudo mkdir -p ${DOCKER_CONFIG}/cli-plugins
3 sudo curl -SL https://github.com/docker/compose/releases/download/v2.6.0/docker-compose-linux-x86_64 -o ${DOCKER_CONFIG}/cli-plugins/docker-compose
4 sudo chmod a+x ${DOCKER_CONFIG}/cli-plugins/docker-compose

Docker 镜像加速

如果 Pull Docker 镜像慢，可以参考 Docker 镜像加速 添加镜像加速。

1 echo '{"registry-mirrors":["https://docker.mirrors.ustc.edu.cn/"]}' | sudo tee /etc/docker/daemon.json > /dev/null
2 sudo systemctl daemon-reload
3 sudo systemctl restart docker
4 sudo docker info | grep "Registry Mirrors" -A1

1.4 Python 3.8​

使用以下命令安装 Python 及 venv、pip。

1 sudo apt-get install -y python3 python3-venv python3-pip

PyPI 镜像加速

如果 pip 安装 Python wheel 包慢，可以添加以下 PyPI 镜像加速。

1 python3 -m pip config set global.index-url "https://repo.huaweicloud.com/repository/pypi/simple/"
2 python3 -m pip config set global.extra-index-url "https://repo.huaweicloud.com/repository/pypi/simple/ https://pypi.tuna.tsinghua.edu.cn/simple/ https://mirrors.aliyun.com/pypi/simple/ https://pypi.org/simple/"

注：index-url 只能有一个镜像，extra-index-url 可以空格分隔加多个镜像，把官方的放到 extra-index-url 最后保底，防止最新的包未及时同步。

2. MetaSpore Flow 命令行接口​

metasporecli wheel 包实现 metaspore 命令，可用于管理 MetaSpore flow。

可使用以下命令安装 metasporecli。建议用户创建 Python virtualenv 安装 metasporecli。

1 python3 -m pip install metasporecli

安装好 metasporecli 后，当当前目录包含 MetaSpore flow 配置文件 metaspore-flow.yml 时，用户可使用以下命令启动 MetaSpore flow：

1 metaspore flow up

及以下命令停止 MetaSpore flow：

1 metaspore flow down

使用以下命令可查看 metaspore 命令的帮助。

1 metaspore -h
2 metaspore flow -h

3. 数据准备​

1 mkdir work && cd work
2 git clone git@github.com:meta-soul/MetaSpore.git
3 cd demo/ecommerce
4 docker-compose -f init_container/create-database.yml up -d
5 ./init_data/insert_mysql_data.sh

5. 启动 MetaSporeFlow 推荐 SaaS​

1 metaspore flow up

6. 前端测试​

打开网址：http://localhost:41730 或 http://recommend-demo.dmetasoul.com/

猜你喜欢推荐

图片 看了又看推荐

图片

视频：

  • 哔哩哔哩
  • Youtube

7. 关闭 MetaSporeFlow 推荐 SaaS​

1 docker-compose -f init_container/create-database.yml down
2 cd ecommerce_demo
3 metaspore flow down