@@ -43,7 +43,7 @@ Goku API Gateway 的社区版本(CE)拥有完善的使用指南和二次开
43
43
44
44
> 建议控制台与节点分别部署在不同的服务器上,一般一台服务器/虚拟机部署一个网关节点。
45
45
> 若要使用多个网关节点,需要将节点文件放置进多台服务器,并且在控制台新建多个节点。
46
- > 此处为编译版本(release)的部署指南 ,点击查看:[ 源码版本(source_code)的部署指南 ] ( https://help.eolinker.com/#/tutorial/?groupID=c-346 &productID=19 " 点击源码版本(source_code)的部署指南 ")
46
+ > 此处网关控制台与节点的部署指南 ,点击查看:[ 源码编译教程 ] ( https://help.eolinker.com/#/tutorial/?groupID=c-350 &productID=19 " 源码编译 ")
47
47
48
48
### 环境准备
49
49
* ** linux系统,内核版本 2.6.23+**
@@ -52,48 +52,22 @@ Goku API Gateway 的社区版本(CE)拥有完善的使用指南和二次开
52
52
* ** net-tools**
53
53
* ** golnag12.x**
54
54
55
- ### 安装文件描述
55
+ ### 控制台安装
56
56
57
- AGW的安装包包含两个文件 ** goku-console(控制台安装包)** 和 ** goku-node(网关节点安装包)** 。
58
-
59
- 一、goku-console(控制台安装包)里文件目录如下
60
-
61
- | 目录名称 | 含义 |
62
- | ------------ | ------------ |
63
- | goku-ce-console | 编译后的网关控制台文件 |
64
- | goku-sql| mysql数据库安装脚本 |
65
-
66
- 其中goku-ce-console(控制台文件)里包含一个程序:
67
- * gateway-console:控制台程序
68
-
69
- 二、goku-node(网关节点安装包)里文件目录如下
70
-
71
- | 目录名称 | 含义 |
72
- | ------------ | ------------ |
73
- | goku-ce-node | 编译后的网关节点文件 |
74
-
75
- 其中goku-ce-node(节点文件)里包含一个程序:
76
- * gateway-node:节点程序
77
-
78
- ### 安装数据库
79
- 1 . 新建数据库goku_ce
80
-
81
- 2 . 进入goku-console>>goku-sql文件夹,将goku_ce.sql导入到数据库
82
- ```
83
- mysql -u <用户名> -p<密码> <./goku_ce.sql
57
+ 1.安装:
84
58
```
59
+ mkdir -p {install dir}
60
+ mv console-{version}.tar.gz {tmp}/
61
+ cd {tmp}/
62
+ tar -xzf console-{version}.tar.gz
63
+ cd console-{version} && ./install.sh {install dir}
64
+ cd {install dir}
85
65
86
- ### 安装控制台
87
-
88
- #### 1. 编辑控制台配置文件
66
+ ```
89
67
90
- 进入goku-ce-console/config文件夹:cd goku-ce- console/config ,编辑控制台的 ** goku.conf ** 文件,文件配置编辑语法参照yaml。
68
+ 2.首次安装进入{install dir}/ console/config文件夹,编辑配置文件内容,配置语法参照yaml
91
69
92
- 通过写控制台的goku.conf配置文件,控制台后端可以知道远程数据库相关信息及监听的端口号:
93
- ```
94
- vi goku.conf
95
- ```
96
- 控制台的goku.conf文件配置字段如下:
70
+ ** goku.conf** 如下:
97
71
```
98
72
admin_bind: 绑定节点获取配置的地址,形如IP:Port,填写内网地址或本机地址
99
73
listen_port: 管理后台监听端口,可以开放给外网访问
@@ -102,12 +76,9 @@ db_port: 数据库监听端口
102
76
db_name: 数据库名称
103
77
db_user: 登录数据库的用户名
104
78
db_password: 登录数据库的密码
105
-
106
79
```
107
80
108
- #### 2. 编辑网关集群的yaml配置文件
109
-
110
- 该文件放置在** goku-ce-console/config** 目录,cluster.yaml的配置示例:
81
+ ** cluster.yaml** 配置示例如下:
111
82
```
112
83
cluster:
113
84
-
@@ -145,57 +116,51 @@ cluster:
145
116
dbIndex: 0
146
117
```
147
118
148
- #### 3. 启动控制台
149
-
150
- 启动控制台前,需要先给予对应文件正确的权限:
151
- (1)进入goku-ce-console文件夹,给予 ** gateway-console** 文件执行权限:
152
-
153
- chmod +x gateway-console
154
-
155
- (2)进入goku-ce-console文件夹,给予 ** export** 文件夹执行权限:
156
-
157
- chmod -R 777 export
158
-
159
- 然后通过以下命令在后台执行gateway-console(首次执行加上用户名及密码参数)
160
-
161
- * 首次安装
162
-
119
+ 3.初次安装创建数据库goku_ce,并运行{install dir}/console/sql文件夹下的goku_ce.sql,执行数据库脚本:
163
120
```
164
- nohup ./gateway-console -u admin -p 123456 > gateway- console-"$(date "+%Y-%m-%d_%H_%M_%S")".log 2>&1 &
121
+ mysql -u用户名 -p密码 {install dir}/ console/sql/goku_ce.sql
165
122
```
166
- ** 注** :** -u** 后加** 管理员用户名** ,** -p** 后加** 管理员密码** ,管理员账号信息用于登录网关控制台,请注意妥善保管。
167
123
168
- * 非首次安装
124
+ 4.进入{install dir}/console文件夹,运行run.sh文件以启动控制台
169
125
126
+ ** 首次运行** :
170
127
```
171
- nohup ./gateway-console > gateway-console-"$(date "+%Y-%m-%d_%H_%M_%S")".log 2>&1 &
128
+ .run.sh start {config file} 管理员账号 管理员密码
172
129
```
173
130
174
- #### 4. 访问控制台
131
+ 示例:
132
+ ```
133
+ .run.sh start config/goku.conf admin 123456
134
+ ```
175
135
176
- 在浏览器中输入** IP/域名+端口号** ,进入网关控制台页面:
136
+ ** 非首次运行** :
137
+ ```
138
+ .run.sh start|restart
139
+ ```
177
140
178
- 注:控制台的端口号为 ** goku.conf ** 中的 ** listen_port ** 字段
141
+ 5.在浏览器输入服务器IP+程序监听端口号,进入管理后台页面
179
142
180
- ![ ] ( http://data.eolinker.com/course/bNrMsZs20920fa41cd6b3fd5fee98c7e23d76e0922978af )
143
+ 注:程序监听端口号为goku.conf的配置项listen_port的值
181
144
182
- 至此,您已成功安装好GoKu网关控制台。
145
+ ![ ] ( http://data.eolinker.com/course/nh4Xc8v24059c115375a87de682a0990ba723916923196f )
183
146
184
- ### 安装单个网关节点
147
+ 至此控制台已安装完成,在控制台新建节点后,需要通过命令行启动节点。
185
148
186
- #### 1. 服务器导入节点安装包
187
149
188
- (1)将获得的节点安装包压缩文件goku-node导入到服务器中。
150
+ ### 节点安装
189
151
190
- (2)给予gateway-node可执行权限 :
152
+ 1.安装 :
191
153
192
154
```
193
- chmod +x gateway-node
155
+ mkdir -p {install dir}
156
+ mv goku-node-{version}.tar.gz {tmp}/
157
+ cd {tmp}/
158
+ tar -xzf goku-node-{version}.tar.gz
159
+ cd goku-node-{version} && ./install.sh {install dir}
160
+ cd {install dir}
194
161
```
195
162
196
- 其他节点操作类似,先在相应服务器放置网关文件,然后按照第2步依次在控制台新增并启动网关节点。
197
-
198
- #### 2.在控制台添加并启动节点
163
+ 2.在管理后台新建节点
199
164
200
165
(1)登录控制台,点击一级导航的 ** 集群管理** ,进入相应的集群:
201
166
@@ -205,35 +170,33 @@ chmod +x gateway-node
205
170
206
171
![ ] ( http://data.eolinker.com/course/rlWf1dI806427cc64c4b73af34dba35a758a4d9f21e86fc )
207
172
208
- (3)添加节点需要填写以下信息 :
173
+ (3)点击 ** 新增节点 ** 按钮,填写节点信息后点击 ** 确定 ** :
209
174
210
- * 选择分组
211
- * 网关文件路径:可获取到** goku-node** 已编译文件的目录,一般放置在** goku-ce-node** 目录下
212
- * 节点名称:用于标识服务器节点名称
213
- * 节点IP:受控节点IP
214
- * 节点端口:网关受控端监听的端口
175
+ > (a)新建节点时的节点IP字段填写内网IP或本地IP
176
+ > (b)若配置文件(goku.conf)中的admin_bind字段值IP部分为127.0.0.1或localhost,此处节点IP必须填写127.0.0.1
215
177
216
- > 注意事项:
217
- > ** 节点IP** 字段填写** 内网IP或本地IP**
218
- > 若配置文件(goku.conf)中的** admin_bind** 字段值IP部分为** 127.0.0.1** 或** localhost** ,此处节点IP必须填写** 127.0.0.1**
178
+ ![ ] ( http://data.eolinker.com/course/S2Zjkdi511ae476f039aa53059e26a8b675458fb29841fc )
219
179
220
- (4)启动节点:
221
-
222
- 节点新建成功后处于 ** 未运行** 的状态,如需节点生效需要手动启动节点:
180
+ 3.启动节点程序:
223
181
224
182
```
225
- ./run.sh {start|stop|reload|restart|force-reload} [admin url] [port]
183
+ {install dir}/run.sh {start|stop|reload|restart|force-reload} [admin url] [port]
184
+
226
185
```
227
- 此处的** admin url** 值与配置文件(goku.conf)中的** admin_bind** 字段值一致。
186
+
187
+ 此处的admin url值与配置文件(goku.conf)中的admin_bind字段值一致。
228
188
229
189
示例:
230
190
```
231
- . /run.sh start 127.0.0.1:7005 7702
191
+ {install dir} /run.sh start 127.0.0.1:7005 7702
232
192
```
233
193
234
- 启动后,进入节点管理页面,若节点的状态显示为 ** 运行中** ,则节点正常启动:
194
+ 4.检查节点是否正常运行:
195
+
196
+ 进入节点管理页面,若节点的状态显示为运行中,则节点正常启动:
197
+
198
+ ![ ] ( http://data.eolinker.com/course/WelR3FK9bbf28e791f4f6450bc4b7992efe0f73afec4845 )
235
199
236
- ![ ] ( http://data.eolinker.com/course/AaFng1U9eff6d6d2e3fb483a44283a8ee5b6a0b756c978b )
237
200
238
201
# 企业支持
239
202
Goku API Gateway EE(企业版本)拥有更强大的功能、插件库以及专业的技术支持服务,如您需要了解可以通过以下方式联系我们。
@@ -259,4 +222,4 @@ You may obtain a copy of the License at http://www.gnu.org/licenses/gpl-3.0.html
259
222
260
223
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
261
224
See the License for the specific language governing permissions and limitations under the License.
262
- ```
225
+ ```
0 commit comments