Logistics Wizard Toolchain

This toolchain allows to deploy the Logistics Wizard sample application, which is a supply chain management web application composed of several micro-services. Refer to the parent project for details.

It includes four modules:

• Controller - The API that sits on the edge of the architecture and interfaces with all other services.
• ERP - An API that handles user login and interaction with the ERP system objects.
• WEBUI - The Web UI that is the web front end of the entire application, built using React.
• Weather Recommendation - Makes shipment recommendations based on weather conditions

The toolchain is preconfigured for:

• issue tracking
• source control
• continuous delivery and integration (CI/CD)
• unit and code coverage testing
• blue-green deployment

Deploy the toolchain in IBM Bluemix

1. Ensure you have a GitHub account.

2. Ensure you have a Bluemix account.

3. Ensure you have 2GB of free memory and space for 4 additional services in your Bluemix organization.

4. It is recommended to create a new space named logistics-wizard in your Bluemix organization. This helps grouping the apps and services together in the console.

5. To get started, click this button:

1. The toolchain configuration page opens.

1. Give a name to your toolchain. This name is used as the prefix for the deployed applications. The name must be unique within your organization.

A simple trick is to use your name or initials or to leave the default generated name.

1. Select the GitHub box.

2. Optionally change the name of the GitHub repositories that will be created in your GitHub account.

You can choose to fork the main repositories so that you can import changes as they become available or to clone the repositories.

1. Select the Delivery Pipeline box.

2. Ensure the app names are unique.

3. Select the region, organization and space where you want to deploy the application.

4. Set your OpenWhisk Authorization Key. You can find your OpenWhisk key in the Bluemix console here. When doing so, make sure you are in the same region/organization/space where you are deploying the apps. The authorization key is specific to a given space. In the CLI configuration page, the authorization key is after the --auth parameter. As example in the following, the authorization key is 1234-4567-8901-2345:tonywinBtm00001112221:

wsk property set --apihost openwhisk.ng.bluemix.net --auth 1234-4567-8901-2345:tonywinBtm00001112221

1. You can leave the coveralls tokens empty - this is really needed only for the main deployment we do in our team.

2. Click Create

3. Once the toolchain is created, you will end up with several delivery pipelines for all applications in the sample. Wait for the pipelines to deploy all the apps. You can open all pipelines in new browser tabs to follow the deployments or you can wait for all apps to be ready in the Bluemix dashboard.

4. Your apps are deployed. Head over the walkthrough for a tour of the app.

---

Learn more

• Bluemix DevOps Services
• Bluemix Toolchains Documentation
• InterConnect 2016 video recording