Clone repository

• SSH: git clone [email protected]:Arthyon/microservice-poc.git
• HTTPS: git clone https://github.com/Arthyon/microservice-poc.git

Install tools

To run this PoC as intended you need two things:

Visual Studio Code

It is of course possible to use any editor, but the debugging capability in this repo is written for VSCode. You have to figure out how to debug node and .Net in docker for your editor of choice.

Follow this guide for your OS to set up VSCode. Note for Arch-users: I have not been able to get all features to work correctly using the OSS version of code from the repositories. Use the AUR-package for the MS-branded version, visual-studio-code-bin

Optional extensions (install from inside the editor):

• C# will give proper intellisense for the .Net-projects
• Docker provides syntax highlighting to Dockerfiles

Since we're using a non-standard naming for development dockerfiles, you can add this to the user settings to still get syntax highlighting: "files.associations": { "Dockerfile-dev": "dockerfile" }

Docker

Follow the official guide.

Note for windows-users

This PoC uses volume mounting while developing to reduce the need for image rebuilding. To get this working, you need to share the drive you cloned the repository to. Follow this guide to share the whole drive.

You will most likely encounter issues when mounting the drive. Check out this section of the troubleshooting-guide for help.

Test setup

Open a terminal and run docker. If this prints a list of commands, you're good to go. Refer to the section Development workflow to start developing or Architecture overview for a description of the architecture.