Udostępnij za pomocą

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

W usłudze Azure Functions obsługa stosu językowego jest ograniczona do określonych wersji. Gdy nowe wersje staną się dostępne, możesz zaktualizować aplikacje funkcji, aby korzystać z nowych funkcji. Obsługa w usłudze Functions może również kończyć się starszymi wersjami i jest zwykle zgodna z osiami czasu zakończenia wsparcia dla społeczności. Aby uzyskać więcej informacji, zobacz zasady obsługi środowiska uruchomieniowego języka. Aby uzyskać obsługiwane wersje różnych języków, zobacz Języki według wersji środowiska uruchomieniowego.

Aby zapewnić, że aplikacje funkcji będą nadal otrzymywać pomoc techniczną, postępuj zgodnie z instrukcjami w tym artykule, aby zaktualizować je do najnowszych dostępnych wersji. Sposób aktualizowania aplikacji funkcji zależy od kilku czynników:

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

Uwaga

W tym artykule pokazano, jak zaktualizować wersję platformy .NET aplikacji funkcji korzystającej z izolowanego modelu procesu roboczego. Jeśli aplikacja funkcji działa w starszej wersji platformy .NET i korzysta z modelu przetwarzania, rozważ następujące opcje:

Wymagania wstępne

  • Konto Azure z aktywną subskrypcją. Utwórz je bezpłatnie.
  • Aplikacja funkcji hostowana w jednym z następujących planów usługi Functions:
    • Premium
    • Dedykowana
    • Zużycie

Przygotowywanie aplikacji funkcji

Przed zaktualizowaniem konfiguracji stosu dla aplikacji funkcji na platformie Azure wykonaj zadania opisane w poniższych sekcjach.

Lokalne weryfikowanie aplikacji funkcji

Przetestuj i zweryfikuj kod aplikacji funkcji lokalnie w nowej wersji docelowej.

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

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

    Jeśli używasz wersji zapoznawczej, zobacz Wskazówki dotyczące funkcji dla wersji zapoznawczej platformy .NET , aby upewnić się, że wersja jest obsługiwana. Korzystanie z wersji zapoznawczych platformy .NET może wymagać wykonania większej liczby kroków.

  2. Zaktualizuj odwołania do najnowszych wersji zestawu Microsoft.Azure.Functions.Worker i Microsoft.Azure.Functions.Worker.Sdk.

  3. Zaktualizuj platformę docelową projektu do nowej wersji. W przypadku projektów języka C# należy zaktualizować <TargetFramework> element w pliku csproj . Aby uzyskać więcej informacji na temat używanej wersji, zobacz Platformy docelowe.

    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 Visual Studio Code może być konieczne zaktualizowanie azureFunctions.deploySubpath ustawienia rozszerzenia w ustawieniach użytkownika lub pliku .vscode/settings.json projektu. Sprawdź, czy nie ma zależności od wersji platformy, która istnieje poza kodem projektu, w ramach kroków kompilacji lub potoku ciągłego integracji i ciągłego dostarczania (CI/CD).

  4. Wprowadź wszelkie aktualizacje kodu projektu wymagane przez nową wersję platformy .NET. Zapoznaj się z informacjami o wersji, aby uzyskać szczegółowe informacje. Możesz również użyć Asystenta uaktualniania platformy .NET , aby pomóc zaktualizować kod w odpowiedzi na zmiany w różnych wersjach głównych.

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

Przechodzenie do najnowszego środowiska uruchomieniowego usługi Functions

Upewnij się, że aplikacja funkcji działa 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.

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

  1. Na portalu Azure znajdź i wybierz aplikację funkcji. W menu bocznym wybierz pozycję Konfiguracja ustawień>.

  2. Przejdź do karty Ustawienia środowiska uruchomieniowego funkcji i sprawdź wartość wersji środowiska uruchomieniowego . Aplikacja funkcji powinna działać w wersji 4.x środowiska uruchomieniowego usługi Functions (~4).

Jeśli musisz 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. Zamiast po prostu zmieniać ustawienie FUNCTIONS_EXTENSION_VERSION, postępuj zgodnie z instrukcjami w tych artykułach.

Publikowanie aktualizacji aplikacji funkcji

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

Napiwek

Aby usprawnić proces aktualizacji, zminimalizować przestoje aplikacji funkcji i zapewnić potencjalną wersję wycofywania, należy opublikować zaktualizowaną aplikację funkcji w miejscu przejściowym. Aby uzyskać więcej informacji, zobacz Miejsca wdrożenia usługi Azure Functions.

Po opublikowaniu zaktualizowanej aplikacji funkcji 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 aplikacja funkcji działa w systemie Windows, czy w systemie Linux na platformie Azure.

Kiedy korzystasz z slotu testowego, upewnij się, że kierujesz aktualizacje do właściwego slotu.

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

  1. Na portalu Azure znajdź i wybierz aplikację funkcji. W menu bocznym wybierz pozycję Konfiguracja ustawień>. Jeśli masz miejsce przejściowe, wybierz określone miejsce.

  2. Na karcie Ustawienia ogólne zaktualizuj wersję języka Java do żądanej wersji.

  3. Wybierz Zapisz. Po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

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

  1. Na portalu Azure znajdź i wybierz aplikację funkcji. W menu bocznym wybierz pozycję Konfiguracja ustawień>. Jeśli masz miejsce przejściowe, wybierz określone miejsce.

  2. Na karcie Ustawienia ogólne zaktualizuj wersję platformy .NET do żądanej wersji.

  3. Wybierz Zapisz. Po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

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

  1. Na portalu Azure znajdź i wybierz aplikację funkcji. W menu bocznym wybierz pozycję Konfiguracja ustawień>. Jeśli masz miejsce przejściowe, wybierz określone miejsce.

  2. Na karcie Ustawienia ogólne zaktualizuj Node.js wersję do żądanej wersji.

  3. Wybierz Zapisz. 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:

  1. Na portalu Azure znajdź i wybierz aplikację funkcji. W menu bocznym wybierz pozycję Konfiguracja ustawień>. Jeśli masz miejsce przejściowe, wybierz określone miejsce.

  2. Na karcie Ustawienia ogólne zaktualizuj wersję programu PowerShell Core do żądanej wersji.

  3. Wybierz Zapisz. Po powiadomieniu o ponownym uruchomieniu wybierz pozycję Kontynuuj.

Aplikacje języka Python nie są obsługiwane w systemie Windows. Zamiast tego przejdź do karty Systemu Linux .

Aplikacja funkcji zostanie uruchomiona ponownie po zaktualizowaniu wersji.

Zamienianie miejsc

Jeśli używasz miejsca przejściowego do wdrażania projektu kodu i aktualizowania ustawień, zamień miejsce przejściowe na środowisko produkcyjne. Aby uzyskać więcej informacji, zobacz Zamiana miejsc.

Treści powiązane

Przewodnik dla deweloperów języka Java

Przewodnik po izolowanym procesie roboczym w języku C#

Przewodnik dla deweloperów Node.js

Przewodnik dla deweloperów języka Python

Przewodnik dla deweloperów programu PowerShell

  • Last updated on