Aktualizowanie wersji stosu języka w usłudze Azure Functions

Artykuł
10/15/2024

Obsługa dowolnego stosu językowego w usłudze Azure Functions jest ograniczona do określonych wersji. Gdy nowe wersje staną się dostępne, możesz zaktualizować aplikacje, aby korzystały z ich funkcji. Wsparcie w usłudze Functions może również zakończyć się dla starszych wersji, zwykle dostosowane do osi czasu zakończenia wsparcia dla społeczności. Aby uzyskać szczegółowe informacje, zobacz zasady obsługi środowiska uruchomieniowego języka. Aby upewnić się, że aplikacje będą nadal otrzymywać pomoc techniczną, postępuj zgodnie z instrukcjami opisanymi w tym artykule, aby zaktualizować je do najnowszych dostępnych wersji.

Sposób aktualizowania aplikacji funkcji zależy od:

Język używany do tworzenia funkcji; Pamiętaj, aby wybrać język programowania w górnej części artykułu.
System operacyjny, na którym działa aplikacja na platformie Azure: Windows lub Linux.
Plan hostingu.

Uwaga

W tym artykule pokazano, jak zaktualizować wersję aplikacji .NET przy użyciu izolowanego modelu procesu roboczego. Aplikacje działające w starszych wersjach platformy .NET z modelem procesowym mogą zostać zaktualizowane do docelowej platformy .NET 8 lub migrować z modelu procesu do izolowanego modelu roboczego.

Przygotowanie do aktualizacji

Przed zaktualizowaniem konfiguracji stosu dla aplikacji funkcji na platformie Azure należy wykonać następujące zadania:

1. Zweryfikuj funkcje lokalnie

Upewnij się, że kod funkcji jest testowy i weryfikowany lokalnie w nowej wersji docelowej.

Wykonaj następujące kroki, aby zaktualizować projekt na komputerze lokalnym:

Upewnij się, że zainstalowano docelową wersję zestawu .NET SDK.

Jeśli używasz wersji zapoznawczej, zapoznaj się ze wskazówkami dotyczącymi funkcji dla wersji zapoznawczej platformy .NET, aby upewnić się, że wersja jest obsługiwana. Dodatkowe kroki mogą być wymagane w przypadku wersji zapoznawczych platformy .NET.
Zaktualizuj odwołania do najnowszych wersji: Microsoft.Azure.Functions.Worker i Microsoft.Azure.Functions.Worker.Sdk.
Zaktualizuj platformę docelową projektu do nowej wersji. W przypadku projektów języka C# należy zaktualizować <TargetFramework> element w .csproj pliku. Zobacz Platformy docelowe, aby uzyskać szczegółowe informacje dotyczące wybranej wersji.

Zmiana struktury docelowej projektu może również wymagać zmian w częściach łańcucha narzędzi poza kodem projektu. Na przykład w programie VS Code może być konieczne zaktualizowanie azureFunctions.deploySubpath ustawienia rozszerzenia za pomocą ustawień użytkownika lub pliku projektu .vscode/settings.json . Sprawdź, czy nie ma zależności od wersji struktury, która może istnieć poza kodem projektu, w ramach kroków kompilacji lub potoku ciągłej integracji/ciągłego wdrażania.
Wprowadź wszelkie aktualizacje kodu projektu, które są wymagane przez nową wersję platformy .NET. Sprawdź informacje o wersji, aby uzyskać szczegółowe informacje. Możesz również użyć Asystenta uaktualniania platformy .NET, aby ułatwić aktualizowanie kodu w odpowiedzi na zmiany w różnych wersjach głównych.

Po wprowadzeniu tych zmian ponownie skompiluj projekt i przetestuj go, aby potwierdzić, że aplikacja działa zgodnie z oczekiwaniami.

2. Przejście do najnowszego środowiska uruchomieniowego usługi Functions

Upewnij się, że aplikacja funkcji jest uruchomiona w najnowszej wersji środowiska uruchomieniowego usługi Functions (wersja 4.x). Wersję środowiska uruchomieniowego można określić w witrynie Azure Portal lub przy użyciu interfejsu wiersza polecenia platformy Azure.

Witryna Azure Portal
Interfejs wiersza polecenia platformy Azure

Wykonaj następujące kroki, aby określić wersję środowiska uruchomieniowego usługi Functions:

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie w obszarze Ustawienia.
Wybierz kartę Ustawienia środowiska uruchomieniowego funkcji i sprawdź wartość wersji środowiska uruchomieniowego, aby sprawdzić, czy aplikacja funkcji jest uruchomiona w wersji 4.x środowiska uruchomieniowego usługi Functions (~4).

Użyj tego az functionapp config appsettings list polecenia, aby sprawdzić wersję środowiska uruchomieniowego:

az functionapp config appsettings list --name "<FUNCTION_APP_NAME>" --resource-group "<RESOURCE_GROUP_NAME>"

Ustawienie FUNCTIONS_EXTENSION_VERSION ustawia wersję środowiska uruchomieniowego. Wartość ~4 oznacza, że aplikacja funkcji jest już uruchomiona w najnowszej wersji pomocniczej najnowszej wersji głównej (4.x).

Jeśli musisz najpierw zaktualizować aplikację funkcji do wersji 4.x, zobacz Migrowanie aplikacji z usługi Azure Functions w wersji 1.x do wersji 4.x lub Migrowanie aplikacji z usługi Azure Functions w wersji 3.x do wersji 4.x. Należy postępować zgodnie z instrukcjami w tych artykułach, a nie po prostu zmienić FUNCTIONS_EXTENSION_VERSION ustawienie.

Publikowanie aktualizacji aplikacji

Jeśli aplikacja została zaktualizowana tak, aby działała poprawnie w nowej wersji, opublikuj aktualizacje aplikacji przed zaktualizowaniem konfiguracji stosu dla aplikacji funkcji.

Napiwek

Aby uprościć proces aktualizacji, zminimalizuj przestój funkcji i zapewnij możliwość wycofania, należy opublikować zaktualizowaną aplikację w miejscu przejściowym. Aby uzyskać więcej informacji, zobacz Miejsca wdrożenia usługi Azure Functions.

Podczas publikowania zaktualizowanej aplikacji w miejscu przejściowym upewnij się, że postępuj zgodnie z instrukcjami aktualizacji specyficznymi dla miejsca w pozostałej części tego artykułu. Później zamienisz zaktualizowane miejsce przejściowe na środowisko produkcyjne.

Aktualizowanie konfiguracji stosu

Sposób aktualizowania konfiguracji stosu zależy od tego, czy korzystasz z systemu Windows, czy w systemie Linux na platformie Azure.

W przypadku korzystania z miejsca przejściowego upewnij się, że chcesz zastosować aktualizacje do odpowiedniego miejsca.

Aby zaktualizować wersję języka Java, wykonaj następujące kroki:

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie. W przypadku korzystania z miejsca przejściowego najpierw wybierz określone miejsce.
Na karcie Ustawienia ogólne zaktualizuj wersję języka Java do żądanej wersji.
Wybierz pozycję Zapisz i po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

Aby zaktualizować wersję platformy .NET, wykonaj następujące czynności:

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie. W przypadku korzystania z miejsca przejściowego najpierw wybierz określone miejsce.
Na karcie Ustawienia ogólne zaktualizuj wersję platformy .NET do żądanej wersji.
Wybierz pozycję Zapisz i po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

Aby zaktualizować wersję Node.js, wykonaj następujące czynności:

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie. W przypadku korzystania z miejsca przejściowego najpierw wybierz określone miejsce.
Na karcie Ustawienia ogólne zaktualizuj Node.js wersję do żądanej wersji.
Wybierz pozycję Zapisz i po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj. Ta zmiana spowoduje zaktualizowanie WEBSITE_NODE_DEFAULT_VERSION ustawienia aplikacji.

Aby zaktualizować wersję programu PowerShell, wykonaj następujące czynności:

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie. W przypadku korzystania z miejsca przejściowego najpierw wybierz określone miejsce.
Na karcie Ustawienia ogólne zaktualizuj wersję platformy .NET do żądanej wersji.
Wybierz pozycję Zapisz i po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

Aplikacje języka Python nie są obsługiwane w systemie Windows. Zamiast tego wybierz kartę Linux .

Uwaga

Witryny Azure Portal można używać tylko do aktualizowania aplikacji funkcji w systemie Linux hostowanych w planie Premium lub w ramach dedykowanego planu (App Service). W przypadku aplikacji w systemie Linux hostowanych w planie Zużycie należy zamiast tego użyć interfejsu wiersza polecenia platformy Azure.

Aby zaktualizować wersję języka Java, wykonaj następujące kroki:

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie. W przypadku korzystania z miejsca przejściowego najpierw wybierz określone miejsce.
Na karcie Ustawienia ogólne zaktualizuj wersję języka Java do żądanej wersji.
Wybierz pozycję Zapisz i po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

Aby zaktualizować wersję platformy .NET, wykonaj następujące czynności:

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie. W przypadku korzystania z miejsca przejściowego najpierw wybierz określone miejsce.
Na karcie Ustawienia ogólne zaktualizuj wersję platformy .NET do żądanej wersji.
Wybierz pozycję Zapisz i po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

Aby zaktualizować wersję Node.js, wykonaj następujące czynności:

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie. W przypadku korzystania z miejsca przejściowego najpierw wybierz określone miejsce.
Na karcie Ustawienia ogólne zaktualizuj Node.js wersję do żądanej wersji.
Wybierz pozycję Zapisz i po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj. Ta zmiana spowoduje zaktualizowanie WEBSITE_NODE_DEFAULT_VERSION ustawienia aplikacji.

Aby zaktualizować wersję programu PowerShell, wykonaj następujące czynności:

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie. W przypadku korzystania z miejsca przejściowego najpierw wybierz określone miejsce.
Na karcie Ustawienia ogólne zaktualizuj wersję platformy .NET do żądanej wersji.
Wybierz pozycję Zapisz i po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

Aplikacje języka Python nie są obsługiwane w systemie Windows. Zamiast tego wybierz kartę Linux .

W witrynie Azure Portal znajdź aplikację funkcji i wybierz pozycję Konfiguracja po lewej stronie. W przypadku korzystania z miejsca przejściowego najpierw wybierz określone miejsce.
Na karcie Ustawienia ogólne zaktualizuj wersję języka Python do żądanej wersji.

Uwaga

Nie można zmienić wersji języka Python podczas uruchamiania w planie Zużycie.
Wybierz pozycję Zapisz i po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

Aplikacje języka Python nie są obsługiwane w systemie Windows. Zamiast tego wybierz kartę Linux .

Najpierw użyj az functionapp list-runtimes polecenia , aby wyświetlić obsługiwane wartości wersji języka. Następnie uruchom az functionapp config set polecenie , aby zaktualizować wersję językową aplikacji funkcji:

Uruchom polecenie , az functionapp list-runtimes aby wyświetlić obsługiwane wartości wersji dla platformy .NET w modelu izolowanego procesu roboczego:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'java'].{Version:version}" --output table

az functionapp config set --java-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'dotnet-isolated'].{Version:version}" --output table

Uruchom polecenie , az functionapp config set aby zaktualizować wersję platformy .NET aplikacji funkcji:

az functionapp config set --net-framework-version "v<VERSION>.0" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Najpierw użyj az functionapp list-runtimes polecenia , aby wyświetlić obsługiwane wartości wersji dla stosu języka (Node.js). Następnie uruchom az functionapp config set polecenie , aby zaktualizować Node.js wersję aplikacji funkcji:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'node'].{Version:version}" --output table

az functionapp config appsettings set --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --settings "WEBSITE_NODE_DEFAULT_VERSION=~<VERSION>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'powershell'].{Version:version}" --output table

az functionapp config set --powershell-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

W tym przykładzie zastąp <APP_NAME> wartości i <RESOURCE_GROUP> nazwą aplikacji funkcji i grupy zasobów odpowiednio. Zastąp <VERSION> również obsługiwaną wersją języka, do której aktualizujesz. Jeśli nie używasz miejsca przejściowego, usuń --slot parametr .

Uwaga

Nie można zmienić wersji języka Python podczas uruchamiania w planie Zużycie.

Uruchom polecenie , az functionapp list-runtimes aby wyświetlić obsługiwane linuxFxVersion ustawienie witryny dla używanej wersji językowej:

Uruchom polecenie , az functionapp list-runtimes aby wyświetlić obsługiwane linuxFxVersion ustawienie lokacji dla wersji stosu języka:

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'dotnet-isolated'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'node'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'powershell'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

Uruchom polecenie , az functionapp config set aby zaktualizować ustawienie witryny dla nowej wersji językowej aplikacji funkcji:

Uruchom polecenie , az functionapp config set aby zaktualizować ustawienie witryny dla nowej wersji stosu aplikacji funkcji:

az functionapp config set --linux-fx-version "<LANGUAGE|VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

W tym przykładzie zastąp <APP_NAME> wartości i <RESOURCE_GROUP> nazwą aplikacji funkcji i grupy zasobów odpowiednio. Zastąp <LANGUAGE|VERSION> również element wartością linuxFxVersion dla aktualizacji. Jeśli nie używasz miejsca przejściowego, usuń --slot parametr .

Aplikacja funkcji zostanie uruchomiona ponownie po zaktualizowaniu wersji.

Zamienianie miejsc

Jeśli przeprowadzasz wdrożenie projektu kodu i aktualizujesz ustawienia w miejscu przejściowym, na koniec musisz zamienić miejsce przejściowe na środowisko produkcyjne. Aby uzyskać więcej informacji, zobacz Zamiana miejsc.