跳到主要内容

Linux/macOS上的Docker

在本指南中，您将在Linux/macOS上使用Docker部署MyEMS。

前提​

  • 主机上已安装docker、npm。
  • 已安装MySQL服务器。
  • MySQL数据库可以从Docker Engine运行的主机连接。

第1步 数据库​

参考 Database

第2步 myems-api​

在本节中，您将在Docker上安装myems-api。

  • 将源代码复制到根目录
cp -r myems/myems-api /
cd /myems-api
  • 基于example.env文件创建.env
警告

用真实的主机IP地址手动替换127.00.1。

cp example.env .env
  • 用源代码编译镜像
docker build -t myems/myems-api .

为多个平台构建，而不仅仅是为当前用户运行的体系结构和操作系统构建。 您可以使用buildx并设置--platform标志来指定构建输出的目标平台（例如，linux/amd64、linux/arm64或darwin/amd64）。

docker buildx build --platform=linux/amd64 -t myems/myems-api .
  • 运行Docker容器

在主机上， 创建一个共享上传文件的文件夹:

mkdir /myems-upload

创建一个容器，将共享上传文件夹绑定到容器，并将.env绑定到容器：

docker run -d -p 8000:8000 -v /myems-upload:/var/www/myems-admin/upload -v /myems-api/.env:/app/.env:ro --log-opt max-size=1m --log-opt max-file=2 --restart always --name myems-api myems/myems-api

  • -d 在后台运行容器并打印容器ID

  • -p 向主机发布容器的端口，8000:8000（主机：容器）将容器的端口8000（右侧）绑定到主机的TCP端口8000（左侧）。

  • -v 如果使用-v或--volume绑定装载Docker主机上尚不存在的文件或目录，-v将为您创建端点。它始终创建为目录。 ro选项（如果存在）会导致绑定装载以只读方式装载到容器中。 对于 v4.7.0 或更早的版本, 用 '/code/.env' 而不是 '/app/.env'。

  • --log-opt max-size=2m 滚动前日志的最大大小。正整数加上表示度量单位（k、m或g）的修饰符。

  • --log-opt max-file=2 可以存在的最大日志文件数。如果滚动日志会创建多余的文件，则会删除最旧的文件。正整数。

  • --restart 重新启动策略以在容器退出时应用

  • --name 为容器指定名称

冒号前的绝对路径表示主机上的路径，可能因系统而异。 冒号后的绝对路径用于容器上的路径，不能更改。 通过将.env作为绑定装载参数传递，您可以稍后更改配置值。 如果更改了.env文件，请重新启动容器以使更改生效。

如果您想将镜像迁移到另一台计算机，

  • 将镜像导出到tar文件
docker save --output myems-api.tar myems/myems-api
  • 将tar文件复制到另一台计算机，然后从tar文件加载镜像
docker load --input .\myems-api.tar

第3步 myems-admin​

在本节中，您将在Docker上安装myems-admin。

  • 将源代码复制到根目录
cp -r myems/myems-admin /
cd /myems-admin
警告

手动将nginx.conf中的127.00.1:8000替换为实际的主机IP地址和myems-api端口

nano nginx.conf
      proxy_pass http://127.0.0.1:8000/;
  • 用源代码编译镜像
docker build -t myems/myems-admin .

如果为多个平台构建，而不仅仅是为当前用户运行的体系结构和操作系统构建。 您可以使用buildx并设置--platform标志来指定构建输出的目标平台（例如，linux/amd64、linux/arm64或darwin/amd64）。

docker buildx build --platform=linux/amd64 -t myems/myems-admin .
  • 运行Docker容器

在主机上， 创建一个共享上传文件的文件夹:

mkdir /myems-upload

将共享上传文件夹绑定到容器，并将.env绑定到容器： 创建一个容器，绑定挂载共享上传文件文件夹到容器，并绑定挂载nginx.conf

docker run -d -p 8001:8001 -v /myems-upload:/var/www/myems-admin/upload -v /myems-admin/nginx.conf:/etc/nginx/nginx.conf:ro --log-opt max-size=1m --log-opt max-file=2 --restart always --name myems-admin myems/myems-admin

  • -d 在后台运行容器并打印容器ID

  • -p 将容器的端口发布到主机，8001:8001（主机：容器）将容器的8001端口（右侧）绑定到主机的TCP端口8001（左侧）。

  • -v 如果使用-v或--volume绑定装载Docker主机上尚不存在的文件或目录， -v为您创建端点。它始终创建为目录。 ro选项（如果存在）会导致绑定装载以只读方式装载到容器中。 对于 v4.7.0 或更早的版本, 用 '/code/.env' 而不是 '/app/.env'。

  • --log-opt max-size=2m 滚动前日志的最大大小。正整数加上表示度量单位（k、m或g）的修饰符。

  • --log-opt max-file=2 可以存在的最大日志文件数。如果滚动日志会创建多余的文件，则会删除最旧的文件。正整数。

  • --restart 重新启动策略以在容器退出时应用

  • --name 为容器指定名称

如果您想将镜像迁移到另一台计算机，

  • 将镜像导出到tar文件
docker save --output myems-admin.tar myems/myems-admin
  • 将tar文件复制到另一台计算机，然后从tar文件加载镜像
docker load --input .\myems-admin.tar

第4步 myems-modbus-tcp​

在本节中，您将在Docker上安装myems-modbus-tcp。

  • 将源代码复制到根目录
cp -r myems/myems-modbus-tcp /
cd /myems-modbus-tcp
  • 基于example.env文件创建.env
警告

用真实的主机IP地址手动替换127.00.1。

cp example.env .env
  • 用源代码编译镜像
docker build -t myems/myems-modbus-tcp .

为多个平台构建，而不仅仅是为当前用户运行的体系结构和操作系统构建。 您可以使用buildx并设置--platform标志来指定构建输出的目标平台（例如，linux/amd64、linux/arm64或darwin/amd64）。

docker buildx build --platform=linux/amd64 -t myems/myems-modbus-tcp .
  • 运行Docker容器 (以超级用户运行)
docker run -d -v /myems-modbus-tcp/.env:/app/.env:ro --log-opt max-size=1m --log-opt max-file=2 --restart always --name myems-modbus-tcp myems/myems-modbus-tcp

  • -d 在后台运行容器并打印容器ID

  • -v 如果使用-v或--volume绑定装载Docker主机上尚不存在的文件或目录， -v为您创建端点。它始终创建为目录。 ro选项（如果存在）会导致绑定装载以只读方式装载到容器中。 对于 v4.7.0 或更早的版本, 用 '/code/.env' 而不是 '/app/.env'。

  • --log-opt max-size=2m 滚动前日志的最大大小。正整数加上表示度量单位（k、m或g）的修饰符。

  • --log-opt max-file=2 可以存在的最大日志文件数。如果滚动日志会创建多余的文件，则会删除最旧的文件。正整数。

  • --restart 重新启动策略以在容器退出时应用

  • --name 为容器指定名称

冒号前的绝对路径表示主机上的路径，可能因系统而异。 冒号后的绝对路径用于容器上的路径，不能更改。 通过将.env作为绑定装载参数传递，您可以稍后更改配置值。 如果更改了.env文件，请重新启动容器以使更改生效。

  • 迁移Docker容器

为了将容器迁移到另一台计算机，

  • 将镜像导出到tar文件
docker save --output myems-modbus-tcp.tar myems/myems-modbus-tcp
  • 将tar文件复制到另一台计算机，然后从tar文件加载镜像
docker load --input .\myems-modbus-tcp.tar

第5步 myems-cleaning​

在本节中，您将在Docker上安装myems-cleaning。

  • 将源代码复制到根目录
cp -r myems/myems-cleaning /
cd /myems-cleaning
  • 基于example.env文件创建.env
警告

用真实的主机IP地址手动替换127.00.1。

cp example.env .env
  • 用源代码编译镜像
docker build -t myems/myems-cleaning .

为多个平台构建，而不仅仅是为当前用户运行的体系结构和操作系统构建。 您可以使用buildx并设置--platform标志来指定构建输出的目标平台（例如，linux/amd64、linux/arm64或darwin/amd64）。

docker buildx build --platform=linux/amd64 -t myems/myems-cleaning .
  • 运行Docker容器 (以超级用户运行)
docker run -d -v /myems-cleaning/.env:/app/.env:ro --log-opt max-size=1m --log-opt max-file=2 --restart always --name myems-cleaning myems/myems-cleaning

  • -d 在后台运行容器并打印容器ID

  • -v 如果使用-v或--volume绑定装载Docker主机上尚不存在的文件或目录， -v为您创建端点。它始终创建为目录。 ro选项（如果存在）会导致绑定装载以只读方式装载到容器中。 对于 v4.7.0 或更早的版本, 用 '/code/.env' 而不是 '/app/.env'。

  • --log-opt max-size=2m 滚动前日志的最大大小。正整数加上表示度量单位（k、m或g）的修饰符。

  • --log-opt max-file=2 可以存在的最大日志文件数。如果滚动日志会创建多余的文件，则会删除最旧的文件。正整数。

  • --restart 重新启动策略以在容器退出时应用

  • --name 为容器指定名称

冒号前的绝对路径表示主机上的路径，可能因系统而异。 冒号后的绝对路径用于容器上的路径，不能更改。 通过将.env作为绑定装载参数传递，您可以稍后更改配置值。 如果更改了.env文件，请重新启动容器以使更改生效。

  • 迁移Docker容器

为了将容器迁移到另一台计算机，

  • 将镜像导出到tar文件
docker save --output myems-cleaning.tar myems/myems-cleaning
  • 将tar文件复制到另一台计算机，然后从tar文件加载镜像
docker load --input .\myems-cleaning.tar

第6步 myems-normalization​

在本节中，您将在Docker上安装myems-normalization。

  • 将源代码复制到根目录
cp -r myems/myems-normalization /
cd /myems-normalization
  • 基于example.env文件创建.env
警告

用真实的主机IP地址手动替换127.00.1。

cp example.env .env
  • 用源代码编译镜像
docker build -t myems/myems-normalization .

为多个平台构建，而不仅仅是为当前用户运行的体系结构和操作系统构建。 您可以使用buildx并设置--platform标志来指定构建输出的目标平台（例如，linux/amd64、linux/arm64或darwin/amd64）。

docker buildx build --platform=linux/amd64 -t myems/myems-normalization .
  • 运行Docker容器 (以超级用户运行)
docker run -d -v /myems-normalization/.env:/app/.env:ro --log-opt max-size=1m --log-opt max-file=2 --restart always --name myems-normalization myems/myems-normalization

  • -d 在后台运行容器并打印容器ID

  • -v 如果使用-v或--volume绑定装载Docker主机上尚不存在的文件或目录， -v为您创建端点。它始终创建为目录。 ro选项（如果存在）会导致绑定装载以只读方式装载到容器中。 对于 v4.7.0 或更早的版本, 用 '/code/.env' 而不是 '/app/.env'。

  • --log-opt max-size=2m 滚动前日志的最大大小。正整数加上表示度量单位（k、m或g）的修饰符。

  • --log-opt max-file=2 可以存在的最大日志文件数。如果滚动日志会创建多余的文件，则会删除最旧的文件。正整数。

  • --restart 重新启动策略以在容器退出时应用

  • --name 为容器指定名称

冒号前的绝对路径表示主机上的路径，可能因系统而异。 冒号后的绝对路径用于容器上的路径，不能更改。 通过将.env作为绑定装载参数传递，您可以稍后更改配置值。 如果更改了.env文件，请重新启动容器以使更改生效。

  • 迁移Docker容器

为了将容器迁移到另一台计算机，

  • 将镜像导出到tar文件
docker save --output myems-normalization.tar myems/myems-normalization
  • 将tar文件复制到另一台计算机，然后从tar文件加载镜像
docker load --input .\myems-normalization.tar

第7步 myems-aggregation​

在本节中，您将在Docker上安装myems-aggregation。

  • 将源代码复制到根目录
cp -r myems/myems-aggregation /
cd /myems-aggregation
  • 基于example.env文件创建.env
cp example.env .env
警告

用真实的主机IP地址手动替换127.00.1。

  • 用源代码编译镜像
docker build -t myems/myems-aggregation .

为多个平台构建，而不仅仅是为当前用户运行的体系结构和操作系统构建。 您可以使用buildx并设置--platform标志来指定构建输出的目标平台（例如，linux/amd64、linux/arm64或darwin/amd64）。

docker buildx build --platform=linux/amd64 -t myems/myems-aggregation .
  • 运行Docker容器 (以超级用户运行)
docker run -d -v /myems-aggregation/.env:/app/.env:ro --log-opt max-size=1m --log-opt max-file=2 --restart always --name myems-aggregation myems/myems-aggregation

  • -d 在后台运行容器并打印容器ID

  • -v 如果使用-v或--volume绑定装载Docker主机上尚不存在的文件或目录， -v为您创建端点。它始终创建为目录。 ro选项（如果存在）会导致绑定装载以只读方式装载到容器中。 对于 v4.7.0 或更早的版本, 用 '/code/.env' 而不是 '/app/.env'。

  • --log-opt max-size=2m 滚动前日志的最大大小。正整数加上表示度量单位（k、m或g）的修饰符。

  • --log-opt max-file=2 可以存在的最大日志文件数。如果滚动日志会创建多余的文件，则会删除最旧的文件。正整数。

  • --restart 重新启动策略以在容器退出时应用

  • --name 为容器指定名称

冒号前的绝对路径表示主机上的路径，可能因系统而异。 冒号后的绝对路径用于容器上的路径，不能更改。 通过将.env作为绑定装载参数传递，您可以稍后更改配置值。 如果更改了.env文件，请重新启动容器以使更改生效。

  • 迁移Docker容器

  • 将镜像导出到tar文件

docker save --output myems-aggregation.tar myems/myems-aggregation
  • 将tar文件复制到另一台计算机，然后从tar文件加载镜像
docker load --input .\myems-aggregation.tar

第8步 myems-web​

在本节中，您将在Docker上安装myems-web。

  • 修改配置文件：
备注

从 https://mapbox.com 获取 mapboxToken 然后设置 showOnlineMap 为 true. 如果要关闭在线地图功能，设置 showOnlineMap 为 false

cd myems/myems-web
nano src/config.js
警告

将nginx.conf中的127.00.1:8000替换为实际的HOST IP和myems-api端口

cd myems/myems-web
nano nginx.conf
  • 将源代码复制到根目录
cp -r myems/myems-web /
cd /myems-web
信息

您可以安全地忽略本节中的命令“npm run build”，因为它内置在Dockerfile中

  • 用源代码编译镜像
docker build -t myems/myems-web .
docker image prune -f

为多个平台构建，而不仅仅是为当前用户运行的体系结构和操作系统构建。 您可以使用buildx并设置--platform标志来指定构建输出的目标平台（例如，linux/amd64、linux/arm64或darwin/amd64）。

docker buildx build --platform=linux/amd64 -t myems/myems-web .
docker image prune -f
  • 运行Docker容器

在主机上，将nginx.conf绑定到容器

docker run -d -p 80:80 -v /myems-web/nginx.conf:/etc/nginx/nginx.conf:ro --log-opt max-size=1m --log-opt max-file=2 --restart always --name myems-web myems/myems-web

  • -d 在后台运行容器并打印容器ID

  • -p 向主机发布容器的端口，80:80（主机：容器）将容器的端口80（右）绑定到主机的TCP端口80（左）。

  • -v 如果使用-v或--volume绑定装载Docker主机上尚不存在的文件或目录， -v为您创建端点。它始终创建为目录。 ro选项（如果存在）会导致绑定装载以只读方式装载到容器中。 对于 v4.7.0 或更早的版本, 用 '/code/.env' 而不是 '/app/.env'。

  • --log-opt max-size=2m 滚动前日志的最大大小。正整数加上表示度量单位（k、m或g）的修饰符。

  • --log-opt max-file=2 可以存在的最大日志文件数。如果滚动日志会创建多余的文件，则会删除最旧的文件。正整数。

  • --restart 重新启动策略以在容器退出时应用

  • --name 为容器指定名称

如果您想将镜像迁移到另一台计算机，

  • 将镜像导出到tar文件
docker save --output myems-web.tar myems/myems-web
  • 将tar文件复制到另一台计算机，然后从tar文件加载镜像
docker load --input .\myems-web.tar

安装后​

祝贺！您现在可以登录MyEMS Admin UI和Web UI。

默认端口​

MyEMS Web UI: 80

MyEMS API: 8000

MyEMS Admin UI: 8001

默认密码​

Admin UI
administrator

!MyEMS1
Web UI
administrator@myems.io

!MyEMS1

故障排除​

如何解决镜像拉取超时问题

由于运营商网络问题，可能会导致您拉取镜像变慢，使用阿里云免费镜像加速服务 登录阿里云控制台: 容器镜像服务 / 镜像工具 / 镜像加速器