doc updates including overview and readmeS for sections

This commit is contained in:
Mark Fussell 2019-10-06 21:22:17 -07:00
parent ba62580d64
commit c259883f13
6 changed files with 45 additions and 9 deletions

BIN
images/overview.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB

36
overview.md Normal file
View File

@ -0,0 +1,36 @@
# Dapr overview
Dapr is a portable, event-driven runtime that makes it easy for enterprise developers to build resilient, microservice stateless and stateful applications that run on the cloud and edge and embraces the diversity of languages and developer frameworks.
## Any language, any framework, anywhere
Today we are experiencing a wave of cloud adoption. Developers are comfortable with web + database application architectures (for example classic 3-tier designs), but not with microservice application architectures which are inherently distributed. Its hard to become a distributed systems expert, nor should you have to. Developers want to focus on business logic, while leaning on he platforms to imbue their applications with scale, resiliency, maintainability, elasticity and the other attributes of cloud-native architectures.
This is where Dapr comes in. Darp codifies the *best practices* for building microservice applications into open, independent building blocks that enable you to build portable applications with the language and framework of your choice. Each building block is completely independent and you can use one, some or all of them in your application.
In addition Dapr is platform agnostic meaning you can run your applications locally, on any Kubernetes cluster and other hosting environments that Dapr integrates with. This enables you to build microservice applications that can run on both the cloud and edge.
In summary, you can use Dapr to build microservice applications using any language, any framework, and run them anywhere.
## What buidling block capabilities does Dapr provide?
There are many considerations when architecting and building microservices applications. Dapr provides best practices for common capabilities when building microservice applications that developers can use in a standard way and deploy to any environment. It does this by providing distributed system building blocks
Each of these building blocks are independent, meaning that you can use one, some or all of them in your application. In this first release of Dapr, the following building blocks are provided;
**Service invocation** Resilent service-to-service invocaton enables method calls, including retries, on remote services wherever they are located in the supported hosting environment.
**State Management** With state management for key/value pairs, long running, highly available, stateful services as well as shorter lived, stateless services can be easily written in the same application. The state store is pluggable and can include Azure Cosmos, AWS DynamoDB or Redis among others.
**Publish and subscribe messaging between services** Publishing events and subscribing to topics between services enables event-driven architectures to simplify horizontal scalability and make them resilient to failure.
**Event driven resource bindings**. Resource bindings and triggers further builds on event-driven architectures for scale and resiliency by receiving and sending events to and from any external resource such as databases, queues, file systems, etc.
**Actors** as the simple pattern for stateless and stateful objects that make concurrency simple with method and state encapsulation.
•**Distributed tracing between services** to easily diagnose and observe inter-service calls in production using the W3C Trace Context standard.
![](../../images/overview.png)

View File

@ -1,3 +0,0 @@
# documentation
Content for this file to be added

View File

@ -1,3 +0,0 @@
# documentation
Content for this file to be added

4
quickstart/readme.md Normal file
View File

@ -0,0 +1,4 @@
# Dapr Quickstarts and Samples
- The **[Dapr Samples repo](https://github.com/dapr/samples/blob/master/README.md)** has samples for getting started building applications

View File

@ -2,9 +2,11 @@
Welcome to the documentation repository for Dapr. You can learn about Dapr from the below links. Welcome to the documentation repository for Dapr. You can learn about Dapr from the below links.
- **[Getting Started](/getting-started)** - Set up your environment with Dapr - **[Overview](dapr-overview.md)** - An overview of Dapr and how it enables you to build distributed applications
- **[Quickstarts](/quickstart)** - Quick start guides for developing apps using Dapr - **[Getting Started](/getting-started)** - Set up your environment with Dapr
- **[Quickstarts and Samples](/quickstart)** - Quick start guides and samples for developing apps using Dapr
- **[Concepts](/concepts)** - Core Dapr concepts explained - **[Concepts](/concepts)** - Core Dapr concepts explained
- **[How-Tos](/howto)** - Guides explaining how to accomplish specific tasks with Dapr - **[How-Tos](/howto)** - Guides explaining how to accomplish specific tasks with Dapr
- **[Reference](/reference)** - Detailed reference documentation
- **[Tutorials](/tutorials)** - End to end tutorials developing applications using Dapr - **[Tutorials](/tutorials)** - End to end tutorials developing applications using Dapr
- **[Reference](/reference)** - Detailed reference documentation