Upgrading Guide

In this page we will show the steps for upgrading the .NET version.

Files located in dotnet root folder

• Update global.json with latest .NET version.
• Update defaults.props with latest .NET version.

<TargetFramework>net8.0</TargetFramework>

• Update Directory.Packages.props. Here we need to update each package version one by one. At the moment dotnet-outdated does not support central packages management so we cannot use it, but it may support it in the future. For now, we recommend using the NuGet page for checking the packages version and updating them.

Files located in dotnet child folders

• Update dotnet-tools.json located at dotnet/.config folder with the latest packages version.

Docker files

Now we should update all places were .NET docker images are used.

• Update Dockerfile.services located at dotnet/docker. Here we need to update the SDK version and the ASP .NET version.

FROM itsynch.azurecr.io/dotnet/sdk:8.0.203-alpine3.19 as builder

FROM itsynch.azurecr.io/dotnet/aspnet:8.0.3-alpine3.19 as runtime

Important

Take into account that the SDK version number differs from the ASP .NET one. In the example above, the SDK version 8.0.203 corresponds to the runtime version 8.0.3. You may check which versions are the correct before hand.

• Update all custom Dockerfile in the repo for the services that uses custom docker images, for example: Html2Pdf service.

Update Azure Image Registry

In order to download the images from ITsynch Registry we need to upload the corresponding newer versions.

We can use this command to do so:

az acr import \
  --name itsynch \
  -g itsynch-suite-shared-infrastructure \
  --subscription itsynch-suite \
  --source mcr.microsoft.com/dotnet/sdk:8.0.201-alpine3.19 \
  --image dotnet/sdk:8.0.201-alpine3.19

Important

We need to upload the alpine-based and debian-based SDK and ASP .NET images. For example for SDK image, Alpine-based: sdk:8.0.201-alpine3.19 and Debian-based: sdk:8.0.201.