deep-microservices-waf

deep-microservices-waf is a microservice designed to implement cloud-native firewall for web applications built on top of DEEP Framework. It could be used either as a standalone application or as a dependency in other deep-microservices. This repository is open sourced to show case how developers can build and deploy hassle-free cloud-native web applications using microservices architecture and serverless computing.

Getting Started

Step 1. Pre-requisites

• Create an Amazon Web Services account
• Configure AWS Command Line Interface
• Get Started - Installing Git
• JDK 8 and JRE 8 Installation Start Here
• Install nvm and use node v6.10+
• Install DEEP CLI, also known as deepify:

npm install deepify -g

If you want to use deepify on Windows, please follow the steps from Windows Configuration before running npm install deepify -g and make sure all npm and deepify commands are executed inside Git Bash.

Step 2. Install Microservice(s) Locally

deepify install github://MitocGroup/deep-microservices-waf ~/deep-microservices-waf

Path parameter in all deepify commands is optional and if not specified, assumes current working directory. Therefore you can skip ~/deep-microservices-waf by executing mkdir ~/deep-microservices-waf && cd ~/deep-microservices-waf before deepify install.

Step 3. Run Microservice(s) in Development

deepify server ~/deep-microservices-waf -o

When this step is finished, you can open in your browser the link http://localhost:8000 and enjoy the deep-microservices-waf running locally.

Step 4. Deploy Microservice(s) to Production

deepify deploy ~/deep-microservices-waf

Amazon CloudFront distribution takes up to 20 minutes to provision, therefore don’t worry if it returns an HTTP error in the first couple of minutes.

Step 5. Remove Microservice(s) from Production

deepify undeploy ~/deep-microservices-waf

Amazon CloudFront distribution takes up to 20 minutes to unprovision. That's why deepify command checks every 30 seconds if it's disabled and when successful, removes it from your account.

Developer Resources

Having questions related to deep-microservices-waf?

• Ask questions: https://stackoverflow.com/questions/tagged/deep-framework
• Chat with us: https://mitocgroup.slack.com/messages/general
• Send an email: feedback@mitocgroup.com

Interested in contributing to deep-microservices-waf?

• Contributing: https://github.com/MitocGroup/deep-microservices-waf/blob/master/CONTRIBUTING.md
• Issue tracker: https://github.com/MitocGroup/deep-microservices-waf/issues
• Releases: https://github.com/MitocGroup/deep-microservices-waf/releases
• Roadmap: https://github.com/MitocGroup/deep-microservices-waf/blob/master/ROADMAP.md

Looking for web applications that use (or are similar to) deep-microservices-waf?

• Hello World: https://hello.deep.mg | https://github.com/MitocGroup/deep-microservices-helloworld
• Todo App: https://todo.deep.mg | https://github.com/MitocGroup/deep-microservices-todomvc
• AdTechMedia: https://www.adtechmedia.io | https://github.com/AdTechMedia/adtechmedia-website

Sponsors

This repository is being sponsored by:

• Mitoc Group
• AdTechMedia

This code can be used under MIT license:

See LICENSE for more details.