DevContainer

You want to execute this workshop on your desktop with DevContainers.

A configuration to set the project up in DevContainer is available. You can check it out in the project .devcontainer/devcontainer.json file.

If you want to know more about DevContainers, you can check out this documentation.

You MUST have set up these tools first:

Docker,
An IDE: (IntelliJ IDEA or VSCode).

🛠️ You can validate your environment running these commands:

Docker

$ docker version
    Client:
    Docker Engine -Community
    Version:
    27.4.1
    API version:1.47
    Go version:go1.22.10
    Git commit:b9d17ea
    Built:Tue Dec 17 15:45:46 2024
    OS/Arch:linux/amd64
    Context:default

Tip

This workshop was tested with:

Rancher Desktop as Docker environment,
IDEs: VSCode.

VSCode Open Project with DevContainer

You can use this command in VSCode (CTRL-SHIFT-P):

Dev Containers: Clone Repository in Container Volume...
Select GitHub,
Repository name: worldline/observability-workshop

Wait for startup!

It will take some time to the project start, so please be patient.

Before starting the infrastructure, you should wait that VSCode has correctly imported all the Java modules and packages.

Troubleshooting: Gradle or Java error?

If Java state is in “Error” or see some Gradle issues, you can try the following VSCode commands (CTRL-SHIFT-P):

Gradle: Refresh Gradle Projects View
Java: Clean Java Language Server Workspace