Introduction

Petals ESB Deployer is a tool to manage the deployment of a whole Petals ESB bus.

Deploying a whole Petals ESB bus includes to deploy Petals ESB containers, Petals ESB Hazelcast Registry, and service consumers or providers running on their binding components or service-engines correctly configured. The architecture of the Petals ESB bus and service providers/consumers to deploy are defined into a model.

Petals ESB Deployer is embedded into Petals ESB CLI through different commands:

the command deploy is extended to deploy a whole Petals ESB bus, and to migrate an existing deployment to a new version,
the command undeploy is extended to undeploy a whole Petals ESB bus,
the dedicated command check-deployment will check an existing Petals ESB bus against a given model describing the expected Petals ESB bus.

Petals ESB Deployer 1.0.0 is provided with [Petals ESB CLI *3.2.0*].

Table of contents

Introduction
Use cases
Modeling your deployments

Service-units Object Model
Topology Object Model
Bus Object Model

Petals Deployment Model

Class Diagram of the solution
Source code
Example project

Contributors

Use cases

The goal of Petals ESB Deployer is to resolve several deployment problematics:

how to simplify the deployment of a Petals ESB bus avoiding to use scripts for automating deployment ?
how to upgrade an existing deployment of a Petals ESB bus to a new version of this Petals ESB bus,
how to deploy a set of service providers and consumers on different environments, for example DEV, TEST or PROD where the Petals ESB bus topology and external resources are different ?
how to deploy a Petals ESB bus on different environments, for example STAGING, PRE-PROD, PROD where the Petals ESB bus topology is the same but where machines running Petals ESB bus and external resources are differents ?

Modeling your deployments

Petals ESB Deployer is based on a model defining your Petals ESB bus to deploy. This model contains all components and their configurations forming your Petals ESB bus.

The model of your Petals ESB bus is composed of several parts:

a Service-units Object Model: that list all service-units that must be deployed into your Petals ESB bus,
a Topology Object Model: that defines the topology of your Petals ESB bus,
a Bus Object Model the defines:
- where are running the service-units, on which Petals ESB container of your topology,
- where are running your Petals ESB containers, on which machine,
- where are running your Petals ESB Hazelcast Registry nodes, on which machines,
- which external resources are to be used.

Service-units Object Model

This model defines the set of service units to deploy on your Petals ESB bus. This model will be mainly written by development teams because they have the knowledge of service units to deploy.