Preface
This document describes the functionality provided by the Webserver plugin.
See the Deployit Reference Manual for background information on Deployit and deployment concepts.
Overview
The webserver-plugin is a Deployit plugin that supports deployment of web content and webserver configuration to a webserver.
Features
- Runs on Deployit 3.6 and up.
- Supports deployment to Apache and IHS webservers.
- Deploys and undeploys webserver artifacts:
- Web content (HTML pages, images, etc.)
- Virtual host configuration
- Any configuration fragment
- Supports starting, stopping and restarting of webservers as control tasks.
Requirements
Deployit requirements
- Deployit: version 3.6+
- Other Deployit Plugins: None
Infrastructural requirements
- User credentials for accessing the webserver executables on the host running the webserver.
Usage in Deployment Packages
The following is a manifest snippet that shows how web content and a virtual host can be included in a deployment package. The web content CI refers to a folder, html, included in the deployment package.
Manifest-Version: 1.0
Deployit-Package-Format-Version: 1.3
CI-Application: PetClinic-ear
CI-Version: 2.0
Name: PetClinic-2.0.ear
CI-Type: jee.Ear
CI-Name: PetClinic
Name: html
CI-Type: www.WebContent
CI-Name: PetClinic-html
Name: PetClinic-vh
CI-Type: www.ApacheVirtualHostSpec
CI-host: *
CI-port: 8080
Using the deployables and deployeds
The following table describes which deployable/container combinations are possible.
Deployable vs. Container table
| Deployable | Container | Generated deployed |
|---|---|---|
| www.WebContent | www.ApacheHttpdServer | www.PublishedWebContent |
| www.ApacheVirtualHostSpec | www.ApacheHttpdServer | www.ApacheVirtualHost |
| www.ApacheConfFragmentSpec | www.ApacheHttpdServer | www.ApacheConfFragment |
The following table describes the effect a deployed has on it's container.
Deployed Actions Table
| Deployed | Actions performed for operations | ||
|---|---|---|---|
| Create | Destroy | Modify | |
| www.PublishedWebContent |
|
|
|
| www.ApacheVirtualHost |
|
|
|
| www.ApacheConfFragment |
|
|
|
CI Reference
Configuration Item Overview
Deployables
| CI | Description |
|---|---|
| www.ApacheConfFragmentSpec | Specification for an Apache configuration fragment |
| www.ApacheVirtualHostSpec | Specification for an Apache virtual host |
| www.WebContent | Folder containing web content (HTML pages, images, etc) |
Deployeds
| CI | Description |
|---|---|
| www.ApacheConfFragment | Apache configuration fragment |
| www.ApacheVirtualHost | Apache virtual host |
| www.PublishedWebContent | Web content on the webserver |
Containers
| CI | Description |
|---|---|
| www.ApacheHttpdServer | Apache HTTPD web server |
Other Configuration Items
| CI | Description |
|---|---|
| www.ApacheConfFragment | Apache configuration fragment |
| www.ApacheConfFragmentSpec | Specification for an Apache configuration fragment |
| www.ApacheHttpdServer | Apache HTTPD web server |
| www.ApacheVirtualHost | Apache virtual host |
| www.ApacheVirtualHostSpec | Specification for an Apache virtual host |
| www.PublishedWebContent | Web content on the webserver |
| www.WebContent | Folder containing web content (HTML pages, images, etc) |
Configuration Item Details
www.ApacheConfFragment
| Type Hierarchy | generic.ProcessedTemplate >> generic.AbstractDeployedArtifact >> generic.AbstractDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Deployed, udm.ConfigurationItem, udm.EmbeddedDeployedParent |
Apache configuration fragment
| Parent | ||
|---|---|---|
|
|
|
container
:
CI<udm.Container>
|
|
The container on which this deployed runs.
|
| Public Properties | ||
|---|---|---|
|
|
|
deployable
:
CI<udm.Deployable>
|
|
The deployable that this deployed is derived from.
|
| Hidden Properties | ||
|---|---|---|
|
|
|
createOrder
:
INTEGER
= 50
|
|
The order of the step in the step list for the create operation.
|
||
|
|
|
createVerb
:
STRING
= Create
|
|
Create Verb
|
||
|
|
|
destroyOrder
:
INTEGER
= 40
|
|
The order of the step in the step list for the destroy operation.
|
||
|
|
|
destroyVerb
:
STRING
= Destroy
|
|
Destroy Verb
|
||
|
|
|
modifyOrder
:
INTEGER
= 50
|
|
The order of the step in the step list for the modify operation.
|
||
|
|
|
modifyVerb
:
STRING
= Modify
|
|
Modify Verb
|
||
|
|
|
noopOrder
:
INTEGER
= 50
|
|
The order of the step in the step list for the noop operation.
|
||
|
|
|
noopVerb
:
STRING
= Modify
|
|
Noop Verb
|
||
|
|
|
targetDirectory
:
STRING
= ${deployed.container.configurationFragmentDirectory}
|
|
Target directory name
|
||
|
|
|
targetFile
:
STRING
= ${deployed.name}.conf
|
|
Target file name
|
||
|
|
|
template
:
STRING
= www/apache/${deployed.type}.conf.ftl
|
|
Configuration fragment template file name.
|
||
|
|
|
createTargetDirectory
:
BOOLEAN
= false
|
|
Create the target directory on the generic server if it does not exist.
|
||
|
|
|
inspectClasspathResources
:
SET_OF_STRING
|
|
Additional classpath resources that should be uploaded to the working directory before executing the inspect script.
|
||
|
|
|
inspectScript
:
STRING
|
|
Classpath to the script used to inspect the generic container.
|
||
|
|
|
inspectTemplateClasspathResources
:
SET_OF_STRING
|
|
Additional template classpath resources that should be uploaded to the working directory before executing the inspect script.The template is first rendered and the rendered content copied to a file, with the same name as the template, in the working directory.
|
||
|
|
|
restartRequired
:
BOOLEAN
= true
|
|
Restart Required
|
||
|
|
|
restartRequiredForNoop
:
BOOLEAN
= false
|
|
The generic container requires a restart for the NOOP action performed by this deployed.
|
||
|
|
|
targetDirectoryShared
:
BOOLEAN
= true
|
|
Is the target directory shared by others on the generic server. When true, the target directory is not deleted during a destroy operation; only the artifacts copied to it.
|
www.ApacheConfFragmentSpec
| Type Hierarchy | generic.Resource >> udm.BaseDeployable >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Taggable, udm.Deployable, udm.ConfigurationItem |
Specification for an Apache configuration fragment.
| Public Properties | ||
|---|---|---|
|
|
|
tags
:
SET_OF_STRING
|
|
If set, this deployable will only be mapped automatically to containers with the same tag.
|
www.ApacheHttpdServer
| Type Hierarchy | generic.Container >> udm.BaseContainer >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Taggable, udm.ConfigurationItem, generic.GenericContainer, udm.Container, overthere.HostContainer |
Apache HTTPD web server
| Parent | ||
|---|---|---|
|
|
|
host
:
CI<overthere.Host>
|
|
Host upon which the container resides
|
| Public Properties | ||
|---|---|---|
|
|
|
configurationFragmentDirectory
:
STRING
|
|
The directory into which Apache configuration files (for virtual host definitions) should be written
|
||
|
|
|
defaultDocumentRoot
:
STRING
|
|
The directory in which document roots for virtual hosts should be created. Web content deployed without a virtual host will also be copied into this directory
|
||
|
|
|
restartWaitTime
:
INTEGER
= 10
|
|
Duration (in secs) to wait after the restart server step has been executed
|
||
|
|
|
startCommand
:
STRING
|
|
The command to start Apache. Arguments containing spaces are not supported
|
||
|
|
|
startWaitTime
:
INTEGER
= 10
|
|
Duration (in secs) to wait after the start server step has been executed
|
||
|
|
|
stopCommand
:
STRING
|
|
The command to stop Apache. Arguments containing spaces are not supported
|
||
|
|
|
stopWaitTime
:
INTEGER
= 10
|
|
Duration (in secs) to wait after the stop server step has been executed
|
||
|
|
|
envVars
:
MAP_STRING_STRING
|
|
Environment variables for container
|
||
|
|
|
restartCommand
:
STRING
|
|
The command to restart Apache. If left blank, reload command is used. If reload command is also blank than the sequence 'stop, start' is used. Arguments containing spaces are not supported
|
||
|
|
|
tags
:
SET_OF_STRING
|
|
If set, only deployables with the same tag will be automatically mapped to this container.
|
| Hidden Properties | ||
|---|---|---|
|
|
|
restartOrder
:
INTEGER
= 90
|
|
The order of the restart container step in the step list.
|
||
|
|
|
restartScript
:
STRING
= <#assign restart=(container.restartCommand)!''><#if restart != ''>www/apache/restart<#else>www/apache/stopstart
|
|
The command to restart or reload Apache. If left blank, the sequence 'stop, start' is used. Arguments containing spaces are not supported
|
||
|
|
|
startOrder
:
INTEGER
= 90
|
|
The order of the start container step in the step list.
|
||
|
|
|
startScript
:
STRING
= www/apache/start
|
|
The command to start Apache. Arguments containing spaces are not supported
|
||
|
|
|
stopOrder
:
INTEGER
= 10
|
|
The order of the stop container step in the step list.
|
||
|
|
|
stopScript
:
STRING
= www/apache/stop
|
|
The command to stop Apache. Arguments containing spaces are not supported
|
||
|
|
|
inspectClasspathResources
:
SET_OF_STRING
|
|
Additional classpath resources that should be uploaded to the working directory before executing the inspect script.
|
||
|
|
|
inspectScript
:
STRING
|
|
Classpath to the script used to inspect the generic container.
|
||
|
|
|
inspectTemplateClasspathResources
:
SET_OF_STRING
|
|
Additional template classpath resources that should be uploaded to the working directory before executing the inspect script.The template is first rendered and the rendered content copied to a file, with the same name as the template, in the working directory.
|
| Control Tasks | ||
|---|---|---|
| restart |
Restart Apache |
|
| start |
Start Apache |
|
| stop |
Stop Apache |
www.ApacheVirtualHost
| Type Hierarchy | www.ApacheConfFragment >> generic.ProcessedTemplate >> generic.AbstractDeployedArtifact >> generic.AbstractDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Deployed, udm.ConfigurationItem, udm.EmbeddedDeployedParent |
Apache virtual host
| Parent | ||
|---|---|---|
|
|
|
container
:
CI<udm.Container>
|
|
The container on which this deployed runs.
|
| Public Properties | ||
|---|---|---|
|
|
|
host
:
STRING
|
|
The virtual host name. Use '*' to match all hosts
|
||
|
|
|
port
:
STRING
|
|
The virtual host port. Use '*' to match all ports
|
||
|
|
|
deployable
:
CI<udm.Deployable>
|
|
The deployable that this deployed is derived from.
|
||
|
|
|
documentRoot
:
STRING
|
|
The document root for web content using this virtual host. If left blank, a directory is created in the web server's document root
|
| Hidden Properties | ||
|---|---|---|
|
|
|
createOrder
:
INTEGER
= 50
|
|
The order of the step in the step list for the create operation.
|
||
|
|
|
createVerb
:
STRING
= Create
|
|
Create Verb
|
||
|
|
|
destroyOrder
:
INTEGER
= 40
|
|
The order of the step in the step list for the destroy operation.
|
||
|
|
|
destroyVerb
:
STRING
= Destroy
|
|
Destroy Verb
|
||
|
|
|
modifyOrder
:
INTEGER
= 50
|
|
The order of the step in the step list for the modify operation.
|
||
|
|
|
modifyVerb
:
STRING
= Modify
|
|
Modify Verb
|
||
|
|
|
noopOrder
:
INTEGER
= 50
|
|
The order of the step in the step list for the noop operation.
|
||
|
|
|
noopVerb
:
STRING
= Modify
|
|
Noop Verb
|
||
|
|
|
targetDirectory
:
STRING
= ${deployed.container.configurationFragmentDirectory}
|
|
Target directory name
|
||
|
|
|
targetFile
:
STRING
= ${deployed.name}.conf
|
|
Target file name
|
||
|
|
|
template
:
STRING
= www/apache/${deployed.type}.conf.ftl
|
|
Configuration fragment template file name.
|
||
|
|
|
createTargetDirectory
:
BOOLEAN
= false
|
|
Create the target directory on the generic server if it does not exist.
|
||
|
|
|
inspectClasspathResources
:
SET_OF_STRING
|
|
Additional classpath resources that should be uploaded to the working directory before executing the inspect script.
|
||
|
|
|
inspectScript
:
STRING
|
|
Classpath to the script used to inspect the generic container.
|
||
|
|
|
inspectTemplateClasspathResources
:
SET_OF_STRING
|
|
Additional template classpath resources that should be uploaded to the working directory before executing the inspect script.The template is first rendered and the rendered content copied to a file, with the same name as the template, in the working directory.
|
||
|
|
|
restartRequired
:
BOOLEAN
= true
|
|
Restart Required
|
||
|
|
|
restartRequiredForNoop
:
BOOLEAN
= false
|
|
The generic container requires a restart for the NOOP action performed by this deployed.
|
||
|
|
|
targetDirectoryShared
:
BOOLEAN
= true
|
|
Is the target directory shared by others on the generic server. When true, the target directory is not deleted during a destroy operation; only the artifacts copied to it.
|
www.ApacheVirtualHostSpec
| Type Hierarchy | www.ApacheConfFragmentSpec >> generic.Resource >> udm.BaseDeployable >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Taggable, udm.Deployable, udm.ConfigurationItem |
Specification for an Apache virtual host
| Public Properties | ||
|---|---|---|
|
|
|
documentRoot
:
STRING
|
|
The document root for web content using this virtual host. If left blank, a directory is created in the web server's document root (string)
|
||
|
|
|
host
:
STRING
|
|
The virtual host name. Use '*' to match all hosts (string)
|
||
|
|
|
port
:
STRING
|
|
The virtual host port. Use '*' to match all ports (string)
|
||
|
|
|
tags
:
SET_OF_STRING
|
|
If set, this deployable will only be mapped automatically to containers with the same tag.
|
www.PublishedWebContent
| Type Hierarchy | generic.CopiedArtifact >> generic.AbstractDeployedArtifact >> generic.AbstractDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Artifact, udm.Deployed, udm.ConfigurationItem, udm.DerivedArtifact, udm.EmbeddedDeployedParent |
Web content on the webserver
| Parent | ||
|---|---|---|
|
|
|
container
:
CI<udm.Container>
|
|
The container on which this deployed runs.
|
| Public Properties | ||
|---|---|---|
|
|
|
deployable
:
CI<udm.Deployable>
|
|
The deployable that this deployed is derived from.
|
||
|
|
|
placeholders
:
MAP_STRING_STRING
|
|
A Map containing all the placeholders mapped to their values. Special values are <ignore> or <empty>
|
||
|
|
|
|
|
Virtual host which this web content maps to.
|
| Hidden Properties | ||
|---|---|---|
|
|
|
createOrder
:
INTEGER
= 50
|
|
The order of the step in the step list for the create operation.
|
||
|
|
|
createVerb
:
STRING
= Create
|
|
Create Verb
|
||
|
|
|
destroyOrder
:
INTEGER
= 40
|
|
The order of the step in the step list for the destroy operation.
|
||
|
|
|
destroyVerb
:
STRING
= Destroy
|
|
Destroy Verb
|
||
|
|
|
modifyOrder
:
INTEGER
= 50
|
|
The order of the step in the step list for the modify operation.
|
||
|
|
|
modifyVerb
:
STRING
= Modify
|
|
Modify Verb
|
||
|
|
|
noopOrder
:
INTEGER
= 50
|
|
The order of the step in the step list for the noop operation.
|
||
|
|
|
noopVerb
:
STRING
= Modify
|
|
Noop Verb
|
||
|
|
|
targetDirectory
:
STRING
= <#assign target=(deployed.virtualHost.documentRoot)!''/><#if target != ''>${target}<#else>${deployed.container.defaultDocumentRoot}
|
|
Target directory name
|
||
|
|
|
createTargetDirectory
:
BOOLEAN
= false
|
|
Create the target directory on the generic server if it does not exist.
|
||
|
|
|
inspectClasspathResources
:
SET_OF_STRING
|
|
Additional classpath resources that should be uploaded to the working directory before executing the inspect script.
|
||
|
|
|
inspectScript
:
STRING
|
|
Classpath to the script used to inspect the generic container.
|
||
|
|
|
inspectTemplateClasspathResources
:
SET_OF_STRING
|
|
Additional template classpath resources that should be uploaded to the working directory before executing the inspect script.The template is first rendered and the rendered content copied to a file, with the same name as the template, in the working directory.
|
||
|
|
|
preserveExistingFiles
:
BOOLEAN
= false
|
|
if true, preserve the existing files on the remote host (do not delete the copied files during the destroy operation).
|
||
|
|
|
restartRequired
:
BOOLEAN
= false
|
|
Restart Required
|
||
|
|
|
restartRequiredForNoop
:
BOOLEAN
= false
|
|
The generic container requires a restart for the NOOP action performed by this deployed.
|
||
|
|
|
targetDirectoryShared
:
BOOLEAN
= true
|
|
Is the target directory shared by others on the generic server. When true, the target directory is not deleted during a destroy operation; only the artifacts copied to it.
|
||
|
|
|
targetFile
:
STRING
|
|
Target File
|
www.WebContent
| Type Hierarchy | generic.Folder >> udm.BaseDeployableFolderArtifact >> udm.BaseDeployableArtifact >> udm.BaseDeployable >> udm.BaseConfigurationItem |
|---|---|
| Interfaces | udm.Taggable, udm.Deployable, udm.SourceArtifact, udm.Artifact, udm.DeployableArtifact, udm.ConfigurationItem, udm.FolderArtifact |
Folder containing web content (HTML pages, images, etc)
| Public Properties | ||
|---|---|---|
|
|
|
excludeFileNamesRegex
:
STRING
|
|
Regular expression that matches file names that must be excluded from scanning
|
||
|
|
|
placeholders
:
SET_OF_STRING
|
|
Placeholders detected in this artifact
|
||
|
|
|
scanPlaceholders
:
BOOLEAN
= true
|
|
Whether to scan this artifact for placeholders when it is imported
|
||
|
|
|
tags
:
SET_OF_STRING
|
|
If set, this deployable will only be mapped automatically to containers with the same tag.
|
| Hidden Properties | ||
|---|---|---|
|
|
|
textFileNamesRegex
:
STRING
= .+\.(cfg | conf | config | ini | properties | props | txt | asp | aspx | htm | html | jsf | jsp | xht | xhtml | sql | xml | xsd | xsl | xslt)
|
|
Regular expression that matches file names of text files
|