Tools

WebLogic Deploy Tooling (WDT)

You can use several of the WDT tools in a CI/CD pipeline. For example, the createDomain tool creates a new domain based on a simple model, and updateDomain (and deployApps) uses the same model concept to update an existing domain (preserving the same domain encryption key). The deployApps tool is very similar to the updateDomain tool, but limits what can be updated to application-related configuration attributes such as data sources and application archives. The model used by these tools is a sparse set of attributes needed to create or update the domain. A model can be as sparse as providing only the WebLogic Server administrative password, although not very interesting. A good way to get a jumpstart on a model is to use the discoverDomain tool in WDT which builds a model based on an existing domain.

Other than the tools themselves, there are three components to the WDT tools:

  • The Domain Model - Metadata model describing the desired domain.
    The metadata domain model can be written in YAML or JSON and is documented here.
  • The Archive ZIP - Binaries to supplement the model.
    All binaries needed to supplement the model must be specified in an archive file, which is just a ZIP file with a specific directory structure. Optionally, the model can be stored inside the ZIP file, if desired. Any binaries not already on the target system must be in the ZIP file so that the tooling can extract them in the target domain.
  • The Properties File - A standard Java properties file.
    A property file used to provide values to placeholders in the model.

WDT Create Domain Samples

  • (Docker) A sample for creating a domain in a Docker image with WDT can be found here.
  • (Kubernetes) A similar sample of creating a domain in a Docker image with WDT can be found in the WebLogic Kubernetes Operator project for creating a domain-in-image with WDT.

WebLogic Scripting Tool (WLST)

You can use WLST scripts to create and/or update domains in a CI/CD pipeline. We recommend that you use offline WLST for this purpose. There may be some scenarios where it is necessary to use WLST online, but we recommend that you do that only as an exception, and when absolutely necessary.

If you do not already have WLST scripts, we recommend that you consider using WebLogic Deploy Tooling (WDT) instead. It provides a more declarative approach to domain creation, whereas WLST is more of an imperative scripting language. WDT provides advantages like being able to use the same model with different versions of WebLogic, whereas you may need to update WLST scripts manually when migrating to a new version of WebLogic for example.

WebLogic pack and unpack tools

WebLogic Server provides tools called “pack” and “unpack” that can be used to “clone” a domain. These tools do not preserve the domain encryption key. You can use these tools to make copies of domains in scenarios when you do not need the same domain encryption key.