/!\ You just created a new repo from this template :

This is a basic template for any new aspnet microservice in the terranaut project.

Before you start coding there is a few things you need to do :

.env.example

Copy the .env.example file to a .env file.

.devcontainer/compose.yml

To ensure proper functionability of the provided development envrionnement, you need to make sure the other runnig services will be able to see and connect to the dev container :

To do so, change the name of the service (here service_serv) to the exact same name of the service in the compose.yml in the main repo.

This will allow docker DNS resolution to work properly. Other running services that need to connect to this one (mainly the mesage broker and API gateway), won't be aware of the difference between the normal container and the dev container.

If you need to connect your dev container to other service than the message broker :

Feel free to add an external docker network to .devcontainer/compose.yml

nuget.config.example

Rename nuget.config.example to nuget.config. It should stay git ignored since it can contain your forgejo credentials.

Authentication

If your micro service will need Authentication run the following commands to download our Asymmetric Authentication package :

dotnet nuget add source --name Terranaut --username your_username --password your_token --store-password-in-clear-text --configfile nuget.config https://forgejo.asventi.net/api/packages/Terranaut/nuget/index.json

dotnet add package --version 1.0.1 Terranaut.AsymmetricAuthentication

(this README isn't automatically updated so check the last package version).

service.csproj

If you want to rename your service, just change the name of service.csproj to {your_service}.csproj