Building a Simple PaaS with Sidecars (from Designing Distributed Systems book) in C#

The example which motivated this post comes from the excellent book Designing Distributed Systems by Brendan Burns (co-founder of the Kubernetes project). By the way, this book is available for free here.

In the book, Brendan Burns shares an exciting use of the  Sidecars pattern.

The sidecar pattern can be used for more than adaptation and monitoring. It can also be used as a means to implement the complete logic for your application in a simplified, modular manner. As an example, imagine building a simple platform as a service (PaaS) built around the git workflow. Once you deploy this PaaS, simply pushing new code up to a Git repository results in that code being deployed to the running servers. We’ll see how the sidecar pattern makes building this PaaS remarkably straightforward.

[..] in the sidecar pattern there are two containers: the main application container and the sidecar. In our simple PaaS application, the main container is a Node.js server that implements a web server. The Node.js server is instrumented so that it automatically reloads the server when new files are updated. This is accomplished with the nodemon tool.

The sidecar container shares a filesystem with the main application container and runs a simple loop that synchronizes the filesystem with an existing Git repository.

Here is a graphic representation available in the book.

My goal was to create this example using core. This source code is available on my GitHub.

Creating a server that “automatically reloads when files are updated.”

I didn’t make an effort to create a sophisticated example. It is just a new project based on the “empty web app” template.

To get it up and running, on docker, I followed the Nate McMaster’s instructions (I strongly recommend you to read these instructions).

Here is the Dockerfile of the application.

FROM microsoft/aspnetcore-build:2.0

WORKDIR /code/app

COPY Application.csproj .
COPY Directory.Build.props .
COPY NuGet.config .

RUN dotnet restore

ENTRYPOINT dotnet watch run

The /code/app directory will be mapped to a host’s volume.

The Sync With Git Sidecar

The logic to sync with Git is the same presented by Brendan Burns.


while true; do
  git pull origin master
  sleep 10

The Dockerfile for the sidecar is also pretty straightforward.

FROM microsoft/aspnetcore-build:2.0


RUN apt-get update && apt-get install -y dos2unix
RUN dos2unix / && apt-get --purge remove -y dos2unix && rm -rf /var/lib/apt/lists/*


Again, the /repo directory will be mapped to a host’s volume (which contains the repository used by the Application container).

The utility dos2unix was used to fix the line endings.


Finally, to get this example running, I created a basic Docker Compose configuration.

version: '3'

    image: application
      context: application
      dockerfile: Dockerfile
      - ./application:/code/app
      - "5000:80"

    image: sidecar
      context: sidecar
      dockerfile: Dockerfile
      - .:/repo

How to test it on your machine

To get it running on your machine (assuming that you already have docker installed):

  1. Fork my repo
  2. Clone the forked repo on your computer
  3. Build it (docker-compose build)
  4. Run (docker-compose up)
  5. Navigate to localhost:5000

Now, when you change the forked repo, the sidecar will pull the updates, and the application container will automatically restart the web app.


Last words

I am not a “container specialist.” So, probably you can find a lot of improvements opportunities. Feel free to give me your feedback. Right?

Compartilhe este insight:

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Elemar Júnior

Sou fundador e CEO da EximiaCo e atuo como tech trusted advisor ajudando diversas empresas a gerar mais resultados através da tecnologia.

Elemar Júnior

Sou fundador e CEO da EximiaCo e atuo como tech trusted advisor ajudando diversas empresas a gerar mais resultados através da tecnologia.

Mais insights para o seu negócio

Veja mais alguns estudos e reflexões que podem gerar alguns insights para o seu negócio:

Mais uma vez, tive o prazer de compartilhar bons momentos com o pessoal do Canal.NET discutindo sobre arquitetura e tecnologia....
When you think about Roslyn source code, you should think about performance-oriented design. I would like to share some performance techniques...
Uma das premissas fundamentais do conceito de contrato social é que nós, como indivíduos livres, abrimos mão do direito natural...
Há alguns anos, cheguei, por acaso, a uma palestra do Simon Sinek no TED. Na época, ele ainda era um...
Como você pode se considerar um profissional se você não sabe se todo seu código funciona? Como você pode saber...
The type EmbeddableDocumentStore is gone. But it does not mean that you have no good options to replace his functionality....