Skip to content

Commit

Permalink
Merge pull request #17 from inhandnet/pre-release
Browse files Browse the repository at this point in the history
Add IG974
  • Loading branch information
soodifficult committed Oct 20, 2021
2 parents f2b36a4 + 6111c46 commit b7191f8
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 30 deletions.
67 changes: 37 additions & 30 deletions Docker-user-manual-CN.md
@@ -1,12 +1,12 @@
# InGateway902 Docker用户手册
InGateway902系列边缘计算网关(以下简称IG902)支持托管docker镜像,您可以将您的docker镜像发布到IG902上,快速部署和运行您自行开发的应用程序。为了说明如何使用IG902的Docker环境,本文档将演示如何在IG902上运行一个Nginx镜像,该镜像用于HTTP,HTTPS,SMTP,POP3和IMAP协议的开源反向代理服务器,以及负载平衡器,HTTP缓存和Web服务器。 <br/>
# InGateway902/974 Docker用户手册
InGateway902/974系列边缘计算网关(以下简称网关)支持托管docker镜像,您可以将您的docker镜像发布到网关上,快速部署和运行您自行开发的应用程序。为了说明如何使用网关的Docker环境,本文档将演示如何在网关上运行一个Nginx镜像,该镜像用于HTTP,HTTPS,SMTP,POP3和IMAP协议的开源反向代理服务器,以及负载平衡器,HTTP缓存和Web服务器。 <br/>
Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的Linux机器或Windows 机器上,也可以实现虚拟化,容器是完全使用沙箱机制,相互之间不会有任何接口。

- [1.准备IG902硬件设备及其网络环境](#prepare-ig902-hardware-and-network-environment)
- [1.1 接通IG902电源并使用网线连接PC](#connect-ig902-to-the-power-source-and-to-a-pc-with-a-network-cable)
- [1.2 访问IG902](#set-lan-parameters)
- [1.3 IG902连接Internet](#set-wan-parameters)
- [1.4 更新IG902固件版本](#update-the-firmware)
- [1.准备网关硬件设备及其网络环境](#prepare-ig902-hardware-and-network-environment)
- [1.1 接通网关电源并使用网线连接PC](#connect-ig902-to-the-power-source-and-to-a-pc-with-a-network-cable)
- [1.2 访问网关](#set-lan-parameters)
- [1.3 网关连接Internet](#set-wan-parameters)
- [1.4 更新网关固件版本](#update-the-firmware)
- [2.启用并配置Docker管理器](#enable-and-configure-docker-manager)
- [2.1 安装Docker SDK并启用Docker管理器](#install-docker-sdk-and-enable-docker-manager)
- [2.2 配置Docker管理器--Portainer](#configure-docker-manager-portainer)
Expand All @@ -16,7 +16,7 @@ Docker 是一个开源的应用容器引擎,让开发者可以打包他们的
- [附录](#appendix)
- [在容器中调用串口进行通讯](#call-the-serial-port-in-the-container-for-communication)
- [设置容器永久运行](#set-the-container-to-run-permanently)
- [在IG902中运行Ubuntu](#run-ubuntu-in-ig902)
- [在网关中运行Ubuntu](#run-ubuntu-in-ig902)
- [通过容器构建镜像(创建镜像保存容器配置)](#build-images-from-containers)
- [如何从gitlab/github上下载docker镜像](#how-to-download-docker-images-from-gitlab-github)
- [FAQ](#faq)
Expand All @@ -25,29 +25,36 @@ Docker 是一个开源的应用容器引擎,让开发者可以打包他们的

<a id="prepare-ig902-hardware-and-network-environment"> </a>

## 1.准备IG902硬件设备及其网络环境
## 1.准备网关硬件设备及其网络环境

<a id="connect-ig902-to-the-power-source-and-to-a-pc-with-a-network-cable"> </a>

### 1.1 接通IG902电源并使用网线连接PC
接通IG902的电源并按照拓扑使用以太网线连接PC和IG902。
### 1.1 接通网关电源并使用网线连接PC
- 接通IG902的电源并按照拓扑使用以太网线连接PC和IG902。

![](images/2020-01-21-10-07-32.png)
![](images/2020-01-21-10-07-32.png)

- 接通IG974的电源并按照拓扑使用以太网线连接PC和IG974。

![](images/2021-10-14-18-02-47.png)

<a id="set-lan-parameters"> </a>

### 1.2 访问IG902
访问IG902,请参考[访问IG902](http://manual.ig.inhand.com.cn/zh_CN/latest/IG902-Quick-Start-Manual-CN.html#set-lan-parameters)
### 1.2 访问网关
- 访问IG902,请参考[访问IG902](http://manual.ig.inhand.com.cn/zh_CN/latest/IG902-Quick-Start-Manual-CN.html#set-lan-parameters)
- 访问IG974,请参考[访问IG974](http://manual.ig.inhand.com.cn/zh_CN/latest/IG974-Quick-Start-Manual-CN.html#set-lan-parameters)

<a id="set-wan-parameters"> </a>

### 1.3 IG902连接Internet
设置IG902联网,请参考[IG902连接Internet](http://manual.ig.inhand.com.cn/zh_CN/latest/IG902-Quick-Start-Manual-CN.html#set-wan-parameters)
### 1.3 网关连接Internet
- 设置IG902联网,请参考[IG902连接Internet](http://manual.ig.inhand.com.cn/zh_CN/latest/IG902-Quick-Start-Manual-CN.html#set-wan-parameters)
- 设置IG974联网,请参考[IG974连接Internet](http://manual.ig.inhand.com.cn/zh_CN/latest/IG974-Quick-Start-Manual-CN.html#set-wan-parameters)

<a id="update-the-firmware"> </a>

### 1.4 更新IG902固件版本
如需获取IG902产品最新固件版本及其功能特性信息,请访问[资源中心](https://www.inhand.com.cn/downlist/edge-computing-gateway/)。如需更新IG902的固件版本,请参考[更新IG902软件版本](http://manual.ig.inhand.com.cn/zh_CN/latest/IG902-Quick-Start-Manual-CN.html#update-the-software)。<font color=#FF0000>(固件版本应为2.0.0.r12057及以上)</font>
### 1.4 更新网关固件版本
- 如需获取IG902产品最新固件版本及其功能特性信息,请访问[资源中心](https://www.inhand.com.cn/downlist/edge-computing-gateway/)。如需更新IG902的固件版本,请参考[更新IG902软件版本](http://manual.ig.inhand.com.cn/zh_CN/latest/IG902-Quick-Start-Manual-CN.html#update-the-software)。<font color=#FF0000>(固件版本应为2.0.0.r12057及以上)</font>
- 如需获取IG974产品最新固件版本及其功能特性信息,请访问[资源中心](https://www.inhand.com.cn/downlist/edge-computing-gateway/)。如需更新IG974的固件版本,请参考[更新IG974软件版本](http://manual.ig.inhand.com.cn/zh_CN/latest/IG974-Quick-Start-Manual-CN.html#update-the-software)。<font color=#FF0000>(固件版本应为2.0.0.r14169及以上)</font>

<a id="enable-and-configure-docker-manager"> </a>

Expand All @@ -57,11 +64,11 @@ Docker 是一个开源的应用容器引擎,让开发者可以打包他们的

### 2.1 安装Docker SDK并启用Docker管理器
Docker SDK集成了运行docker镜像所需的运行环境以及docker镜像管理器,在使用Docker前必须先安装Docker SDK,你可以访问[资源中心](https://www.inhand.com.cn/downlist/edge-computing-gateway/)获取软件版本。 </br>
- 步骤1:已有Docker SDK后,进入IG902的“边缘计算>>Docker管理”页面,关闭Docker管理器并导入Docker SDK。
- 步骤1:已有Docker SDK后,进入网关的“边缘计算>>Docker管理”页面,关闭Docker管理器并导入Docker SDK。

![](images/2020-07-01-15-54-37.png)

- 步骤2:导入后,IG902将自动安装Docker SDK,安装过程通常需要1-2分钟,请耐心等候。安装成功后,勾选启用Docker管理器并点击“提交”。
- 步骤2:导入后,网关将自动安装Docker SDK,安装过程通常需要1-2分钟,请耐心等候。安装成功后,勾选启用Docker管理器并点击“提交”。

![](images/2020-07-01-16-10-00.png)

Expand All @@ -72,26 +79,26 @@ Docker SDK集成了运行docker镜像所需的运行环境以及docker镜像管
<a id="configure-docker-manager-portainer"> </a>

### 2.2 配置Docker管理器--Portainer
IG902使用Portainer构建,管理和维护Docker镜像和容器。关于Portainer的详细介绍和使用说明请查看[Portainer官网](https://www.portainer.io/overview/)本文档将为您演示如何在IG902上添加并部署运行一个Nginx docker镜像。
网关使用Portainer构建,管理和维护Docker镜像和容器。关于Portainer的详细介绍和使用说明请查看[Portainer官网](https://www.portainer.io/overview/)本文档将为您演示如何在网关上添加并部署运行一个Nginx docker镜像。

<a id="access-portainer"> </a>

#### 2.2.1 访问Portainer
- 步骤1:点击Portainer的访问按钮,随后Portainer会提示您需要输入用户名和密码。此时从IG902的“边缘计算>>Docker管理”页面复制用户名和设置的密码后并点击“登录”即可。
- 步骤1:点击Portainer的访问按钮,随后Portainer会提示您需要输入用户名和密码。此时从网关的“边缘计算>>Docker管理”页面复制用户名和设置的密码后并点击“登录”即可。

![](images/2020-07-01-16-12-08.png)

![](images/2020-01-14-16-02-20.png)

- 步骤2:登录成功后如下图所示,选择“Local”以使用Portainer管理IG902上的docker镜像,随后点击“Connect”。
- 步骤2:登录成功后如下图所示,选择“Local”以使用Portainer管理网关上的docker镜像,随后点击“Connect”。

![](images/2020-01-14-16-20-37.png)

- 步骤3:在Portainer的“Home”页面,选择local以管理IG902上的docker镜像
- 步骤3:在Portainer的“Home”页面,选择local以管理网关上的docker镜像

![](images/2020-01-14-16-21-43.png)

随后会跳转至本地仪表板,可在此页面概览IG902的容器和镜像等信息
随后会跳转至本地仪表板,可在此页面概览网关的容器和镜像等信息

![](images/2020-01-14-16-22-43.png)

Expand All @@ -111,7 +118,7 @@ IG902使用Portainer构建,管理和维护Docker镜像和容器。关于Portai

![](images/2020-01-13-18-02-33.png)

<font color=#FF0000>注意:因为IG902的CPU架构为linux/arm/v7,因此只有支持linux/arm/v7架构的镜像可以正常在IG902中运行,其他如window/amd64等架构的镜像可能无法正常导入、拉取或在IG902中运行。</font>
<font color=#FF0000>注意:因为网关的CPU架构为linux/arm/v7,因此只有支持linux/arm/v7架构的镜像可以正常在网关中运行,其他如window/amd64等架构的镜像可能无法正常导入、拉取或在网关中运行。</font>

![](images/2020-06-28-15-20-14.png)

Expand All @@ -130,7 +137,7 @@ IG902使用Portainer构建,管理和维护Docker镜像和容器。关于Portai

![](images/2020-01-13-18-16-28.png)

- 步骤4:在浏览器中输入容器中配置的Nginx访问链接(IG902的IP地址 + 端口号)后可以看到Nginx的欢迎页面。说明Nginx docker镜像已正常运行在IG902上;至此,完成了在IG902上添加并部署运行一个Nginx docker镜像。
- 步骤4:在浏览器中输入容器中配置的Nginx访问链接(网关的IP地址 + 端口号)后可以看到Nginx的欢迎页面。说明Nginx docker镜像已正常运行在网关上;至此,完成了在网关上添加并部署运行一个Nginx docker镜像。

![](images/2020-01-14-17-42-52.png)

Expand All @@ -141,7 +148,7 @@ IG902使用Portainer构建,管理和维护Docker镜像和容器。关于Portai
<a id="call-the-serial-port-in-the-container-for-communication"> </a>

### 在容器中调用串口进行通讯
部署容器时,在Portainer的“Advanced container settings>>Volumes”页面添加一条“Volume mapping”。下图将IG902的dev目录中的文件映射到了容器中的dev目录下(IG902的dev目录中包含了相应的接口文件):
部署容器时,在Portainer的“Advanced container settings>>Volumes”页面添加一条“Volume mapping”。下图将网关的dev目录中的文件映射到了容器中的dev目录下(网关的dev目录中包含了相应的接口文件):

![](images/2020-07-31-16-41-20.png)

Expand All @@ -162,7 +169,7 @@ IG902使用Portainer构建,管理和维护Docker镜像和容器。关于Portai

<a id="run-ubuntu-in-ig902"> </a>

### 在IG902中运行Ubuntu
### 在网关中运行Ubuntu
- 步骤1:在Portainer的“Local>>Images”页面拉取Ubuntu镜像,如下图所示:

![](images/2020-06-29-13-51-58.png)
Expand Down Expand Up @@ -242,7 +249,7 @@ IG902使用Portainer构建,管理和维护Docker镜像和容器。关于Portai

### Q1:在“Images”页面拉取镜像提示成功,但是在“Images”页面中未显示拉取到的镜像。

A1:因为IG902的CPU架构为linux/arm/v7,因此只有支持linux/arm/v7架构的镜像可以正常在IG902中运行,其他如window/amd64等架构的镜像可能无法正常导入、拉取或在IG902中运行。请确认拉取的镜像是否支持linux/arm/v7。
A1:因为网关的CPU架构为linux/arm/v7,因此只有支持linux/arm/v7架构的镜像可以正常在网关中运行,其他如window/amd64等架构的镜像可能无法正常导入、拉取或在网关中运行。请确认拉取的镜像是否支持linux/arm/v7。

![](images/2020-06-28-15-25-10.png)

Expand Down
Binary file added images/2021-10-14-18-02-47.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit b7191f8

Please sign in to comment.