Skip to content

Commit b779ffb

Browse files
soodifficultsoodifficult
committed
Update doc dontent
1 parent 1776724 commit b779ffb

File tree

2 files changed

+113
-62
lines changed

2 files changed

+113
-62
lines changed

‎Docker-user-manual.md‎

Lines changed: 112 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -2,97 +2,148 @@
22
InGateway902 series edge computing gateway (IG902 for short) supports manage docker images. You can publish your docker images to IG902 to quickly deploy and run applications developed by yourself. In order to introduce how to use IG902's Docker environment, this document will demonstrate how to run an Nginx image on IG902. This image is used for open source reverse proxy server for HTTP, HTTPS, SMTP, POP3 and IMAP protocols, and load balancer, HTTP cache And web server. <br/>
33
Docker is an open source application container engine that allows developers to package their applications and dependencies into a portable container and then publish it to any popular Linux machine or Windows machine. It can also be virtualized. The container is completely with the sandbox mechanism, there will be no interface between each other.
44

5-
## Prepare IG902 Hardware and Network Environment
6-
### Connect IG902 to the Power Source and to a PC with a Network Cable
7-
Connect IG902 to the power source and to a PC with an Ethernet cable according to the topology diagram. <br/>
5+
- [1. Prepare IG902 Hardware and Network Environment](#prepare-ig902-hardware-and-network-environment)
6+
- [1.1 Connect IG902 to the Power Source and to a PC with a Network Cable](#connect-ig902-to-the-power-source-and-to-a-pc-with-a-network-cable)
7+
- [1.2 Set LAN Parameters: Access the IG902 Through LAN](#set-lan-parameters)
8+
- [1.3 Set WAN Parameters: Connect IG902 to the Internet](#set-wan-parameters)
9+
- [1.4 Update the firmware](#update-the-firmware)
10+
- [2. Enable and configure Docker manager](#enable-and-configure-docker-manager)
11+
- [2.1 Install Docker SDK and enable Docker manager](#install-docker-sdk-and-enable-docker-manager)
12+
- [2.2 Configure Docker Manager--Portainer](#configure-docker-manager-portainer)
13+
- [2.2.1 Access Portainer](#access-portainer)
14+
- [2.2.2 Add docker image](#add-docker-image)
15+
- [2.2.3 Configure and deploy container](#configure-and-deploy-container)
16+
- [Appendix](#appendix)
17+
- [How to download docker images from gitlab / github](#how-to-download-docker-images-from-gitlab-github)
18+
19+
<a id="prepare-ig902-hardware-and-network-environment"> </a>
20+
21+
## 1. Prepare IG902 Hardware and Network Environment
22+
23+
<a id="connect-ig902-to-the-power-source-and-to-a-pc-with-a-network-cable"> </a>
24+
25+
### 1.1 Connect IG902 to the Power Source and to a PC with a Network Cable
26+
Connect IG902 to the power source and to a PC with an Ethernet cable according to the topology diagram.
27+
828
![](images/2020-01-21-10-08-56.png)
929

10-
#### Set LAN Parameters: Access the IG902 Through LAN
30+
<a id="set-lan-parameters"> </a>
31+
32+
### 1.2 Set LAN Parameters: Access the IG902 Through LAN
1133
To set the IG902 LAN network parameters, see [Access IG902 in a LAN](https://ingateway-firmware-en.readthedocs.io/en/latest/IG902-Quick-Start-Manual.html#set-lan-parameters-access-the-ig902-through-lan).
1234

13-
#### Set WAN Parameters: Connect IG902 to the Internet
35+
<a id="set-wan-parameters"> </a>
36+
37+
### 1.3 Set WAN Parameters: Connect IG902 to the Internet
1438
To set the IG902 WAN network parameters, see [Connect IG902 to the Internet](https://ingateway-firmware-en.readthedocs.io/en/latest/IG902-Quick-Start-Manual.html#set-wan-parameters-connect-ig902-to-the-internet).
1539

16-
### Update the firmware
40+
<a id="update-the-firmware"> </a>
41+
42+
### 1.4 Update the firmware
1743
To obtain the latest firmware version of IG902 and updated functions, contact the customer service center. To update the IG902 firmware, see [Update the IG902 software version](https://ingateway-firmware-en.readthedocs.io/en/latest/IG902-Quick-Start-Manual.html#update-the-software).<font color=#FF0000> (The firmware version should be 2.0.0.r12057 and above)</font>
1844

19-
## Enable and configure Docker manager
20-
### Install Docker SDK and enable Docker manager
45+
<a id="enable-and-configure-docker-manager"> </a>
46+
47+
## 2. Enable and configure Docker manager
48+
49+
<a id="install-docker-sdk-and-enable-docker-manager"> </a>
50+
51+
### 2.1 Install Docker SDK and enable Docker manager
2152
The Docker SDK integrates the operating environment and docker image manager required to run the docker image. Before using Docker, you must install the Docker SDK. To obtain the Docker SDK, please contact the customer service center. </br>
22-
- Step 1: If you already have the Docker SDK, choose Edge Computing > Docker Manager page of IG902, close the Docker Manager and import the Docker SDK.
23-
![](images/2020-02-12-17-27-06.png) </br>
24-
&nbsp;
53+
- Step 1: If you already have the Docker SDK, choose Edge Computing > Docker Manager page of IG902, close the Docker Manager and import the Docker SDK.
54+
55+
![](images/2020-02-12-17-27-06.png)
56+
57+
- Step 2: After importing, IG902 will automatically install the Docker SDK. The installation process usually takes 1-2 minutes. Please be patient. After successful installation, select Enable Docker Manager and click Submit.
2558

26-
- Step 2: After importing, IG902 will automatically install the Docker SDK. The installation process usually takes 1-2 minutes. Please be patient. After successful installation, select Enable Docker Manager and click Submit.
27-
![](images/2020-02-11-15-19-42.png) </br>
28-
&nbsp;
59+
![](images/2020-02-11-15-19-42.png)
2960

30-
- Step 3: Then you can modify the port number and login password to access the Docker manager.
31-
![](images/2020-02-11-15-23-39.png)
61+
- Step 3: Then you can modify the port number and login password to access the Docker manager.
62+
63+
![](images/2020-02-11-15-23-39.png)
64+
65+
<a id="configure-docker-manager-portainer"> </a>
3266

33-
### Configure Docker Manager--Portainer
67+
### 2.2 Configure Docker Manager--Portainer
3468
IG902 uses Portainer to build, manage and maintain Docker images and containers. For a detailed introduction and instructions on Portainer, please see the [Portainer official website](https://www.portainer.io/overview/). This document will show you how to add and deploy an Nginx docker image on IG902.
3569

36-
#### Access Portainer
37-
- Step 1: Click Portainer's access button, and Portainer will prompt you to enter your username and password. At this time, copy the user name and the set password from the Edge Computing > Docker Manager page of IG902 and click Login.
38-
![](images/2020-02-11-15-27-41.png)
39-
![](images/2020-01-21-14-36-08.png) </br>
40-
&nbsp;
70+
<a id="access-portainer"> </a>
71+
72+
#### 2.2.1 Access Portainer
73+
- Step 1: Click Portainer's access button, and Portainer will prompt you to enter your username and password. At this time, copy the user name and the set password from the Edge Computing > Docker Manager page of IG902 and click Login.
74+
75+
![](images/2020-02-11-15-27-41.png)
76+
77+
![](images/2020-01-21-14-36-08.png)
4178

42-
- Step 2: After the login is successful, as shown in the figure below, select Local to use the Portainer to manage the docker image on the IG902, and then click Connect.
43-
![](images/2020-01-14-16-20-37.png) </br>
44-
&nbsp;
79+
- Step 2: After the login is successful, as shown in the figure below, select Local to use the Portainer to manage the docker image on the IG902, and then click Connect.
80+
81+
![](images/2020-01-14-16-20-37.png)
4582

46-
- Step 3: On the Home page of Portainer, select local to manage the docker image on IG902.
47-
![](images/2020-01-14-16-21-43.png) </br>
48-
&nbsp;
83+
- Step 3: On the Home page of Portainer, select local to manage the docker image on IG902.
84+
85+
![](images/2020-01-14-16-21-43.png)
4986

50-
Then you will jump to the local dashboard, where you can get an overview of the IG902's containers and images.
51-
![](images/2020-01-14-16-22-43.png)
87+
Then you will jump to the local dashboard, where you can get an overview of the IG902's containers and images.
88+
89+
![](images/2020-01-14-16-22-43.png)
90+
91+
<a id="add-docker-image"> </a>
5292

53-
#### Add docker image
93+
#### 2.2.2 Add docker image
5494
There are two ways to add docker images for Portainer：
55-
- Method 1: Import the local docker image from the Edge Computing > Docker Manager page of IG902. (The time required for import varies depending on the size of the docker image; please be patient when the docker image is large.)
56-
![](images/2020-02-11-15-29-07.png) </br>
57-
&nbsp;
95+
- Method 1: Import the local docker image from the Edge Computing > Docker Manager page of IG902. (The time required for import varies depending on the size of the docker image; please be patient when the docker image is large.)
96+
97+
![](images/2020-02-11-15-29-07.png)
5898

59-
You can see the docker image successfully imported on the Local > Images page of Portainer.
60-
![](images/2020-01-14-17-24-07.png) </br>
61-
&nbsp;
99+
You can see the docker image successfully imported on the Local > Images page of Portainer.
100+
101+
![](images/2020-01-14-17-24-07.png)
62102

63-
- Method 2: Choose Local > Images page of Portainer and download the nginx docker image from DockerHub. (The time required to download the image varies depending on the size of the image; please be patient when the docker image is large)
64-
![](images/2020-01-21-15-24-52.png) </br>
65-
&nbsp;
103+
- Method 2: Choose Local > Images page of Portainer and download the nginx docker image from DockerHub. (The time required to download the image varies depending on the size of the image; please be patient when the docker image is large)
104+
105+
![](images/2020-01-21-15-24-52.png)
66106

67-
After the docker image is downloaded, you can see the corresponding docker image information in Local > Images as shown below:
68-
![](images/2020-01-21-15-28-04.png)
107+
After the docker image is downloaded, you can see the corresponding docker image information in Local > Images as shown below:
108+
109+
![](images/2020-01-21-15-28-04.png)
110+
111+
<a id="configure-and-deploy-container"> </a>
112+
113+
#### 2.2.3 Configure and deploy container
114+
- Step 1: Choose Local > Containers page of Portainer and click Add container to add a new container.
69115

70-
#### Configure and deploy container
71-
- Step 1: Choose Local > Containers page of Portainer and click Add container to add a new container.
72-
![](images/2020-01-13-18-08-05.png) </br>
73-
&nbsp;
116+
![](images/2020-01-13-18-08-05.png)
74117

75-
- Step 2: Configure the operating parameters for the container and deploy the container.
76-
![](images/2020-04-27-14-58-45.png) </br>
77-
&nbsp;
118+
- Step 2: Configure the operating parameters for the container and deploy the container.
119+
120+
![](images/2020-04-27-14-58-45.png)
78121

79-
- Step 3: The container will run automatically after deployment. You can view the container running status on Portainer's Local > Containers page.
80-
![](images/2020-01-13-18-16-28.png) </br>
81-
&nbsp;
122+
- Step 3: The container will run automatically after deployment. You can view the container running status on Portainer's Local > Containers page.
123+
124+
![](images/2020-01-13-18-16-28.png)
82125

83-
- Step 4: After entering the Nginx access link (IP address + port number of IG902) configured in the container in the browser, you can see the Nginx welcome page.This shows that the Nginx docker image has been running on the IG902 normally. Now, you have completed adding and deploying an Nginx docker image on the IG902.
84-
![](images/2020-01-14-17-42-52.png)
126+
- Step 4: After entering the Nginx access link (IP address + port number of IG902) configured in the container in the browser, you can see the Nginx welcome page.This shows that the Nginx docker image has been running on the IG902 normally. Now, you have completed adding and deploying an Nginx docker image on the IG902.
127+
128+
![](images/2020-01-14-17-42-52.png)
85129

86130
## Appendix
131+
132+
<a id="how-to-download-docker-images-from-gitlab-github"> </a>
133+
87134
### How to download docker images from gitlab / github
88-
Choose Local > Registries page of Portainer and click Add registry to add a docker mirror repository (must be a public repository).
89-
![](images/2020-01-19-10-39-19.png) </br>
135+
Choose Local > Registries page of Portainer and click Add registry to add a docker mirror repository (must be a public repository).
136+
137+
![](images/2020-01-19-10-39-19.png)
138+
139+
Then select Custom registry and configure the mirror repository information. After configuration, click Add registry.
140+
141+
![](images/2020-01-21-15-40-36.png)
142+
143+
After the mirror repository is successfully added, you can see the web page as shown below:
90144

91-
Then select Custom registry and configure the mirror repository information. After configuration, click Add registry.
92-
![](images/2020-01-21-15-40-36.png) </br>
145+
![](images/2020-01-21-15-41-25.png)
93146

94-
After the mirror repository is successfully added, you can see the web page as shown below:
95-
![](images/2020-01-21-15-41-25.png) </br>
147+
After the addition is successful, you can select the configured image repository when pulling the docker image.
96148

97-
After the addition is successful, you can select the configured image repository when pulling the docker image.
98149
![](images/2020-01-21-15-41-59.png)

‎index.rst‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,4 +10,4 @@ Welcome to MobiusPi development platform!
1010
:maxdepth: 2
1111
:caption: User manual
1212

13-
Docker user manual.md
13+
Docker-user-manual.md

0 commit comments

Comments
 (0)