Skip to content

Commit

Permalink
Merge branch 'main' into issue-5798-main
Browse files Browse the repository at this point in the history
  • Loading branch information
@lbussell
lbussell authored Sep 24, 2024
2 parents fa8e9bc + b9bca75 commit c9b368c
Show file tree
Hide file tree
Showing 26 changed files with 122 additions and 102 deletions.
44 changes: 22 additions & 22 deletions README.sdk.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -71,13 +71,13 @@ Tags | Dockerfile | OS Version
9.0.100-rc.1-alpine3.20-amd64, 9.0-alpine3.20-amd64, 9.0-alpine-amd64, 9.0.100-rc.1-alpine3.20, 9.0-alpine3.20, 9.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/alpine3.20/amd64/Dockerfile) | Alpine 3.20
9.0.100-rc.1-noble-amd64, 9.0-noble-amd64, 9.0.100-rc.1-noble, 9.0-noble | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/noble/amd64/Dockerfile) | Ubuntu 24.04
9.0.100-rc.1-azurelinux3.0-amd64, 9.0-azurelinux3.0-amd64, 9.0.100-rc.1-azurelinux3.0, 9.0-azurelinux3.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/azurelinux3.0/amd64/Dockerfile) | Azure Linux 3.0
8.0.401-1-bookworm-slim-amd64, 8.0-bookworm-slim-amd64, 8.0.401-1-bookworm-slim, 8.0-bookworm-slim, 8.0.401-1, 8.0, latest | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/bookworm-slim/amd64/Dockerfile) | Debian 12
8.0.401-1-alpine3.20-amd64, 8.0-alpine3.20-amd64, 8.0-alpine-amd64, 8.0.401-1-alpine3.20, 8.0-alpine3.20, 8.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.20/amd64/Dockerfile) | Alpine 3.20
8.0.401-1-alpine3.19-amd64, 8.0-alpine3.19-amd64, 8.0.401-1-alpine3.19, 8.0-alpine3.19 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.19/amd64/Dockerfile) | Alpine 3.19
8.0.401-1-noble-amd64, 8.0-noble-amd64, 8.0.401-1-noble, 8.0-noble | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/noble/amd64/Dockerfile) | Ubuntu 24.04
8.0.401-1-jammy-amd64, 8.0-jammy-amd64, 8.0.401-1-jammy, 8.0-jammy | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/jammy/amd64/Dockerfile) | Ubuntu 22.04
8.0.401-1-azurelinux3.0-amd64, 8.0-azurelinux3.0-amd64, 8.0.401-1-azurelinux3.0, 8.0-azurelinux3.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/azurelinux3.0/amd64/Dockerfile) | Azure Linux 3.0
8.0.401-1-cbl-mariner2.0-amd64, 8.0-cbl-mariner2.0-amd64, 8.0.401-1-cbl-mariner2.0, 8.0-cbl-mariner2.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/cbl-mariner2.0/amd64/Dockerfile) | CBL-Mariner 2.0
8.0.402-bookworm-slim-amd64, 8.0-bookworm-slim-amd64, 8.0.402-bookworm-slim, 8.0-bookworm-slim, 8.0.402, 8.0, latest | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/bookworm-slim/amd64/Dockerfile) | Debian 12
8.0.402-alpine3.20-amd64, 8.0-alpine3.20-amd64, 8.0-alpine-amd64, 8.0.402-alpine3.20, 8.0-alpine3.20, 8.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.20/amd64/Dockerfile) | Alpine 3.20
8.0.402-alpine3.19-amd64, 8.0-alpine3.19-amd64, 8.0.402-alpine3.19, 8.0-alpine3.19 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.19/amd64/Dockerfile) | Alpine 3.19
8.0.402-noble-amd64, 8.0-noble-amd64, 8.0.402-noble, 8.0-noble | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/noble/amd64/Dockerfile) | Ubuntu 24.04
8.0.402-jammy-amd64, 8.0-jammy-amd64, 8.0.402-jammy, 8.0-jammy | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/jammy/amd64/Dockerfile) | Ubuntu 22.04
8.0.402-azurelinux3.0-amd64, 8.0-azurelinux3.0-amd64, 8.0.402-azurelinux3.0, 8.0-azurelinux3.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/azurelinux3.0/amd64/Dockerfile) | Azure Linux 3.0
8.0.402-cbl-mariner2.0-amd64, 8.0-cbl-mariner2.0-amd64, 8.0.402-cbl-mariner2.0, 8.0-cbl-mariner2.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/cbl-mariner2.0/amd64/Dockerfile) | CBL-Mariner 2.0
6.0.425-1-bookworm-slim-amd64, 6.0-bookworm-slim-amd64, 6.0.425-1-bookworm-slim, 6.0-bookworm-slim | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/bookworm-slim/amd64/Dockerfile) | Debian 12
6.0.425-1-bullseye-slim-amd64, 6.0-bullseye-slim-amd64, 6.0.425-1-bullseye-slim, 6.0-bullseye-slim, 6.0.425-1, 6.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/bullseye-slim/amd64/Dockerfile) | Debian 11
6.0.425-1-alpine3.20-amd64, 6.0-alpine3.20-amd64, 6.0-alpine-amd64, 6.0.425-1-alpine3.20, 6.0-alpine3.20, 6.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/alpine3.20/amd64/Dockerfile) | Alpine 3.20
Expand All @@ -94,13 +94,13 @@ Tags | Dockerfile | OS Version
9.0.100-rc.1-alpine3.20-arm64v8, 9.0-alpine3.20-arm64v8, 9.0-alpine-arm64v8, 9.0.100-rc.1-alpine3.20, 9.0-alpine3.20, 9.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/alpine3.20/arm64v8/Dockerfile) | Alpine 3.20
9.0.100-rc.1-noble-arm64v8, 9.0-noble-arm64v8, 9.0.100-rc.1-noble, 9.0-noble | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/noble/arm64v8/Dockerfile) | Ubuntu 24.04
9.0.100-rc.1-azurelinux3.0-arm64v8, 9.0-azurelinux3.0-arm64v8, 9.0.100-rc.1-azurelinux3.0, 9.0-azurelinux3.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/azurelinux3.0/arm64v8/Dockerfile) | Azure Linux 3.0
8.0.401-1-bookworm-slim-arm64v8, 8.0-bookworm-slim-arm64v8, 8.0.401-1-bookworm-slim, 8.0-bookworm-slim, 8.0.401-1, 8.0, latest | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/bookworm-slim/arm64v8/Dockerfile) | Debian 12
8.0.401-1-alpine3.20-arm64v8, 8.0-alpine3.20-arm64v8, 8.0-alpine-arm64v8, 8.0.401-1-alpine3.20, 8.0-alpine3.20, 8.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.20/arm64v8/Dockerfile) | Alpine 3.20
8.0.401-1-alpine3.19-arm64v8, 8.0-alpine3.19-arm64v8, 8.0.401-1-alpine3.19, 8.0-alpine3.19 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.19/arm64v8/Dockerfile) | Alpine 3.19
8.0.401-1-noble-arm64v8, 8.0-noble-arm64v8, 8.0.401-1-noble, 8.0-noble | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/noble/arm64v8/Dockerfile) | Ubuntu 24.04
8.0.401-1-jammy-arm64v8, 8.0-jammy-arm64v8, 8.0.401-1-jammy, 8.0-jammy | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/jammy/arm64v8/Dockerfile) | Ubuntu 22.04
8.0.401-1-azurelinux3.0-arm64v8, 8.0-azurelinux3.0-arm64v8, 8.0.401-1-azurelinux3.0, 8.0-azurelinux3.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/azurelinux3.0/arm64v8/Dockerfile) | Azure Linux 3.0
8.0.401-1-cbl-mariner2.0-arm64v8, 8.0-cbl-mariner2.0-arm64v8, 8.0.401-1-cbl-mariner2.0, 8.0-cbl-mariner2.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/cbl-mariner2.0/arm64v8/Dockerfile) | CBL-Mariner 2.0
8.0.402-bookworm-slim-arm64v8, 8.0-bookworm-slim-arm64v8, 8.0.402-bookworm-slim, 8.0-bookworm-slim, 8.0.402, 8.0, latest | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/bookworm-slim/arm64v8/Dockerfile) | Debian 12
8.0.402-alpine3.20-arm64v8, 8.0-alpine3.20-arm64v8, 8.0-alpine-arm64v8, 8.0.402-alpine3.20, 8.0-alpine3.20, 8.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.20/arm64v8/Dockerfile) | Alpine 3.20
8.0.402-alpine3.19-arm64v8, 8.0-alpine3.19-arm64v8, 8.0.402-alpine3.19, 8.0-alpine3.19 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.19/arm64v8/Dockerfile) | Alpine 3.19
8.0.402-noble-arm64v8, 8.0-noble-arm64v8, 8.0.402-noble, 8.0-noble | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/noble/arm64v8/Dockerfile) | Ubuntu 24.04
8.0.402-jammy-arm64v8, 8.0-jammy-arm64v8, 8.0.402-jammy, 8.0-jammy | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/jammy/arm64v8/Dockerfile) | Ubuntu 22.04
8.0.402-azurelinux3.0-arm64v8, 8.0-azurelinux3.0-arm64v8, 8.0.402-azurelinux3.0, 8.0-azurelinux3.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/azurelinux3.0/arm64v8/Dockerfile) | Azure Linux 3.0
8.0.402-cbl-mariner2.0-arm64v8, 8.0-cbl-mariner2.0-arm64v8, 8.0.402-cbl-mariner2.0, 8.0-cbl-mariner2.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/cbl-mariner2.0/arm64v8/Dockerfile) | CBL-Mariner 2.0
6.0.425-1-bookworm-slim-arm64v8, 6.0-bookworm-slim-arm64v8, 6.0.425-1-bookworm-slim, 6.0-bookworm-slim | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/bookworm-slim/arm64v8/Dockerfile) | Debian 12
6.0.425-1-bullseye-slim-arm64v8, 6.0-bullseye-slim-arm64v8, 6.0.425-1-bullseye-slim, 6.0-bullseye-slim, 6.0.425-1, 6.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/bullseye-slim/arm64v8/Dockerfile) | Debian 11
6.0.425-1-alpine3.20-arm64v8, 6.0-alpine3.20-arm64v8, 6.0-alpine-arm64v8, 6.0.425-1-alpine3.20, 6.0-alpine3.20, 6.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/alpine3.20/arm64v8/Dockerfile) | Alpine 3.20
Expand All @@ -116,10 +116,10 @@ Tags | Dockerfile | OS Version
9.0.100-rc.1-bookworm-slim-arm32v7, 9.0-bookworm-slim-arm32v7, 9.0.100-rc.1-bookworm-slim, 9.0-bookworm-slim, 9.0.100-rc.1, 9.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/bookworm-slim/arm32v7/Dockerfile) | Debian 12
9.0.100-rc.1-alpine3.20-arm32v7, 9.0-alpine3.20-arm32v7, 9.0-alpine-arm32v7, 9.0.100-rc.1-alpine3.20, 9.0-alpine3.20, 9.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/alpine3.20/arm32v7/Dockerfile) | Alpine 3.20
9.0.100-rc.1-noble-arm32v7, 9.0-noble-arm32v7, 9.0.100-rc.1-noble, 9.0-noble | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/noble/arm32v7/Dockerfile) | Ubuntu 24.04
8.0.401-1-bookworm-slim-arm32v7, 8.0-bookworm-slim-arm32v7, 8.0.401-1-bookworm-slim, 8.0-bookworm-slim, 8.0.401-1, 8.0, latest | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/bookworm-slim/arm32v7/Dockerfile) | Debian 12
8.0.401-1-alpine3.20-arm32v7, 8.0-alpine3.20-arm32v7, 8.0-alpine-arm32v7, 8.0.401-1-alpine3.20, 8.0-alpine3.20, 8.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.20/arm32v7/Dockerfile) | Alpine 3.20
8.0.401-1-alpine3.19-arm32v7, 8.0-alpine3.19-arm32v7, 8.0.401-1-alpine3.19, 8.0-alpine3.19 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.19/arm32v7/Dockerfile) | Alpine 3.19
8.0.401-1-jammy-arm32v7, 8.0-jammy-arm32v7, 8.0.401-1-jammy, 8.0-jammy | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/jammy/arm32v7/Dockerfile) | Ubuntu 22.04
8.0.402-bookworm-slim-arm32v7, 8.0-bookworm-slim-arm32v7, 8.0.402-bookworm-slim, 8.0-bookworm-slim, 8.0.402, 8.0, latest | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/bookworm-slim/arm32v7/Dockerfile) | Debian 12
8.0.402-alpine3.20-arm32v7, 8.0-alpine3.20-arm32v7, 8.0-alpine-arm32v7, 8.0.402-alpine3.20, 8.0-alpine3.20, 8.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.20/arm32v7/Dockerfile) | Alpine 3.20
8.0.402-alpine3.19-arm32v7, 8.0-alpine3.19-arm32v7, 8.0.402-alpine3.19, 8.0-alpine3.19 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/alpine3.19/arm32v7/Dockerfile) | Alpine 3.19
8.0.402-jammy-arm32v7, 8.0-jammy-arm32v7, 8.0.402-jammy, 8.0-jammy | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/jammy/arm32v7/Dockerfile) | Ubuntu 22.04
6.0.425-1-bookworm-slim-arm32v7, 6.0-bookworm-slim-arm32v7, 6.0.425-1-bookworm-slim, 6.0-bookworm-slim | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/bookworm-slim/arm32v7/Dockerfile) | Debian 12
6.0.425-1-bullseye-slim-arm32v7, 6.0-bullseye-slim-arm32v7, 6.0.425-1-bullseye-slim, 6.0-bullseye-slim, 6.0.425-1, 6.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/bullseye-slim/arm32v7/Dockerfile) | Debian 11
6.0.425-1-alpine3.20-arm32v7, 6.0-alpine3.20-arm32v7, 6.0-alpine-arm32v7, 6.0.425-1-alpine3.20, 6.0-alpine3.20, 6.0-alpine | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/alpine3.20/arm32v7/Dockerfile) | Alpine 3.20
Expand All @@ -132,31 +132,31 @@ Tags | Dockerfile | OS Version
Tag | Dockerfile
---------| ---------------
9.0.100-rc.1-nanoserver-ltsc2022, 9.0-nanoserver-ltsc2022 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/nanoserver-ltsc2022/amd64/Dockerfile)
8.0.401-1-nanoserver-ltsc2022, 8.0-nanoserver-ltsc2022 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/nanoserver-ltsc2022/amd64/Dockerfile)
8.0.402-nanoserver-ltsc2022, 8.0-nanoserver-ltsc2022 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/nanoserver-ltsc2022/amd64/Dockerfile)
6.0.425-1-nanoserver-ltsc2022, 6.0-nanoserver-ltsc2022, 6.0.425-1, 6.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/nanoserver-ltsc2022/amd64/Dockerfile)

### Windows Server Core 2022 amd64 Tags

Tag | Dockerfile
---------| ---------------
9.0.100-rc.1-windowsservercore-ltsc2022, 9.0-windowsservercore-ltsc2022 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/windowsservercore-ltsc2022/amd64/Dockerfile)
8.0.401-1-windowsservercore-ltsc2022, 8.0-windowsservercore-ltsc2022 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/windowsservercore-ltsc2022/amd64/Dockerfile)
8.0.402-windowsservercore-ltsc2022, 8.0-windowsservercore-ltsc2022 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/windowsservercore-ltsc2022/amd64/Dockerfile)
6.0.425-1-windowsservercore-ltsc2022, 6.0-windowsservercore-ltsc2022 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/windowsservercore-ltsc2022/amd64/Dockerfile)

### Nano Server, version 1809 amd64 Tags

Tag | Dockerfile
---------| ---------------
9.0.100-rc.1-nanoserver-1809, 9.0-nanoserver-1809 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/nanoserver-1809/amd64/Dockerfile)
8.0.401-1-nanoserver-1809, 8.0-nanoserver-1809 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/nanoserver-1809/amd64/Dockerfile)
8.0.402-nanoserver-1809, 8.0-nanoserver-1809 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/nanoserver-1809/amd64/Dockerfile)
6.0.425-1-nanoserver-1809, 6.0-nanoserver-1809, 6.0.425-1, 6.0 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/nanoserver-1809/amd64/Dockerfile)

### Windows Server Core 2019 amd64 Tags

Tag | Dockerfile
---------| ---------------
9.0.100-rc.1-windowsservercore-ltsc2019, 9.0-windowsservercore-ltsc2019 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/windowsservercore-ltsc2019/amd64/Dockerfile)
8.0.401-1-windowsservercore-ltsc2019, 8.0-windowsservercore-ltsc2019 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/windowsservercore-ltsc2019/amd64/Dockerfile)
8.0.402-windowsservercore-ltsc2019, 8.0-windowsservercore-ltsc2019 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/8.0/windowsservercore-ltsc2019/amd64/Dockerfile)
6.0.425-1-windowsservercore-ltsc2019, 6.0-windowsservercore-ltsc2019 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/6.0/windowsservercore-ltsc2019/amd64/Dockerfile)
<!--End of generated tags-->

Expand Down
43 changes: 31 additions & 12 deletions documentation/supported-tags.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -142,36 +142,55 @@ These "floating version" `latest` tag references an image with the latest `Major

The following policies are used for the tag patterns we use.

### Fixed version tags
### .NET Versions

"Fixed version" tags reference an image with a specific `Major.Minor.Patch` .NET version.
Each .NET release goes through multiple [support phases](https://github.com/dotnet/core/blob/main/release-policies.md#support-phases), with varying support levels.

While a new .NET version is in preview, both the fixed and floating version tags have a special preview suffix.
When a .NET version moves from Preview to Release Candidate, the `-preview` suffix is dropped from the floating version tags.
This is because .NET Release Candidates are supported for production use under a "Go-Live" license, so the preview label no longer applies.
In this case, fixed versions will use an `-rc.<RC Number>` suffix since the patch version would otherwise clash with the GA release (e.g. `9.0.0`).

| Support phase | Fixed version tag format | Floating version tag format |
| --- | --- | --- |
| **Preview** | `<Major>.<Minor>.<Patch>-preview.<PreviewVersion>` | `<Major>.<Minor>-preview` |
| **Release Candidate (Go-Live)** | `<Major>.<Minor>.<Patch>-rc.<ReleaseCandidateVersion>` | `<Major>.<Minor>` |
| **Active and Maintenance** | `<Major>.<Minor>.<Patch>` | `<Major>.<Minor>` |

See [.NET's release policies](https://github.com/dotnet/core/blob/main/release-policies.md) for more details.

#### Fixed version tags

"Fixed version" tags reference an image with a specific .NET patch version.

Examples:

- `6.0.32`
- `8.0.7-alpine3.20`
- `9.0.0-preview.7`
- `9.0.0-rc.1`

> [!NOTE]
>
> - These tags are considered _fixed tags_ since they reference a specific .NET patch version.
> - They are updated in response to base image updates (like a Debian base image) for the supported life of the image (typically one month).
> - The .NET components within the image will not be updated.
> - _Fixed version tags_ are updated according to the [image update policy](../README.md#image-update-policy) for the supported life of the image (typically one month).
> - _Fixed version tags_ guarantee that the version of .NET in the image will never change.
> - At times, components of .NET images like PowerShell or MinGit may require updates out of band with .NET releases in order to fix critical bugs or vulnerabilities. If this happens, new images will be created with a `-1` suffix appended to the fixed tag so that you can roll back to the previous fixed tag if necessary. The same practice will repeat itself if necessary (with `-2` and then `-3` tags).
### Floating version tags
#### Floating version tags

"Floating version" tags references an image with a specific `Major.Minor` .NET version, but float on patch updates.

Examples:

- `6.0`
- `8.0-alpine3.20`
- `8.0`
- `9.0-alpine3.20`
- `9.0-preview`
- `9.0-preview-noble`

> [!NOTE]
>
> - These tags are considered _floating tags_ since they do not reference a specific .NET patch version.
> - They are updated in response to base image updates (like a Debian base image) for the supported life of the .NET release.
> - The .NET components within the image will be updated, which typically occurs on Patch Tuesday.
> - _Floating version tags_ always point to the latest patch version of a given `Major.Minor` .NET release.
> - _Floating version tags_ are updated according to the [image update policy](../README.md#image-update-policy) for the supported life of the .NET release or until the OS they are based on reaches EOL, whichever is sooner. We will post an [Announcement](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) when we remove or stop supporting images for any reason.
### OS tags and base image updates

Expand All @@ -184,7 +203,7 @@ Examples:

> [!NOTE]
>
> - These tags are updated in response to base image updates (like an Ubuntu base image) for the supported life of the .NET release.
> - These tags are updated in response to base image updates (like an Ubuntu base image) for the supported life of the .NET release or until the OS they are based on reaches EOL, whichever is sooner.
> - Digest pinning is required to request a specific patch of an operating system (e.g. `mcr.microsoft.com/dotnet/runtime@sha256:4d3d5a5131a0621509ab8a75f52955f2d0150972b5c5fb918e2e59d4cb9a9823`).
> - If an image is only available for one operating system, then the operating system will be omitted from the tag.
> - For [Debian](https://en.wikipedia.org/wiki/Debian_version_history) and [Ubuntu](https://en.wikipedia.org/wiki/Ubuntu_version_history) images, release codenames are used instead of version numbers.
Expand Down
Loading

0 comments on commit c9b368c

Please sign in to comment.