定制化Azure站点Java运行环境(3)

定制化Azure Website提供的默认的Tomcat和JDK环境

在我们之前的测试中，如果你访问你的WEB站点URL时不加任何上下文，实际上你看到的web界面是系统自带的测试页面index.jsp,位于/site/wwwroot/webapps/ROOT目录下，是Tomcat默认的根目录。

由于要检测JVM的usage信息以便确定，定制化修改的Java参数是否生效，所以我们需要写一些测试代码，打印出当前JVM的参数信息;首先使用FileZilla连接到你的网站，进入到/site/wwwroot/webapps/ROOT目录下，下载index.jsp文件到本地。
我写了一个简单的测试程序，测试Java运行时heap size大小，使用ManagmentBeans获得的JVM参数，已经上传到了github，请直接下载，或者你也可以打开index.jsp文件添加相关代码如下：
https://github.com/kingliantop/azurelabs/blob/master/Java/websites/index.jsp

<%@ page import="java.util.*" %>
<%@ page import="java.lang.management.*" %>
    <%
      ArrayList<String> mainPageProps = new ArrayList<String>();
      mainPageProps.add("java.version");
      mainPageProps.add("java.vendor");
      mainPageProps.add("os.arch");
      mainPageProps.add("catalina.base");
      mainPageProps.add("jetty.base");
      mainPageProps.add("user.timezone");
      for(String name : mainPageProps)
      {
          String value = System.getProperty(name);
          if(value != null)
           {
                out.print("<tr><td>" + name);
                out.print("</td><td>" + value );
                out.print("</td></tr>");
                    }
          }
          int MB=1024*1024;
          Runtime runtime = Runtime.getRuntime();
          out.print("<tr><td>Runtime Total memory:</td><td>" + runtime.totalMemory()/MB+"M</td></tr>");
          out.print("<tr><td>Runtime Free memory:</td><td>" + runtime.freeMemory()/MB+"M</td></tr>");
          out.print("<tr><td>Runtime Used memory:</td><td>" + (runtime.totalMemory() - runtime.freeMemory())/MB+"M</td></tr>");
          out.print("<tr><td>Runtime Max memory:</td><td>" + runtime.maxMemory()/MB+"M</td></tr>");
  
         Iterator iter = ManagementFactory.getMemoryPoolMXBeans().iterator();
 
         out.print("<tr><td><h3>Memory MXBean</h3></td></tr>");
         out.print("<tr><td>Heap Memory Usage:</td><td>" + ManagementFactory.getMemoryMXBean().getHeapMemoryUsage()+"</td></tr>");
         out.print("<tr><td>Non-Heap Memory Usage:</td><td>" + ManagementFactory.getMemoryMXBean().getNonHeapMemoryUsage()+"</td></tr>");
         out.print("<tr><td><h3>Memory Pool MXBeans</h3></td></tr>");
 while (iter.hasNext()) {

         MemoryPoolMXBean item = (MemoryPoolMXBean) iter.next();
         out.print("<tr><td><b>"+item.getName()+"</b></td></tr>");
         out.print("<tr><td>Type:</td><td>" + item.getType()+"</td></tr>");
         out.print("<tr><td>Usage:</td><td>" + item.getUsage()+"</td></tr>");
         out.print("<tr><td>Peak Usage:</td><td>" + item.getPeakUsage()+"</td></tr>");
         out.print("<tr><td>Collection Usage:</td><td>" + item.getCollectionUsage()+"</td></tr>");
}
%>

3. 上传修改后的index.jsp文件到ROOT目录下，覆盖原来的文件，重新打开你的web站点主页，你可以看到测试程序会打印出当前运行环境下内存大小，heap size，non-heap size大小等相关信息：

4. 我们可以看到默认运行环境下，初始Heap大小为28664K，已经使用大约54M，最大内容使用量是433M，而当前测试环境使用的网站实例大小为小型，大约是一个core，1.75G内存：

对于PermGen大小，初始大小为：

init = 22020096(21504K) used = 41871616(40890K) committed = 41943040(40960K) max = 85983232(83968K)

5. 做个简单的实验，我们将web站点的实例升级，看看Azure website是否会自动根据当前系统实例的大小来调整JVM相关参数，在"缩放"页面，我们将实例升级到中型实例，点击保存：

这个时候你会看到默认的heap size也发生了变化：

那么Azure是如何调整Tomcat的运行环境和配置的呢？这样动态的调整是如何做到的呢？

其实没有什么magic，Azure的website底层是Windows Server，采用IIS来对其他第三方的服务器例如Tomcat进行管理。IIS有一个管理模块，叫做HttpPlatformHandler，他会做这么几件事情：

所有以前直接处理Http请求的第三方应用服务器，如Tomcat，Jetty，Node.JS等等，HTTP请求都交由IIS来进行接受。
由IIS接管的请求，都会被转发至后台真正处理的服务器，比如Tomcat等等，作用类似于Nginx，apache httpd
管理第三方程序，启动第三方程序，设定启动参数，定制化相应环境等等，所有这些操作都通过一个叫做web.config的文件来配置实现。

那么经由上述介绍你可以知道，在Azure website这个PAAS平台上，如果我们需要做些定制化环境部署，需要使用这个机制，由HttpPlatformHandler通过web.config配置文件来实现。

在本测试场景中，我们假定用户需要修改默认运行环境下的heap size和PermGen的大小，因为在常见的Java应用错误中，出现的OutOfMemory错误，有些就是由于PermGen大小设置过小引起的。

首先我们需要准备一个web.config文件，在本示例中我们使用Azure站点提供的Tomcat和JDK，我们需要配置的相关参数-Xms512m -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=256m放在JAVA_OPTS下：

<?xml version="1.0" encoding="UTF-8"?><configuration>

<system.webServer>

<handlers>

<add name="httpPlatformHandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified" />

</handlers>

<httpPlatform processPath="%AZURE_TOMCAT7_HOME%\bin\startup.bat"  arguments="">

<environmentVariables>

<environmentVariable name="CATALINA_OPTS" value="-Dport.http=%HTTP_PLATFORM_PORT%" />

<environmentVariable name="JAVA_OPTS" value="-Djava.net.preferIPv4Stack=true -Xms256m -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=256m" />

</environmentVariables>

</httpPlatform>

</system.webServer>

</configuration>

注意事项：