mu

μ - A tool for managing your microservices platform

Build Status Join the chat at https://gitter.im/stelligent/mu Go Report Card

Why?

Amazon ECS (EC2 Container Service) provides an excellent platform for deploying microservices as containers. The challenge however is that there is a significant learning curve for microservice developers to deploy their applications in an efficient manner. Specifically, they must learn to use CloudFormation to orchestrate the management of ECS, ECR, EC2, ELB, VPC, and IAM resources. Additionally, tools like CodeBuild and CodePipeline must be mastered to create a continuous delivery pipeline for their microservices.

To address these challenges, this tool was created to simplify the declaration and administration of the AWS resources necessary to support microservices. Similar to how the Serverless Framework improved the developer experience of Lambda and API Gateway, this tool makes it easier for developers to use ECS as a microservices platform.

The mu tool uses CloudFormation stacks to manage all resources it creates. Additionally, mu will not create any databases or other AWS resources to support itself. It will only create resources (via CloudFormation) necessary to run your microservices. This means at any point you can stop using mu and continue to manage the AWS resources that it created via AWS tools such as the CLI or the console.

Architecture Diagram

Demo

Watch the 90 second demo below to see mu in action!

Demo

Get Started!

Install latest version to /usr/local/bin (or for additional options, see wiki):

curl -s https://raw.githubusercontent.com/stelligent/mu/master/install.sh | sh

Assuming your project already has a Dockerfile, you can initialize your mu.yml file with: mu init. More details available in the quickstart.

What's next?

Check out the examples to see snippets of mu.yml configuration files that you can use in your own project:

  • Basic - Simple website with continuous delivery pipeline deploying to dev and prod environments
  • Test Automation - Automating end-to-end testing via Newman
  • Env Variables - Defining environment variables for the service
  • HTTPS - Enable HTTPS on the ALB for an environment
  • DNS - Associate Route53 resource record with ALB for an environment
  • VPC Target - Targeting an existing VPC for an environment
  • Custom CloudFormation - Demonstration of adding custom AWS resources via CloudFormation

Refer to the wiki for complete details on the configuration of mu.yml and the cli usage:

  • Environments - managing VPCs, ECS clusters, container instances and ALBs
  • Services - managing ECS service configuration
  • Pipelines - managing continuous delivery pipelines
  • CLI - details about using the CLI
  • Custom CloudFormation - details about customizing the CloudFormation that is generated by mu.

Contributing

Want to contribute to Mu? Awesome! Check out the contributing guidelines to get involved.

Building from source

  • Install Go tools 1.7+ - (https://golang.org/doc/install)
  • Install Glide via curl https://glide.sh/get | sh
  • Clone this repo git clone [email protected]:stelligent/mu.git $GOPATH/src/github.com/stelligent/mu
  • Go to src cd $GOPATH/src/github.com/stelligent/mu
  • Ensure AWS CLI is configured with an access key, secret access key, and region.
  • Build with make

Related Repositories

vip-mu-plugins-public

vip-mu-plugins-public

The MU plugins directory for WordPress.com VIP Go next generation hosting platfo ...

helm-mu

helm-mu

Helm sources for searching emails and contacts using mu ...

microvm-refimpl2

microvm-refimpl2

We have moved: https://gitlab.anu.edu.au/mu/mu-impl-ref2 ...

mu4e

mu4e

Part of mu4e, the mu mail user agent ...

mu-releases

mu-releases

mu release tarballs ...