跳到主要内容

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

故障排除

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

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