summaryrefslogtreecommitdiffstats
path: root/docs/architecture
diff options
context:
space:
mode:
Diffstat (limited to 'docs/architecture')
-rw-r--r--docs/architecture/pieces.md7
-rw-r--r--docs/architecture/service-discovery.md15
2 files changed, 22 insertions, 0 deletions
diff --git a/docs/architecture/pieces.md b/docs/architecture/pieces.md
new file mode 100644
index 00000000..7787359f
--- /dev/null
+++ b/docs/architecture/pieces.md
@@ -0,0 +1,7 @@
+# Platform technologies
+
+* [Cloudify](http://getcloudify.org/)
+* [Consul](https://www.consul.io/)
+* [Docker](https://www.docker.com/)
+* [CDAP](https://cdap.io/)
+* [Registrator](https://github.com/gliderlabs/registrator)
diff --git a/docs/architecture/service-discovery.md b/docs/architecture/service-discovery.md
new file mode 100644
index 00000000..25d69fcf
--- /dev/null
+++ b/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.