Skip to content
Example applications to demonstrate Berlioz cloud deployment service capabilities.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
01.HelloWorld.java
01.HelloWorld.js
01.HelloWorld.py
02.DynamoDB
03.Kinesis
04.Pharmacy
07.GCP
08.GcpImage
09.GcpFunc
docs
in-progress
.gitignore
LICENSE
README.md

README.md

Berlioz Samples

The purpose of this repository is to present capabilities of Berlioz - the microservices applications deployment and orchestration service for AWS.

The repo is structured in chapters, starting with trivial samples to more complex applications.

Prerequisites

First, install berlioz command line toolkit.

$ npm install berlioz -g

Running Samples Locally

  1. Navigate to sample directory
$ cd 01.HelloWorld.js/v1.basic
  1. Some examples are using AWS native resources like DynamoDB and Kinesis. In order to run the samples locally you should provide the name of AWS profile to use to provision thouse native resources:
$ berlioz local account --profile <the-name-of-aws-profile-to-use>
  1. Build and deploy the project
$ berlioz local build-run
  1. Output service endpoint addresses
$ berlioz local endpoints
  1. Open the endpoint in the browser: http://localhost:40000 (use the port returned from the step 3).

Running Samples in AWS

Account Setup

  1. Sign-up and login to AWS.
  2. Create AWS access key. For details see the guide here.
  3. Sign-up to Berlioz:
$ berlioz signup
  1. Link AWS account to Berlioz:
$ berlioz provider create --name myaws --kind aws --key <key> --secret <secret>
  1. Create deployments for production and test:
$ berlioz deployment create --name prod --provider myaws
$ berlioz deployment create --name test --provider myaws

Deploying the sample to AWS

  1. Navigate to sample directory
$ cd 01.HelloWorld.js/v1.basic
  1. Login the region in order to push images
$ berlioz login --region us-east-1
  1. Build and push the project to berlioz
$ berlioz push --region us-east-1
  1. Deploy the project to the test deployment
$ berlioz run --deployment test --cluster hello --region us-east-1
  1. Output service endpoint addresses
$ berlioz endpoints --deployment test --region us-east-1
  1. Open the endpoint in the browser: http://1.2.3.4:12345 (use the address and port returned from the step 4).

Service Diagrams

The berlioz comes with graphical diagram generation tool. To generate a diagram simply:

$ cd 02.DynamoDB
$ berlioz output-diagram

Will generate a diagram like this: DynamoDB Sample Diagram

or for a more complex project:

$ cd 02.Pharmacy
$ berlioz output-diagram

Pharmacy Demo Diagram

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.