WildFly Deployment Concepts
Internal
Deployment Name
Each deployment is identified by an unique name. Unless explicitly specified with the --name CLI option, the default value of a deployment name is the name of the file that was used when the artifact content was added to the repository.
Deployment Runtime Name
Represents the runtime name of the deployment, and if not explicitly specified with --runtime-name CLI option, is the same as the deployment name. The runtime name will form the basis for default Java EE application and module names. There are cases when users may wish to have two deployments with the same runtime name (two versions of application) both available in the management configuration, in which case the deployments would need to have distinct name values but would have the same runtime name. Within an individual server, only one deployment with a given runtime name can deployed. However, multiple deployments with the same runtime name can exist in the configuration, so long as only one is enabled.
Unmanaged Deployments
The default behavior of the application server is to add the deployment artifact contents to the repository. This behavior can be explicitly avoided if a deployment is declared "unmanaged", with the --unamanged CLI option: the deployment content will remain at and be deployed directly from its original location. Exploded deployments are supported only as unmanaged.
Deployment Artifact Repository
Both standalone and domain modes rely on the presence of an artifact repository.
For instances running in standalone mode, the repository is in $JBOSS_HOME/standalone/data/content.
For instances running in domain mode, the repository resides on the domain controller host. For more details see Domain-Wide Deployment Artifact Repository below.
Standalone Mode Deployments
Location of the Deployment Artifacts on the File System in Standalone Mode
Standalone Deployment Modes
- CLI
- Management Console
- HTTP REST
- Deployment Scanner
Domain Mode Deployments
Domain Deployment Mechanics
CLI deployment commands operate on artifacts existing in the deployment artifact repository. An artifact must first be stored in repository before it is distributed to server nodes. The location of the artifact in the repository is reported by the domain controller upon deployment:
[Host Controller] 11:12:16,279 INFO [org.jboss.as.repository] (management-handler-thread - 9) JBAS014900: Content added at location /jboss-eap-6.4.15/profiles/domain-deployment-test/data/content/1c/795338f655a8e6aa5b1d984e894ee5e89cc398/content
The naming scheme used to store content is explained in the Domain-Wide Deployment Artifact Repository section. After storing the content in the repository, the content is usually pushed to target server nodes by the controller as part of the same operation. The deployment artifact content ends up in the data/content directory of each target server node, following the same naming scheme for storage on the file system (.../data/content/1c/795338f655a8e6aa5b1d984e894ee5e89cc398/content). Note that adding content to repository and pushing to nodes can be done in separate steps. Upgrades are handled differently. Once an artifact, identified by its name, is added to the repository, upgrades of artifacts with the same name will be pushed only to server nodes on which the artifact is already deployed. A special flag (--force) is required to specify that the operation is an upgrade, and the attempt to specify other target nodes than the ones that are already running the artifact - in fact, any target nodes, ends up in failure. As part of the upgrade operation, the content corresponding to the new version of the artifact is stored in a different location in the artifact repository, as the hash of the artifact is different, but under the same artifact name. For more operational details, see:
A successful now deployment or upgrade reflects in changes in domain.xml. The <deployments> section lists the name and the hash of the artifact, and represents, in fact, the listing of the content of the repository:
<deployments>
<deployment name="servlet-example.war" runtime-name="servlet-example.war">
<content sha1="b4bcac8f15c72e964076680932b0989675078889"/>
</deployment>
</deployments>
Domain-Wide Deployment Artifact Repository
The domain-wide deployment artifact repository is located on the controller host, under $JBOSS_HOME/domain/data/content. The content is maintained in a two-level directory structure named based on the content's hash. The names of the first level directories consist of the first two characters of content hashes. A second-level directory name contains the rest of the hash, and the directory contains the content itself, as a file named "content".
Example:
<domain ...>
...
<deployments>
...
<deployment name="test-servlet.war" runtime-name="test-servlet.war">
<content sha1="e85e00cddbae1752cb7eaaa73adb1eed09787d70"/>
</deployment>
</deployments>
</domain>
$JBOSS_HOME/domain/data/content/<first-two-characters-of-the-hash>/<the-rest-of-the-hash>/content
domain | +-- data | +-- content | +-- e8 | +-- 5e00cddbae1752cb7eaaa73adb1eed09787d70 | +-- content
Also see
Location of the Deployment Artifacts on the File System in Domain Mode
For the location of the domain-wide artifact repository, see Domain-Wide Deployment Artifact Repository section below.
In case of server nodes, copies of the deployment artifacts are pushed by the domain management logic to:
$JBOSS_HOME/domain/data/servers/<server-node-name>/content/<first-two-characters-of-the-hash>/<the-rest-of-the-hash>/content
Domain Deployment Modes
- CLI
- Management Console
- HTTP REST
Rollout Plans
Deployment Scanner
Deployment Descriptor Validation
./domain.sh|./standalone.sh -Dorg.jboss.metadata.parser.validate=true