Azure: usunięte pakiety integracji platformy Azure z prefiksem Microsoft

Następujące Microsoft.* pakiety, które zapewniają integrację między zestawami ASP.NET Core i Azure SDK, nie są uwzględniane w ASP.NET Core 5.0:

• Microsoft.Extensions.Configuration.AzureKeyVault, który integruje usługę Azure Key Vault z systemem konfiguracji.
• Microsoft.AspNetCore.DataProtection.AzureKeyVault, który integruje usługę Azure Key Vault z systemem ASP.NET Core Data Protection.
• Microsoft.AspNetCore.DataProtection.AzureStorage, który integruje usługę Azure Blob Storage z systemem ASP.NET Core Data Protection.

Aby omówić ten problem, zobacz dotnet/aspnetcore#19570.

Wprowadzona wersja

5.0 (wersja zapoznawcza 1)

Stare zachowanie

Pakiety Microsoft.* zintegrowane usługi platformy Azure z interfejsami API konfiguracji i ochrony danych.

Nowe zachowanie

Nowe Azure.* pakiety integrują usługi platformy Azure z interfejsami API konfiguracji i ochrony danych.

Przyczyna wprowadzenia zmiany

Wprowadzono zmianę Microsoft.* , ponieważ pakiety były następujące:

• Korzystanie z nieaktualnych wersji zestawu Azure SDK. Proste aktualizacje nie były możliwe, ponieważ nowe wersje zestawu Azure SDK zawierały zmiany powodujące niezgodność.
• Powiązane z harmonogramem wydania platformy .NET Core. Przeniesienie własności pakietów do zespołu zestawu Azure SDK umożliwia aktualizowanie pakietów w miarę aktualizowania zestawu Azure SDK.

Zalecana akcja

W projektach ASP.NET Core 2.1 lub nowszych zastąp stary Microsoft.* nowymi Azure.* pakietami.

Stary	Nowe
Microsoft.AspNetCore.DataProtection.AzureKeyVault	Azure.Extensions.AspNetCore.DataProtection.Keys
Microsoft.AspNetCore.DataProtection.AzureStorage	Azure.Extensions.AspNetCore.DataProtection.Blobs
Microsoft.Extensions.Configuration.AzureKeyVault	Azure.Extensions.AspNetCore.Configuration.Secrets

Nowe pakiety używają nowej wersji zestawu Azure SDK, która zawiera zmiany powodujące niezgodność. Ogólne wzorce użycia są niezmienione. Niektóre przeciążenia i opcje mogą się różnić w celu dostosowania się do zmian w podstawowych interfejsach API zestawu Azure SDK.

Stare pakiety będą:

• Zespół platformy ASP.NET Core może obsługiwać cały okres istnienia platformy .NET Core 2.1 i 3.1.
• Nie należy dołączać do platformy .NET 5.

Podczas uaktualniania projektu do platformy .NET 5 przejdź do Azure.* pakietów w celu zapewnienia obsługi technicznej.

Dotyczy interfejsów API

• AzureKeyVaultConfigurationExtensions.AddAzureKeyVault
• AzureDataProtectionBuilderExtensions.ProtectKeysWithAzureKeyVault
• AzureDataProtectionBuilderExtensions.PersistKeysToAzureBlobStorage