diff --git a/README.md b/README.md index e26b86d40..68d7640d0 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,11 @@ This reference application is cross-platform either in the server and client sid

-Important Note on Database Servers/Containers: In this solution, the SQL databases are automatically deployed with sample data into a single SQL Server for Linux container (a single shared Docker container for SQL databases) so the whole solution can be up and running without any dependency in the cloud or server. A similar case is defined in regards Redis cache running as a container. However, in a real production environment it is recommended to have persistance (SQL Server and Redis) in HA services like Azure SQL Database, Redis as a service or any other clustering system. If you want to configure this solution like that, you'll just need to change the connection strings once you have set up the servers in the cloud or on-premises. + +> ### Important Note on Database Servers/Containers +> In this solution's current configuration for a development environment, the SQL databases are automatically deployed with sample data into a single SQL Server for Linux container (a single shared Docker container for SQL databases) so the whole solution can be up and running without any dependency in the cloud or server. Each database could also be deployed as a single Docker container, but then you'd need more then 8GB or memory RAM in your development machine in order to be able to run 3 SQL Server Docker containers in your Docker Linux host in "Docker for Windows" or "Docker for Mac" development environments. +>

A similar case is defined in regards Redis cache running as a container for the development environment. +>

However, in a real production environment it is recommended to have persistance (SQL Server and Redis) in HA services like Azure SQL Database, Redis as a service or any other clustering system. If you want to change to a production configuration, you'll just need to change the connection strings once you have set up the servers in HA cloud or on-premises. ## Related documentation and guidance While developing this reference application, we've been creating a reference Guide/eBook named "Architecting and Developing Containerized and Microservice based .NET Applications" which explains in detail how to develop this kind of architectural style (microservices, Docker containers, Domain-Driven Design for certain microservices) plus other simpler architectural styles, like monolithic that can also live as Docker containers. @@ -67,13 +71,13 @@ The app was also partially tested on "Docker for Mac" using a development MacOS WINDOWS DEV MACHINE - Visual Studio 2015 with latest Update -- .NET Core 1.0 (Including ASP.NET Core and VS Tooling) +- .NET Core 1.1 setup (Including ASP.NET Core and VS Tooling) - Bower and Gulp as global installs (See steps below) - Docker for Windows MAC DEV MACHINE - Visual Studio Code -- .NET Core 1.0 for Mac +- .NET Core 1.1 for Mac - setup - Bower and Gulp as global installs (See steps below) - Docker for Mac diff --git a/docs/architecting-and-developing-containerized-and-microservice-based-net-applications-ebook-early-draft.pdf b/docs/architecting-and-developing-containerized-and-microservice-based-net-applications-ebook-early-draft.pdf index 8e92a46f0..198fccab9 100644 Binary files a/docs/architecting-and-developing-containerized-and-microservice-based-net-applications-ebook-early-draft.pdf and b/docs/architecting-and-developing-containerized-and-microservice-based-net-applications-ebook-early-draft.pdf differ diff --git a/img/Multiple-Distributed-Dependencies.png b/img/Multiple-Distributed-Dependencies.png new file mode 100644 index 000000000..c06f7b57a Binary files /dev/null and b/img/Multiple-Distributed-Dependencies.png differ