[关闭]
@liyuj 2017-10-09T21:03:06.000000Z 字数 10418 阅读 4635

Apache-Ignite-2.2.0-中文开发手册

2.Ignite Web控制台

2.1.Ignite Web控制台

Ignite Web控制台是一个交互式的配置向导、管理和监控工具。它可以：

Ignite的Web控制台，是一个可以部署在系统环境中的Web应用。它可以配置所有的集群属性，从数据库中导入模式用于与持久化存储集成。它可以接入特定的数据库然后生成所有必要的OR映射配置（XML以及纯Java）以及Java领域模型POJOs。Web控制台还有集群监控的功能（使用GridGain单独的插件实现），它会显示各种缓存以及节点的指标数据，比如CPU和堆的使用情况等。

2.2.入门

2.2.1.安装

Ignite的Web控制台是一个WEB应用，需要构建、打包然后部署在自己的环境上。另外，它需要安装NodeJS，MongoDB以及Ignite的Web代理。
参照构建和部署章节的文档，然后按照步骤操作即可。

一个免费已部署的Ignite Web控制台实例
在构建和部署自己的本地Ignite Web控制台实例之前，可以看一下一个免费已部署的Web控制台实例，利用这个站点，花几分钟就可以大概了解控制台的已有功能。

Ignite的Web控制台启动运行之后，需要按照下面章节的步骤配置并且启动Web代理，代理是Ignite的Web控制台和Ignite集群之间的媒介。

2.2.2.Ignite Web代理

Ignite的Web代理是一个独立的Java应用，它可以建立Ignite集群与Web控制台之间的连接。Web Agent与集群节点间采用REST接口进行通信，而与Web控制台之间采用WebSocket进行通信。

举例来说，Ignite的Web Agent功能如下：


使用
Ignite Web代理的zip压缩包中的ignite-web-agent.{sh|bat}脚本可用于启动这个代理。一定要满足下面的必要条件，使得代理可以在Ignite集群和Ignite Web控制台之间建立连接。

1.为了与Web代理通信，Ignite节点需要开启REST服务模式（将ignite-rest-http文件夹从lib/optional/移动到lib/中）。如果是从IDE启动节点，那么需要将下面的依赖加入pom.xml文件；

  1. <dependency>
  2.     <groupId>org.apache.ignite</groupId>
  3.     <artifactId>ignite-rest-http</artifactId>
  4.     <version>{ignite.version}</version>
  5. </dependency>

2.配置Web代理的serverURI属性，将其指向Ignite节点的REST服务的URL，代理默认会连接http://localhost:8080。

配置
配置文件
Ignite的Web代理默认会试图从default.properties文件中加载配置。这个文件的内容需要遵循一个简单的基于行的格式。
可用的属性名包括：tokens，server-uri，node-uri，driver-folder。

  1. tokens=1a2b3c4d5f,2j1s134d12
  2. serverURI=https://console.example.com:3001

命令行参数
要获得帮助，可以在终端中执行ignite-web-agent.{sh|bat} -h或者ignite-web-agent.{sh|bat} --help。
可用的属性如下：

代理配置
代理可以通过将系统属性、JVM_OPTS环境变量的方式传给Web代理。
在如下文档中可以找到详细的描述：
http://docs.oracle.com/javase/7/docs/api/java/net/doc-files/net-properties.html。

HTTP
http.proxyHost：代理服务器的主机名或者地址；
http.proxyPort：代理服务器的端口号。

如果代理需要认证的话，还需要提供如下的系统属性：
http.proxyUsername：用户名；
http.proxyPassword：密码。
Shell：

  1. JVM_OPTS="-Dhttp.proxyHost=<proxy-hostname> -Dhttp.proxyPort=<proxy-port> -Dhttp.proxyUsername=<proxy-username> -Dhttp.proxyPassword=<proxy-password>" ./ignite-web-agent.sh

CMD：

  1. set JVM_OPTS=-Dhttp.proxyHost=<proxy-hostname> -Dhttp.proxyPort=<proxy-port> -Dhttp.proxyUsername=<proxy-username> -Dhttp.proxyPassword=<proxy-password>
  2. ./ignite-web-agent.bat

HTTPS
https.proxyHost：代理服务器的主机名或者地址；
https.proxyPort：代理服务器的端口号。

如果代理需要认证的话，还需要提供如下的系统属性：
https.proxyUsername：用户名；
https.proxyPassword：密码。
Shell：

  1. JVM_OPTS="-Dhttps.proxyHost=<proxy-hostname> -Dhttps.proxyPort=<proxy-port> -Dhttps.proxyUsername=<proxy-username> -Dhttps.proxyPassword=<proxy-password>" ./ignite-web-agent.sh

CMD：

  1. set JVM_OPTS=-Dhttps.proxyHost=<proxy-hostname> -Dhttps.proxyPort=<proxy-port> -Dhttps.proxyUsername=<proxy-username> -Dhttps.proxyPassword=<proxy-password>
  2. ./ignite-web-agent.bat

SOCKS
socksProxyHost：代理服务器的主机名或者地址；
socksProxyPort：代理服务器的端口号。

如果代理需要认证的话，还需要提供如下的系统属性：
java.net.socks.username：用户名；
java.net.socks.password：密码。
Shell:

  1. JVM_OPTS="-DsocksProxyHost=<proxy-hostname> -DsocksProxyPort=<proxy-port> -Djava.net.socks.username=<proxy-username> -Djava.net.socks.password=<proxy-password>" ./ignite-web-agent.sh

CMD:

  1. set JVM_OPTS= -DsocksProxyHost=<proxy-hostname> -DsocksProxyPort=<proxy-port> -Djava.net.socks.username=<proxy-username> -Djava.net.socks.password=<proxy-password>
  2. ./ignite-web-agent.bat

2.3.构建和部署

2.3.1.先决条件

为了在本地部署Ignite的Web控制台，需要先安装：

开始之前需要下载依赖：

  1. cd $IGNITE_HOME/modules/web-console/backend
  2. npm install --no-optional
  1. cd $IGNITE_HOME/modules/web-console/frontend
  2. npm install --no-optional

2.3.2.构建Ignite Web代理

要从源代码构建Ignite的Web代理，需要在$IGNITE_HOME文件夹中执行如下的命令：

  1. mvn clean package -pl :ignite-web-agent -am -P web-console -DskipTests=true

构建过程完成后，会在$IGNITE_HOME/modules/web-console/web-agent/taget中找到ignite-web-agent-x.x.x.zip。

2.3.3.在开发模式中运行Ignite的Web控制台

要在开发模式中运行Ignite的Web控制台，可以按照如下步骤操作：

2.3.4.在生产模式中运行Ignite的Web控制台

前提条件

启动后台

如果希望以守护进程模式运行后台，需要为NodeJS应用使用进程管理器：pm2，forever等。

构建前台

配置Apache HTTP Server

  1. <VirtualHost *:80>
  2.   ServerName www.WEB_CONSOLE_HOSTNAME
  3.   ServerAlias WEB_CONSOLE_HOSTNAME
  5.   DocumentRoot "/var/www/web-console-static"
  7.   RewriteEngine on
  9.   <Directory "/var/www/web-console-static">
  10.   AllowOverride All
  11.   Allow from all
  12.   </Directory>
  14.   ProxyRequests off
  16.   <proxy *>
  17.   Order deny,allow
  18.   Allow from all
  19.   </proxy>
  21.   ProxyPreserveHost On
  22.   RequestHeader set Host "WEB_CONSOLE_HOSTNAME"
  24.   RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} -f
  25.   RewriteRule ^ - [L]
  27.   RewriteCond %{REQUEST_URI} ^/agents/.* [OR]
  28.   RewriteCond %{REQUEST_URI} ^/socket.io/.*
  29.   RewriteRule ^ http://localhost:3000%{REQUEST_URI} [P,L]
  31.   RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
  32.   RewriteCond %{HTTP:CONNECTION} ^Upgrade$ [NC]
  33.   RewriteRule .* ws://localhost:3000%{REQUEST_URI} [P,L]
  35.   RewriteCond %{REQUEST_URI} ^/api/v1/.*$
  36.   RewriteRule ^/api/v1/(.*)$ http://localhost:3000/$1 [P,L]
  38.   RewriteRule ^ /index.html [L]
  39. </VirtualHost>

上面文件中的WEB_CONSOLE_HOSTNAME，需要替换为部署Web控制台实例的机器的主机名。

另外，如果Apache HTTP Server还用于部署的Web控制台，那么下面的配置也需要添加到/etc/httpd/conf/httpd.conf:
httpd.conf:

  1. ServerName localhost
  3. DocumentRoot "/var/www/web-console-static"
  5. RewriteEngine on
  7. <Directory "/var/www/web-console-static">
  8. AllowOverride All
  9. Allow from all
  10. </Directory>
  12. ProxyRequests off
  14. <proxy *>
  15. Order deny,allow
  16. Allow from all
  17. </proxy>
  19. ProxyPreserveHost On
  20. RequestHeader set Host "EXTERNAL_SERVER_IP"
  22. RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} -f
  23. RewriteRule ^ - [L]
  25. RewriteCond %{REQUEST_URI} ^/agents/.* [OR]
  26. RewriteCond %{REQUEST_URI} ^/socket.io/.*
  27. RewriteRule ^ http://localhost:3000%{REQUEST_URI} [P,L]
  29. RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
  30. RewriteCond %{HTTP:CONNECTION} ^Upgrade$ [NC]
  31. RewriteRule .* ws://localhost:3000%{REQUEST_URI} [P]
  33. RewriteCond %{REQUEST_URI} ^/api/v1/.*$
  34. RewriteRule ^/api/v1/(.*)$ http://localhost:3000/$1 [P,L]
  36. RewriteRule ^ /index.html [L]

上面的EXTERNAL_SERVER_IP，需要替换为部署Web控制台实例的机器的主机名。

执行sudo apachectl restart重启Apache HTTP Server以使配置生效。
打开浏览器，根据部署类型打开下面的地址中的一个：http://WEB_CONSOLE_HOSTNAME或http://EXTERNAL_SERVER_IP。

配置nginx HTTP Server

  1. upstream backend-api {
  2.   server localhost:3000;
  3. }
  5. server {
  6.   listen 80;
  7.   server_name EXTERNAL_SERVER_IP WEB_CONSOLE_HOSTNAME;
  9.   set $ignite_console_dir /var/www/web-console-static;
  11.   root $ignite_console_dir;
  13.   error_page 500 502 503 504 /50x.html;
  15.   location / {
  16.     try_files $uri /index.html = 404;
  17.   }
  19.   location /api/v1 {
  20.     rewrite /api/v1/(.*) /$1 break;
  21.     proxy_set_header Host $http_host;
  22.     proxy_pass http://backend-api;
  23.   }
  25.   location /socket.io {
  26.     proxy_set_header Upgrade $http_upgrade;
  27.     proxy_set_header Connection "upgrade";
  28.     proxy_http_version 1.1;
  29.     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  30.     proxy_set_header Host $host;
  31.     proxy_pass http://backend-api;
  32.   }
  34.   location /agents {
  35.     proxy_set_header Upgrade $http_upgrade;
  36.     proxy_set_header Connection "upgrade";
  37.     proxy_http_version 1.1;
  38.     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  39.     proxy_set_header Host $host;
  40.     proxy_pass http://backend-api;
  41.   }
  43.   location = /50x.html {
  44.     root $ignite_console_dir/error_page;
  45.   }
  46. }

上面的EXTERNAL_SERVER_IP，需要替换为部署Web控制台实例的机器的主机名。
WEB_CONSOLE_HOSTNAME，需要替换为部署Web控制台实例的机器的主机名。

执行sudo service nginx restart重启Nginx HTTP Server以使配置生效。
打开浏览器，根据部署类型打开下面的地址中的一个：http://WEB_CONSOLE_HOSTNAME或http://EXTERNAL_SERVER_IP。
问题解决
如果在浏览器中出现了Forbidden这样的错误，那么需要检查操作系统中所有的安全策略都配置正确了。

2.4.演示模式

2.4.1.摘要

可以使用Web控制台的演示模式来研究和评估它有关配置和管理集群的各种功能，这个模式中，可以检查预定义的集群、缓存以及领域模型，它还启动了一个内置的H2数据库实例，可以执行各种SQL查询以及查看数据报表，还可以监控各种缓存和节点的指标，比如集群的CPU和堆使用量等。

2.4.2.启动演示模式

要开启演示模式，需要点击控制台顶部菜单的Start demo按钮。

  1. ./ignite-web-agent.sh


启动Web代理之后，回到浏览器中就可以：
配置集群和缓存
点击控制台侧边栏上的Clusters和Caches，可以查看和设定Ignite的配置参数，点击Summary可以下载这些配置的XML和Java格式文件，这个页面还可以下载一个可用的基于Maven的工程。

导入领域模型
演示模式中，已连接的Web代理中已经启动了H2数据库实例，如下方法可以验证：

比如输入如下的SQL：

  1. SELECT p.name, count(*) AS cnt FROM "ParkingCache".Parking p`
  2. `INNER JOIN "CarCache".Car c ON (p.id) = (c.parkingId)`
  3. `GROUP BY P.NAME

2.5.Docker部署

在本地环境中部署Ignite Web控制台的最简单方式是使用控制台的Docker映像，如果基于Docker的方式不可行，那么可以参照2.3.构建和部署章节的内容。
下面是部署的完整步骤：

注意
1.需要使用sudo来运行docker命令；
2.如果80端口已被占用，那么容器端口需要映射到其他的可用端口。比如，下面的命令将容器的80端口绑定的宿主机的8080端口：sudo docker run -d -p 8080:80 -v <host_absolute_path>:/var/lib/mongodb --name web-console-standalone apacheignite/web-console-standalone;
3.<host_absolute_path>：是宿主机中MongoDB创建数据库文件的路径。这个文件夹应该在docker运行前创建好，打开Docker->Preferences->File Sharing然后在那里创建目录，或者使用其他的方式也行；

2.5.1.更新到新版

Docker更新容器的方式如下：
docker pull apacheignite/web-console-standalone
docker stop apacheignite/web-console-standalone
docker rm apacheignite/web-console-standalone
docker run -d -p 80:80 -v <host_absolute_path>:/var/lib/mongodb --name web-console-standalone apacheignite/web-console-standalone

添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注