Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current Restore this Version View Page History

« Previous Version 6 Current »

Contributions are deployed to the Fabric3 server in one of three ways:

  • By packaging contribution archives and the Fabric3 runtime as a deployable image using the Fabric3 Maven Assembly Plugin.
  • By using the The Admin CLI which provides a command line interface and scripting API for automated deployment.
  • By placing contribution archives in the deploy directory of a running server instance.

The recommended deployment methodology for production systems is to create a runtime image with the Fabric3 Assembly Plugin or use the Admin CLI.  Directory deployment is intended for development use; the rest of this section provides details on how to use it.

Directory-based Deployment

Contributions can be deployed by copying them to the server's /deploy directory. The server periodically scans the directory for new contributions and will deploy them when found. If an application is comprised of multiple contributions that depend on each other, the server will calculate the proper order the contributions must be deployed based on the import metadata contained in their manifests, including transitive dependencies. For example, if A depends on B which dependences on C, the server will deploy C, then B, followed by A.

Multiple Deployment Directories

The Fabric3 server can be configured to scan multiple deployment directories by adding a <deploy.dirctories> entry in serverConfig.xml:

<config>
   <deploy.directories>
      <deploy.directory>deploy1</deploy.directory>
      <deploy.directory>deploy2</deploy.directory>
   </deploy.directories>
</config>

Directory entries can be relative or absolute. If an entry is relative (as shown in the above example), it will be interpreted relative to the /runtime directory.

Dynamic Reloading

Fabric3 also supports dynamic reloading of contributions when their contents have changed by creating a contribution link. A contribution link is a file ending in .contribution that is placed in the /deploy directory. The file contains a single line entry pointing to an exploded directory, which is typically a Maven or IDE project directory:

/Users/f3/workspace/myproject