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
  • Create target path on webserver, if needed
  • Copy web content to target path on webserver
  • Delete web content from host
  • Delete existing web content from webserver
  • Copy modified web content to target path on webserver
www.ApacheVirtualHost
  • Copy virtual host configuration to webserver
  • Delete virtual host configuration from webserver
  • Delete virtual host configuration from webserver
  • Copy new virtual host configuration to webserver
www.ApacheConfFragment
  • Copy configuration fragment to webserver
  • Delete configuration fragment from webserver
  • Delete configuration fragment from webserver
  • Copy new configuration fragment to webserver

CI Reference

Configuration Item Overview

Deployable Configuration Items

CIDescription
www.ApacheConfFragmentSpecSpecification for an Apache configuration fragment
www.ApacheVirtualHostSpecSpecification for an Apache virtual host
www.WebContentFolder containing web content (HTML pages, images, etc)

Deployed Configuration Items

CIDescription
www.ApacheConfFragmentApache configuration fragment
www.ApacheVirtualHostApache virtual host
www.PublishedWebContentWeb content on the webserver

Topology Configuration Items

CIDescription
www.ApacheHttpdServerApache HTTPD web server

Configuration Item Details

www.ApacheConfFragment

Hierarchygeneric.ProcessedTemplate >> generic.AbstractDeployedArtifact >> generic.AbstractDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem
Interfacesudm.Deployed, udm.ConfigurationItem

Apache configuration fragment

Public Properties
container  : CI<udm.Container>

The container on which this deployed runs.
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

Hierarchygeneric.Resource >> udm.BaseDeployable >> udm.BaseConfigurationItem
Interfacesudm.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

Hierarchygeneric.Container >> udm.BaseContainer >> udm.BaseConfigurationItem
Interfacesudm.Taggable, udm.ConfigurationItem, generic.GenericContainer, udm.Container, overthere.HostContainer

Apache HTTPD web server

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
host  : CI<overthere.Host>

Host upon which the container resides
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
deploymentGroup : INTEGER

If the group-orchestrator is enabled, all containers with the same deployment group number will be deployed to at the same time. The groups are ordered by this number.
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

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

Hierarchywww.ApacheConfFragment >> generic.ProcessedTemplate >> generic.AbstractDeployedArtifact >> generic.AbstractDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem
Interfacesudm.Deployed, udm.ConfigurationItem

Apache virtual host

Public Properties
container  : CI<udm.Container>

The container on which this deployed runs.
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

Hierarchygeneric.Resource >> udm.BaseDeployable >> udm.BaseConfigurationItem
Interfacesudm.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

Hierarchygeneric.CopiedArtifact >> generic.AbstractDeployedArtifact >> generic.AbstractDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem
Interfacesudm.Artifact, udm.Deployed, udm.ConfigurationItem, udm.DerivedArtifact

Web content on the webserver

Public Properties
container  : CI<udm.Container>

The container on which this deployed runs.
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>
virtualHost : CI<www.ApacheVirtualHost>

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.
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

Hierarchygeneric.Folder >> udm.BaseDeployableFolderArtifact >> udm.BaseDeployableArtifact >> udm.BaseDeployable >> udm.BaseConfigurationItem
Interfacesudm.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

Scan Placeholders
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
Copyright XebiaLabs B.V. 2009-2012. All rights reserved.