Rozwiązywanie typowych problemów podczas uaktualniania środowiska uruchomieniowego platformy Azure

W tym artykule opisano sposób rozwiązywania niektórych typowych problemów, które mogą wystąpić podczas aktualizacji języka aplikacji funkcji lub wersji środowiska uruchomieniowego, na przykład nie można uzyskać dostępu do środowiska uruchomieniowego i nie można odnaleźć modułów.

Akcje do wykonania, jeśli otrzymasz wiadomość e-mail "Zalecana akcja: zaktualizuj aplikacje usługi Azure Functions, aby korzystały z platformy .NET 6".

• Rozszerzona pomoc techniczna dla platformy Microsoft .NET Core 3.1 zakończyła się 3 grudnia 2022 r. Środowisko uruchomieniowe usługi Azure Functions w wersji 3 jest oparte na platformie .NET Core 3.1. Zalecamy zaktualizowanie aplikacji funkcji do środowiska uruchomieniowego w wersji 4.x, która korzysta z platformy .NET 6 i ma długoterminową obsługę. Po 3 grudnia 2022 r. twoje aplikacje nie kwalifikują się do nowych funkcji, poprawek zabezpieczeń, optymalizacji wydajności ani obsługi do momentu uaktualnienia ich do środowiska uruchomieniowego usługi Functions w wersji 4.x.

• Aplikacje usługi Functions w środowisku uruchomieniowym w wersji 3 będą nadal działać, a twoje aplikacje nie mają wpływu. Kod można wdrożyć w tych aplikacjach usługi Functions po tej dacie. Możemy jednak usunąć możliwość tworzenia aplikacji przeznaczonych dla środowiska uruchomieniowego usługi Functions w wersji 3 przy użyciu typowych ścieżek.

• Aby uzyskać więcej informacji i wskazówek dotyczących migracji, zobacz:

  • Wersje środowiska uruchomieniowego usługi Functions
  • Migrowanie aplikacji z usługi Azure Functions w wersji 3.x do wersji 4.x
  • Migrowanie aplikacji z usługi Azure Functions w wersji 1.x do wersji 4.x

Weryfikowanie zgodności aplikacji funkcji dla środowiska uruchomieniowego w wersji 4

• Przejdź do swojej aplikacji funkcji w witrynie Azure Portal. Wybierz pozycję Diagnozowanie i rozwiązywanie problemów, aby otworzyć diagnostykę usługi Azure Functions. Na pasku Wyszukiwanie wpisz Aktualizowanie języka aplikacji funkcji lub wersji środowiska uruchomieniowego, aby uruchomić ją bezpośrednio. Raport diagnostyczny zawiera wskazówki dotyczące aktualizacji. Po zakończeniu walidacji postępuj zgodnie z zaleceniami i rozwiąż wszelkie problemy w aplikacji.
• Zapewniamy również moduł sprawdzania poprawności przed uaktualnieniem, który pomaga zidentyfikować potencjalne problemy podczas migracji aplikacji funkcji do wersji 4.x. Na tym samym pasku wyszukiwania diagnostycznego wpisz Moduł sprawdzania poprawności przed uaktualnieniem usługi Functions do wersji 4.x , aby uruchomić go bezpośrednio. Po zakończeniu walidacji postępuj zgodnie z zaleceniami i rozwiąż wszelkie problemy w aplikacji.
• Zdecydowanie zalecamy uaktualnienie lokalnego środowiska projektu do wersji 4.x. Przeprowadź pełne testy lokalne aplikacji, używając narzędzi Azure Functions Core Tools w wersji 4.x.
• Przed wdrożeniem aplikacji w miejscu produkcyjnym rozważ jej przetestowanie i zweryfikowanie przy użyciu miejsca przejściowego na platformie Azure w nowej wersji środowiska uruchomieniowego. Pamiętaj, aby ustawić wartość WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 dla opcji migracji z miejscami.

Zmienianie wersji środowiska uruchomieniowego usługi Functions dla systemu Windows

1. Ustaw FUNCTIONS_EXTENSION_VERSION, czyli ustawienie aplikacji w okienku Konfiguracja witryny Azure Portal, na ~4wartość . Aby uzyskać więcej informacji, zobacz Zmienianie wersji środowiska uruchomieniowego.
2. netFrameworkVersion Ustaw ustawienie witryny na docelową platformę .NET 6. netFrameworkVersion to ustawienie SiteConfig, a nie ustawienie aplikacji. Nie jest ona dostępna bezpośrednio w witrynie Azure Portal. Można ją jednak ustawić przy użyciu eksploratora zasobów platformy Azure lub interfejsu wiersza polecenia platformy Azure/programu PowerShell.

Aby uzyskać więcej informacji, zobacz Wersje środowiska uruchomieniowego usługi Functions.

Zmienianie wersji środowiska uruchomieniowego usługi Functions dla systemu Linux

1. Ustaw FUNCTIONS_EXTENSION_VERSION, czyli ustawienie aplikacji w okienku Konfiguracja witryny Azure Portal, na ~4wartość . Aby uzyskać więcej informacji, zobacz Zmienianie wersji środowiska uruchomieniowego.
2. Ustaw LinuxFxVersionwartość , przy użyciu interfejsu wiersza polecenia (CLI) na <Language>|<LanguageVersion>, na podstawie używanego języka. Aby uzyskać więcej informacji, zobacz Using LinuxFxVersion for Linux Function Apps (Korzystanie z systemu LinuxFxVersion dla aplikacji funkcji systemu Linux). Aby na przykład zaktualizować platformę .NET 6, można ustawić wartość LinuxFxVersion dotnet|6.0 i FUNCTIONS_EXTENSION_VERSION na ~4.

Aby uzyskać więcej informacji, zobacz Wersje środowiska uruchomieniowego usługi Functions.

Pobieranie listy obsługiwanych języków według wersji środowiska uruchomieniowego

Zobacz listę obsługiwanych języków według wersji środowiska uruchomieniowego.

Aktualizowanie ustawienia wersji językowej aplikacji funkcji po zaktualizowaniu kodu

• PowerShell: w witrynie Azure Portal ustaw wartość PowerShell Core version. Aby uzyskać więcej informacji, zobacz Zmienianie wersji programu PowerShell.
• Python: Dla parametru linuxFxVersion ustaw wartość python|3.x. Aby uzyskać więcej informacji, zobacz Zmiana wersji języka Python.
• Java: Określ wersję językową, używając -DjavaVersion jako 11 lub 17. Aby uzyskać więcej informacji, zobacz Określanie wersji wdrożenia.
• Node, JavaScript: dla systemu Windows ustaw WEBSITE_NODE_DEFAULT_VERSION ustawienie aplikacji na ~16. W przypadku systemu Linux ustaw wartość parametru linuxFxVersion za pomocą interfejsu wiersza polecenia na node|16. Aby uzyskać więcej informacji, zobacz Ustawianie wersji środowiska Node.

Użycie serwerów proxy usługi Azure Functions

Obsługa serwerów proxy jest ponownie dostępna w wersji 4.x, dzięki czemu można pomyślnie uaktualnić aplikacje funkcji do najnowszej wersji środowiska uruchomieniowego. Zalecamy jednak, aby jak najszybciej przełączyć się na integrację aplikacji funkcji z usługą Azure API Management. Usługa API Management umożliwia korzystanie z bardziej kompletnego zestawu funkcji do definiowania, zabezpieczania, zarządzania i zarabiania na interfejsach API opartych na funkcjach. Aby uzyskać więcej informacji, zobacz Jak przeprowadzić migrację do usługi APIM i Integrowanie usługi Functions z usługą APIM przy użyciu programu Visual Studio.

Pobierz listę wszystkich aplikacji usługi Azure Functions korzystających ze środowiska uruchomieniowego w wersji 1.x, 2.x lub 3.x

1. Przejdź do swojej aplikacji funkcji w witrynie Azure Portal.
2. Wybierz pozycję Diagnozowanie i rozwiązywanie problemów, aby otworzyć diagnostykę usługi Azure Functions.
3. Na pasku Wyszukiwanie wpisz Aktualizowanie języka aplikacji funkcji lub wersji środowiska uruchomieniowego, aby uruchomić ją bezpośrednio.
4. W raporcie diagnostycznym przewiń w dół i wybierz pozycję Wyświetl wszystkie szczegóły widoku aplikacji>funkcji.
5. Ustaw filtry wyszukiwania i wybierz pozycję Pokaż , aby uzyskać listę aplikacji funkcji w bieżącej subskrypcji.

Alternatywnie możesz użyć wywołań interfejsu API REST usługi App Service (GetConfiguration), aby to ustalić. LinuxFxVersion podaj WindowsFxVersion informacje o wersji.

Przenoszenie aplikacji .NET Framework 4.6.1 ze środowiska uruchomieniowego usługi Functions w wersji 1 do wersji 4

Platforma .NET Framework 4.6.1 dotarła do kresu życia, dlatego aplikacje powinny zostać uaktualnione do wersji .NET Framework 4.8. W usłudze Functions w wersji 4 można uruchomić aplikację .NET Framework 4.8 w trybie poza procesem. Aby uzyskać więcej informacji, zobacz przewodnik po procesie izolowanym.

Migrowana aplikacja funkcji nie uruchamia się lub ma pewne problemy ze środowiskiem uruchomieniowym

• W przypadku aplikacji .NET pamiętaj o zaktualizowaniu kodu do platformy .NET 6 przed utworzeniem i wdrożeniem.
• Dokładnie sprawdź wersję środowiska uruchomieniowego aplikacji w witrynie Azure Portal.
• W przypadku aplikacji systemu Windows musisz również ustawić parametr netFrameworkVersion za pomocą interfejsu wiersza polecenia lub programu PowerShell.
• Upewnij się, że używasz pakietów rozszerzeń w wersji 2.x lub nowszej zgodnie z zaleceniami. Wersja 4.x środowiska uruchomieniowego usługi Functions wymaga wersji 2.x lub 3.0.0.
• Rejestrowanie w usłudze Azure Storage przy użyciu pulpitu AzureWebJobsDashboard nie jest już obsługiwane w wersji 4.x. Zamiast tego użyj usługi Application Insights do monitorowania.
• Jeśli zostanie wyświetlony komunikat informujący, że środowisko uruchomieniowe usługi Azure Functions jest niedostępne i udostępniasz konta magazynu, zobacz Zagadnienia dotyczące identyfikatora hosta.
• Usługa Azure Functions 4.x nie obsługuje Node.js 10 i 12, Python 3.6 i PowerShell 6. Aby uzyskać więcej informacji, zobacz Wersje językowe obsługiwane dla środowiska uruchomieniowego w wersji 4.
• W przypadku funkcji języka Python, jeśli występują błędy związane z kolizją modułu i nie znaleziono modułu, spróbuj ustawić wartość PYTHON_ISOLATE_WORKER_DEPENDENCIES 1 w ustawieniach aplikacji.
• Zapoznaj się z artykułem Migrowanie istniejących aplikacji funkcji.
• W przypadku problemów ze środowiskiem uruchomieniowym w opcji Diagnozowanie i rozwiązywanie problemów w witrynie Azure Portal wyszukaj pozycję Aplikacja funkcji nie działa lub zgłasza błędy i przejrzyj raport diagnostyczny pod kątem komunikatów o błędach i rozwiązań. Zapoznaj się również z modułem wykrywania Testy konfiguracji funkcji, aby upewnić się, że konfiguracja jest poprawna.
• Zapoznaj się z blogami Problemy podczas uaktualniania aplikacji funkcji platformy Azure do wersji 4 , aby uzyskać dodatkowe porady dotyczące rozwiązywania problemów.

Skontaktuj się z nami, aby uzyskać pomoc

Jeśli masz pytania lub potrzebujesz pomocy, utwórz wniosek o pomoc techniczną lub zadaj pytanie w społeczności wsparcia dla platformy Azure. Możesz również przesłać opinię o produkcie do społeczności opinii na temat platformy Azure.