Make platformdoc docker container

Issue-Id: DCAEGEN2-60
Change-Id: Id57ab539707a43883ff957a23d2459a9b12df22e
Signed-off-by: Lusheng Ji <lji@research.att.com>

1 files changed, 15 insertions, 0 deletions

diff --git a/platformdoc/docs/architecture/service-discovery.md b/platformdoc/docs/architecture/service-discovery.md
new file mode 100644
index 00000000..25d69fcf
--- /dev/null
+++ b/platformdoc/docs/architecture/service-discovery.md
@@ -0,0 +1,15 @@
+# Service Discovery
+
+Service discovery is an architecture pattern used for components (micro-services) to locate each other.  The DCAE platform uses [server-side discovery](http://microservices.io/patterns/server-side-discovery.html) and is using [Consul](https://www.consul.io/) as the service registry solution.
+
+## Service registration
+
+All components are required to register with Consul in order to be discovered.  There are two methods of registration: self and 3rd party.  The DCAE platform uses 3rd party registration which means components don't actually make the registration calls but defers that responsibility to a platform service.
+
+### Implementation for Docker
+
+[Registrator](http://gliderlabs.com/registrator/latest/) is an open source application that is responsible for registering all components that run as Docker containers.  Registrator watches the local Docker engine's activity log and will register and unregister a Docker container when the container is started and stopped.
+
+### Implementation for CDAP
+
+The CDAP broker is a REST web service that is responsible for registering all components that run as CDAP applications.