IBM Business Automation Reference Architecture

This project represents the body of knowledge around business automation solution implementation and reference architecture and can be considered as a living book, we are writing on a daily basis from the experience gathered with our engagements. All the content is visible as a BOOK format here.

The content of this repository is the source of the digital business automation reference architecture in the IBM Garage architecture center visible here. This git repository is maintained on a weekly basis and includes more content not yet formally published to IBM sites. As we are implementing the end to end solution we are updating this main git repository to keep best practices accurate.

Building this booklet locally

The content of this repository is written with markdown files, packaged with MkDocs and can be built into a book-readable format by MkDocs build processes.

1. Install MkDocs locally following the official documentation instructions.
2. Install Material plugin for mkdocs: pip install mkdocs-material
3. git clone https://github.com/ibm-cloud-architecture/refarch-dba (or your forked repository if you plan to edit)
4. cd refarch-dba
5. mkdocs serve
6. Go to http://127.0.0.1:8000/ in your browser.

Building this booklet locally but with docker

In some cases you might not want to alter your Python setup and rather go with a docker image instead. This requires docker is running locally on your computer though.

• docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material
• Go to http://127.0.0.1:8000/ in your browser.

Automatic deployment on github

This project includes a .github folder to define a git action workflow to build the pages when content is pushed to github.

Contributors

• Lead Content developer Jeff Goodhue
• Content developer Thomas Yang
• Content developer Pierre Berlandier