index.md 3.89 KB
Newer Older
1
# Bonita Continuous Delivery Add-on
jeremy's avatar
jeremy committed
2

3
::: info
4
Welcome to **Bonita Continuous Delivery** documentation website!
5
:::
jeremy's avatar
jeremy committed
6

7
![Bonita Continuous Delivery Add-on Logo](images/bcd_logo.png "Bonita Continuous Delivery Add-on Logo")
jeremy's avatar
jeremy committed
8

9
The Bonita Continuous Delivery (BCD) add-on provides a solution to use _Continuous Delivery_ practice for your Bonita Living Application development and deployment.
jeremy's avatar
jeremy committed
10

11
The BCD add-on is powered by [Docker containerization solution](https://www.docker.com/) and [Ansible automation framework](https://www.ansible.com/). It is composed of two parts:
jeremy's avatar
jeremy committed
12

13
14
15
16
*   First, a solution for **Provisioning** of a Bonita stack on cloud or on-premises hosts.  
    BCD lets you deploy Bonita on existing servers using [Docker](https://www.docker.com/what-container) containers. Furthermore, when used with [Amazon Web Services (AWS) cloud platform](https://aws.amazon.com/), BCD enables you to create and delete [AWS EC2 instances](https://aws.amazon.com/ec2/) automatically.
*   Second, a framework for **Continuous Delivery** of Living Applications.  
    BCD lets you build a Living Application repository and deploy the generated artifacts from the command line.
jeremy's avatar
jeremy committed
17

18
19
20
::: warning
It is highly recommended to have a clear understanding of [Docker essential concepts](https://docs.docker.com/engine/docker-overview/) prior to reading this documentation.
:::
21

22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
<div class="col-md-4">
<div class="panel panel-default">
<div class="panel-heading">Quick start</div>
<div class="panel-body">
<div style="padding: 15px; padding-bottom: 0px;">Follow this guide with step-by-step instructions to quickly start using Bonita Continuous Delivery solution.</div>
<div class="menu-block-wrapper">

*  [:fa-angle-double-right: Getting started with BCD](quickstart.md)
<!--{ul:.menu .nav}-->
</div>
</div>
</div>
</div>

<div class="col-md-4">
<div class="panel panel-default">
<div class="panel-heading">Release notes</div>
<div class="panel-body">
<div style="padding: 15px; padding-bottom: 0px;">Find out what’s new in Bonita Continuous Delivery add-on! Read the release notes.</div>
<div class="menu-block-wrapper">

* [:fa-angle-double-right: What's new in BCD?](release_notes.md)
<!--{ul:.menu .nav}-->
</div>
</div>
</div>
</div>

<div class="col-md-4">
<div class="panel panel-default">
52
<div class="panel-heading">Howtos</div>
53
54
55
56
<div class="panel-body">
<div style="padding: 15px; padding-bottom: 0px;">Check out the tutorials for practical guides about using Bonita Continuous Delivery add-on.</div>
<div class="menu-block-wrapper">

57
* [:fa-angle-double-right: BCD Howtos](_howtos.md)
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
<!--{ul:.menu .nav}-->
</div>
</div>
</div>
</div>

<div class="clearfix"></div>

Basic concepts <!--{.h2}-->

This add-on provides a `bcd` command-line interface (BCD CLI) which enables to:

*   deploy a full Bonita stack
*   build and deploy Bonita Living Applications

A **Bonita stack** is formed by a database service, Bonita Docker containers running Tomcat application servers and a HAProxy load balancer when deploying a multi-node Bonita cluster.

The BCD CLI is provided within a ready-to-use environment called **BCD Controller**. This environment is packaged as a Docker image.  
Then a controller container will have to be started interactively on your control workstation from which `bcd` commands will be issued.

Architecture overview <!--{.h2}-->

Here is an overview of how BCD drives the provisioning of a Bonita stack.

![BCD Architecture Overview](images/bonita_platform_stack.png "BCD Architecture Overview")

84
*   A **Host** can be a AWS EC2 instance or an existing server running on-premises or on another cloud provider.
85
86
87
*   The control workstation bind mounts some essential files with the controller container including:
    *   `~/bonita-continuous-delivery` - used as a working directory for BCD CLI known as the `BCD_HOME` directory
    *   `~/.ssh/private_key` - used to allow SSH access to target hosts
88
    *   `~/.boto` - credential to your AWS account (when applicable)