Skip to content

Commit

Permalink
Merge pull request #411 from DuendeSoftware/anders/upgrade_ga
Browse files Browse the repository at this point in the history
Upgrade guide for v7 GA
  • Loading branch information
leastprivilege authored Jan 25, 2024
2 parents 31e24b4 + 3ec43a3 commit 1245053
Show file tree
Hide file tree
Showing 5 changed files with 33 additions and 18 deletions.
9 changes: 3 additions & 6 deletions IdentityServer/v6/docs/content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,11 @@ weight: 1
# Duende IdentityServer v6 Documentation
The most flexible & standards-compliant OpenID Connect and OAuth 2.0 framework for ASP.NET Core.

{{% notice note %}}
This is the documentation for version 6.x. You can find the v5.x documentation [here](https://docs.duendesoftware.com/identityserver/v5) and the v7.x documentation [here](https://docs.duendesoftware.com/identityserver/v7).
{{% notice info %}}
This is the version 6 documention. Version 6.x is compatible with .NET 6 and .NET 7. Please use [v7.x](https://docs.duendesoftware.com/identityserver/v7) for .NET 8.
{{% /notice %}}

{{% notice note %}}
Version 6.x is supported on .NET 6 and .NET 7. Version 6.x is supported until November 12, 2024 when .NET 6 support ends.
Version 6.x is supported until November 12, 2024 when .NET 6 support ends.
{{% /notice %}}

{{% notice info %}}
Version 6.x is not supported on .NET 8. Please use [v7.x](https://docs.duendesoftware.com/identityserver/v7) for .NET 8.
{{% /notice %}}
4 changes: 0 additions & 4 deletions IdentityServer/v7/docs/content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,6 @@ weight: 1
# Duende IdentityServer v7 Documentation
The most flexible & standards-compliant OpenID Connect and OAuth 2.0 framework for ASP.NET Core.

{{% notice info %}}
Version 7.x is available as preview and not supported for production use. The RTM release is planned for January 2024.
{{% /notice %}}

{{% notice note %}}
This is the documentation for version 7.x. You can find the v6.x documentation [here](https://docs.duendesoftware.com/identityserver/v6).
{{% /notice %}}
28 changes: 27 additions & 1 deletion IdentityServer/v7/docs/content/upgrades/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,32 @@ chapter = true

# Upgrading

Here is a list of upgrade guides.
Upgrading to a new IdentityServer version is done by updating the Nuget package and handling any breaking
changes. If you are using the Entity Framework based stores you might also need to apply database schema
updates.

## Upgrading from version 6 to version 7

#### Upgrading from version 6.0
If you use the Entity Framework based stores you need to apply the upgrade and database migrations from
[6.0 - 6.1](v6.0_to_v6.1) first. Then continue on Upgrading from version 6.2.

#### Upgrading from version 6.1
Follow the guide from 6.2.

#### Upgrading from version 6.2
If you use the Entity Framework based stores you need to apply the upgrade and database migrations from
[6.2 - 6.3](v6.2_to_v6.3).

6.3 came with some breaking changes. Review the list in the upgrade guide to verify if any of them affect
your deployments.

Then continue on Upgrading from version 6.3.

#### Upgrading from version 6.3
Follow the [upgrade guide version 6.3 - 7.0](v6.3_to_v7.0)

## All upgrade guides
Here is a list of all upgrade guides.

{{%children style="h4" /%}}
8 changes: 2 additions & 6 deletions IdentityServer/v7/docs/content/upgrades/v6.3_to_v7.0.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,10 @@
---
title: "Duende IdentityServer v6.3 to v7.0"
weight: 40
weight: 30
---

{{% notice note %}}
This upgrade guide is work in progress based on the currently available [release candidate of v7.0](https://github.com/DuendeSoftware/IdentityServer/releases/tag/7.0.0-rc.1).
{{% /notice %}}

## What's New
IdentityServer v7.0 includes support for .NET 8, pushed authorization requests, OpenTelemetry metrics, cleanup job improvements, and many other fixes and enhancements. Please see our [release notes](https://github.com/DuendeSoftware/IdentityServer/releases/tag/7.0.0-rc.1) for complete details.
IdentityServer v7.0 includes support for .NET 8, pushed authorization requests, OpenTelemetry metrics, cleanup job improvements, and many other fixes and enhancements. Please see our [release notes](https://github.com/DuendeSoftware/IdentityServer/releases/tag/7.0.0) for complete details.

## Step 1: Update .NET Version
In your IdentityServer host project, update the version of the .NET framework. For example in your project file:
Expand Down
2 changes: 1 addition & 1 deletion root/index.html
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
<script>
window.location.assign("/identityserver/v6")
window.location.assign("/identityserver/v7")
</script>

0 comments on commit 1245053

Please sign in to comment.