init

README.md

@@ -0,0 +1,123 @@
+# 使用Docker快速部署GoEdge管理平台（包含API节点）和边缘节点
+
+## 部署前的准备工作
+
+### 安装Docker
+
+管理平台和边缘节点都需要先安装Docker，新版本的Docker已包含compose插件，因此我们只需要执行官方推荐的命令安装即可：
+
+```
+curl -sSL https://get.docker.com | sh
+```
+
+### 部署管理平台
+
+首先编写docker-compose.yaml，因为将管理平台所依赖的mysql加进来，所以这里使用docker compose的方式进行，也是方便后期迁移等管理工作。
+
+mysql的版本要求，官方建议使用mysql 8，最低不低于mysql 5.7.8，系统内存建议4GB以上。
+
+首先进入你想存放docker-compose.yaml的路径，比如/opt/goedge，然后进入该路径后创建docker-compose.yaml，输入以下内容：
+
+```
+version: "3"
+
+networks:
+  goedge:
+    external: false
+
+services:
+  mysqld:
+    image: mysql:8
+    container_name: mysqld
+    environment:
+      - MYSQL_ROOT_PASSWORD=root
+      - MYSQL_USER=edges
+      - MYSQL_PASSWORD=edges
+      - MYSQL_DATABASE=edges
+    networks:
+      - goedge
+    volumes:
+      - ./data/db/mysql:/var/lib/mysql:rw
+    restart: always
+
+  edge-admin:
+    image: icodex/edge-admin:1.3.3
+    container_name: edge-admin
+    ports:
+      - 7788:7788/tcp
+      - 8001:8001/tcp
+    networks:
+      - goedge
+    volumes:
+      - ./data/edge-admin/configs:/usr/local/goedge/edge-admin/configs
+      - ./data/edge-api/configs:/usr/local/goedge/edge-admin/edge-api/configs
+    restart: always
+```
+
+以上使用了mysql 8的镜像，接着edge-admin是管理平台的镜像。确定没有端口冲突之后，执行命令启动：
+
+```
+docker compose up -d
+```
+
+运行后，打开浏览器，输入服务器IP地址和7788端口号，进入安装界面：
+
+![](https://icodex.org/wp-content/uploads/2024/02/WX20240224-231039@2x-1354x800.png)
+
+注意⚠️！因为这里的网络类型是容器内共享的，因此在数据库信息填写这里，数据库的地址只需要填写mysql的容器名即可，比如这里的：mysqld。数据库名、数据库账号、数据库密码均为edges。一直下一步就好了。
+
+![](https://icodex.org/wp-content/uploads/2024/02/WX20240224-231233@2x-953x800.png)
+
+ps：如果你现在的宿主机系统里面已经有mysql，不想再多运行一个浪费资源，则需要考虑删掉docker-compose.yaml里的mysql服务，并将网络类型更改为Host网络类型，以方便与宿主机上的mysql通信，如下：
+
+```
+version: "3"
+
+services:
+  edge-admin:
+    image: icodex/edge-admin:1.3.3
+    container_name: edge-admin
+    network_mode: host
+    volumes:
+      - ./data/edge-admin/configs:/usr/local/goedge/edge-admin/configs
+      - ./data/edge-api/configs:/usr/local/goedge/edge-admin/edge-api/configs
+    restart: always
+```
+
+docker-compose.yaml编辑好之后，确定端口没有冲突，就可以执行以下命令启动整个系统了！
+
+### 部署边缘节点
+
+在上面的部署中，已经完成了管理平台的部署，这时可以按照官方教程添加边缘节点的方式进行添加。也可以按以下步骤，部署一个Docker容器形态的边缘节点。
+
+这里使用GoEdge的自动注册功能，因此需要先在GoEdge管理界面 – 边缘节点 – 找到你所在集群 – 集群节点 – 安装升级 – 自动注册，把endpoints、clusterId、secret三个值记录下来。
+
+![](https://icodex.org/wp-content/uploads/2024/02/WX20240224-230019@2x-1353x800.png)
+
+然后准备一个docker-compose.yaml，输入以下内容，注意替换环境变量里相应的值
+
+```
+version: "3"
+
+services:
+  edge-node:
+    image: icodex/edge-node:1.3.3
+    container_name: edge-node
+    environment:
+      - ENDPOINTS=http://xxx.com:8001
+      - CLUSTERID=xxx
+      - SECRET=xxx
+    network_mode: host
+    volumes:
+      - ./data/edge-node/cache:/opt/cache
+      - ./data/edge-node/configs:/usr/local/goedge/edge-node/configs
+    restart: always
+```
+
+接着使用docker compose命令启动它，很快就可以在管理平台看到这台上线的主机了。
+
+以上，是完整部署GoEdge的全部步骤，非常简单吧！
+
+## 最后
+
+这个项目应该不算造轮子，只是我个人习惯使用docker进行服务的管理，docker运行毕竟套了多一层虚拟化，因此在边缘节点的容器的网络选择上，建议使用host类型，与宿主机共享会比较好。