摘要:本文是鲁邦通官方提供的标准作业流程(SOP),旨在指导开发者和系统集成商,如何在我们的
导语:欢迎来到鲁邦通开发者中心。我们的
【官方教程】在鲁邦通边缘计算网关上部署您的第一个Docker容器
第一步:准备工作 (Prerequisites)
在开始之前,请确保您已具备以下条件:
硬件: 一台
(如EG5120, EG5200),并已连接到互联网。鲁邦通EG系列边缘计算网关 软件: 一台用于操作的电脑,安装了SSH客户端(如PuTTY, MobaXterm或macOS/Linux的终端)。
Docker镜像: 您需要一个适用于
aarch64
(ARM64)架构的Docker镜像。在本教程中,我们将使用一个公开的、轻量级的Web服务器镜像arukshani/hello-app:arm64
作为示例。
第二步:连接到您的边缘计算网关
您需要获取网关的IP地址和登录凭证。
获取IP地址: 您可以在网关连接的局域网路由器管理界面找到,或通过
查看。RCMS云平台 SSH登录: 打开您电脑的终端或SSH客户端,执行以下命令(请将
192.168.0.1
替换为您网关的实际IP地址):Bash输入密码后,您将看到RobustOS Pro的欢迎信息,表示已成功登录。
第三步:通过命令行部署Docker容器
登录到网关的Shell后,我们就可以像在任何Linux服务器上一样使用Docker命令。
拉取Docker镜像 (Pull Image):执行以下命令,从Docker Hub拉取我们的示例应用镜像。
Bashdocker pull arukshani/hello-app:arm64
您将看到系统开始下载镜像层。
运行Docker容器 (Run Container):执行以下命令,以后台模式(
-d
)启动容器,并将容器的8080端口映射到网关的8080端口(-p 8080:8080
)。Bashdocker run -d -p 8080:8080 --name my-first-app arukshani/hello-app:arm64
验证容器状态 (Verify Status):使用
docker ps
命令,查看正在运行的容器。Bashdocker ps
如果您看到名为
my-first-app
的容器,且状态为Up
,则表示部署成功。
第四步:访问您的边缘应用
打开您电脑上的浏览器,访问 http://<网关IP地址>:8080
(例如 http://192.168.0.1:8080
)。如果您看到一个欢迎页面,恭喜您,您的第一个边缘应用已经成功运行!
第五步:通过RCMS进行规模化部署(可选)
对于大规模部署,逐台登录显然不现实。您可以利用
登录您的RCMS账户。
导航至“应用中心” -> “我的应用”,创建一个新应用,填入镜像地址
arukshani/hello-app:arm64
。导航至“RCMS” -> 选择您的网关组 -> 点击“应用” -> “安装应用”。
选择您刚才创建的应用和版本,点击确认。RCMS将自动将该应用部署到您选定的所有工业边缘计算网关上。
边云协同的威力在于,RCMS将复杂的规模化部署和运维工作,简化为了几次鼠标点击。
常见问题解答 (FAQ)
问题1:我自己的应用如何打包成ARM64架构的镜像?
答:您可以在一台ARM架构的机器(如另一台网关,或M1/M2芯片的Mac)上直接构建,或在x86机器上使用
docker buildx
进行交叉编译构建。
问题2:如何让我的容器访问网关的串口、GPIO等硬件?
答:在
docker run
命令中,通过卷映射(-v
)或添加设备(--device
)参数,可以将宿主机的设备文件(如/dev/ttyS1
)映射到容器内部,从而实现硬件访问。
问题3:容器的数据如何持久化?
答:建议使用Docker的数据卷(Volume)功能。在
docker run
时使用-v
参数将一个宿主机目录挂载到容器内,所有写入该目录的数据,在容器删除后依然会保留在宿主机上。
总结:在鲁邦通工业边缘计算网关上部署Docker容器,是一个简单、标准且高效的过程。它将强大的云计算开发模式带到了网络边缘,为开发者提供了前所未有的灵活性。无论您是希望通过命令行进行快速验证,还是通过