For this workshop, you’ll be using many tools to build and deploy your microservices. To make it more convenient and save time, you’ll have 3 different options to work on the project:

  • You can work locally using your preferred IDE, but you will need to install all the tools manually. Since it can take some time, we recommend you to prepare your environment before the workshop using the instructions in the next section.

  • You can work directly in GitHub Codespaces, without having to install anything on your machine. You just need a GitHub account and a modern browser, and you’re ready to go.

  • You can work locally using VS Code, Docker and Dev Containers, so you have a pre-configured development environment. Make sure you have Docker, VS Code and this extension installed on your machine, and you’re ready.

Setting Up Your Development Environment Manually

If you decide to setup your environment yourself, you will need to install the following tools:

Java 17

Get OpenJDK

Maven 3.9.x

Get Maven

Docker 20.x

Get Docker

Azure CLI

Get Azure CLI

Git

https://git-scm.com

GitHub account

https://github.com/join

Azure account

Get a free Azure account

A code editor, such as VS Code, Eclipse, or IntelliJ

Get VS Code

cURL (or any other HTTP client)

Get cURL

GraalVM (optional)

Get GraalVM

jq (optional)

Get jq

You can test your installation by running the following commands:

java -version
mvn --version
docker --version
az --version
git --version
curl --version
jq --version

If everything is installed correctly, you should see the version of each tool.

Warning

If you are on Windows, you will need to run bash commands. You have multiples way to do that:

  • Use the Git Bash command line that comes with Git. Open the start menu, and search for "Git Bash".

  • Install the Windows Subsystem for Linux (WSL) with a Linux distribution (eg. Ubuntu). You can follow the instructions here.

  • Use Visual Studio Code with the Dev Containers setup (see below).