Skip to main content
Version: Deploy 22.1

Web Server Plugin

The Deploy Web Server plugin provides the deployment of web content and web server configuration to a web server.

Features​

  • Deploy to Apache and IHS web servers
  • Deploy and undeploy web server artifacts:
    • Web content (HTML pages, images, and others)
    • Virtual host configuration
    • Any configuration fragment
  • Start, stop, and restart web servers as control tasks

Using the www.ApacheVirtualHost configuration item​

The following example is a manifest snippet that shows how to include web content and a virtual host in a deployment package. The web content CI refers to a folder, html, included in the deployment package.

<udm.DeploymentPackage version="2.0" application="PetClinic-ear" >
    <jee.Ear name="PetClinic" file="PetClinic-2.0.ear" />
    <www.WebContent name="PetClnic-html" file="html" />
    <www.ApacheVirtualHostSpec name="PetClinic-vh">
        <host>*</host>
        <port>8080</port>
    </www.ApacheVirtualHostSpec>
</udm.DeploymentPackage>

Using the www.ApacheConfFragment configuration item​

Defining a new fragment to deploy to the Apache configuration consists of two steps:

  1. Define the type of configuration fragment and its properties.
  2. Provide a template for the configuration fragment implementation. As a default, the script searches for DEPLOYIT_HOME/ext/www/apache/${deployed.type}.conf.ftl.

Example:

  1. Define an ApacheCurrentDate type in DEPLOYIT_HOME/ext/synthetic.xml: 
    <type type="www.ApacheProxyPassSetting" extends="www.ApacheConfFragment" deployable-type="www.ApacheProxyPassSpec">
        <generate-deployable type="www.ApacheProxyPassSpec" extends="generic.Resource" />
        <property name="from" />
        <property name="to" />
        <property name="options" required="false" default="" />
        <property name="reverse" kind="boolean" required="false" default="false" />
    </type>
  2. Create www.ApacheCurrentDate.conf.ftl in DEPLOYIT_HOME/ext/www/apache: 
    --- start www.ApacheProxyPassSetting.conf.ftl ---
    ProxyPass ${deployed.from} ${deployed.to} <#if (deployed.options?has_content)>${deployed.options}</#if>
    <#if (deployed.reverse)>
    ProxyPassReverse ${deployed.from} ${deployed.to}
    </#if>
    --- end www.ApacheProxyPassSetting.conf.ftl ---