Jak ustawić docelowe wersje środowiska uruchomieniowego usługi Azure Functions

Artykuł
03/15/2024

Aplikacja funkcji jest uruchamiana w określonej wersji środowiska uruchomieniowego usługi Azure Functions. Domyślnie aplikacje funkcji są tworzone w najnowszej wersji 4.x środowiska uruchomieniowego usługi Functions. Aplikacje funkcji są obsługiwane tylko w przypadku uruchamiania w obsługiwanej wersji głównej. W tym artykule wyjaśniono, jak skonfigurować aplikację funkcji na platformie Azure w celu kierowania lub przypinania do określonej wersji, jeśli jest to wymagane.

Sposób określania celu określonej wersji zależy od tego, czy korzystasz z systemu Windows, czy Linux. Ta wersja artykułu obsługuje system Windows. Wybierz system operacyjny w górnej części artykułu.

Sposób określania celu określonej wersji zależy od tego, czy korzystasz z systemu Windows, czy Linux. Ta wersja artykułu obsługuje system Linux. Wybierz system operacyjny w górnej części artykułu.

Ważne

Jeśli to możliwe, zawsze należy uruchamiać funkcje w najnowszej obsługiwanej wersji środowiska uruchomieniowego usługi Azure Functions. Należy przypiąć aplikację tylko do określonej wersji, gdy zostanie to poinstruowane z powodu problemu w najnowszej wersji. Zawsze należy przejść do najnowszej wersji środowiska uruchomieniowego, gdy tylko funkcje będą mogły działać poprawnie.

Podczas programowania lokalnego zainstalowana wersja narzędzi Azure Functions Core Tools musi być zgodna z główną wersją środowiska uruchomieniowego używaną przez aplikację funkcji na platformie Azure. Aby uzyskać więcej informacji, zobacz Wersje narzędzi Core Tools.

Aktualizowanie wersji środowiska uruchomieniowego

Jeśli to możliwe, zawsze należy uruchamiać aplikacje funkcji w najnowszej obsługiwanej wersji środowiska uruchomieniowego usługi Azure Functions. Jeśli aplikacja funkcji jest obecnie uruchomiona w starszej wersji środowiska uruchomieniowego, należy przeprowadzić migrację aplikacji do wersji 4.x

Jeśli aplikacja ma istniejące funkcje, należy podjąć środki ostrożności przed przejściem do nowszej wersji głównej środowiska uruchomieniowego. W poniższych artykułach szczegółowo opisano zmiany powodujące niezgodność między wersjami głównymi, w tym zmiany powodujące niezgodność specyficzne dla języka. Zawierają one również instrukcje krok po kroku dotyczące pomyślnej migracji istniejącej aplikacji funkcji.

Aby określić bieżącą wersję środowiska uruchomieniowego, zobacz Wyświetlanie bieżącej wersji środowiska uruchomieniowego.

Wyświetlanie bieżącej wersji środowiska uruchomieniowego

Bieżącą wersję środowiska uruchomieniowego aplikacji funkcji można wyświetlić na jeden z następujących sposobów:

Poniższa procedura umożliwia wyświetlanie i aktualizowanie wersji środowiska uruchomieniowego używanego aktualnie przez aplikację funkcji.

W witrynie Azure Portal przejdź do swojej aplikacji funkcji.
W obszarze Ustawienia wybierz pozycję Konfiguracja. Na karcie Ustawienia środowiska uruchomieniowego funkcji znajdź wersję środowiska uruchomieniowego. Zwróć uwagę na określoną wersję środowiska uruchomieniowego. W poniższym przykładzie wersja jest ustawiona na ~4.

Widok można wyświetlić FUNCTIONS_EXTENSION_VERSION w interfejsie wiersza polecenia platformy Azure.

Za pomocą interfejsu wiersza polecenia platformy Azure wyświetl bieżącą wersję środowiska uruchomieniowego za az functionapp config appsettings list pomocą polecenia .

az functionapp config appsettings list --name <function_app> \
--resource-group <my_resource_group>

W tym kodzie zastąp <function_app> ciąg nazwą aplikacji funkcji. Zastąp <my_resource_group> również nazwą grupy zasobów aplikacji funkcji.

FUNCTIONS_EXTENSION_VERSION Zobaczysz w następujących danych wyjściowych, które zostały obcięte w celu uzyskania jasności:

[
  {
    "name": "FUNCTIONS_EXTENSION_VERSION",
    "slotSetting": false,
    "value": "~4"
  },
  {
    "name": "FUNCTIONS_WORKER_RUNTIME",
    "slotSetting": false,
    "value": "dotnet"
  },
  
  ...
]

Wybierz pozycję Otwórz usługę Cloud Shell w poprzednim przykładzie kodu, aby uruchomić polecenie w usłudze Azure Cloud Shell. Możesz również uruchomić interfejs wiersza polecenia platformy Azure lokalnie , aby wykonać to polecenie. Podczas uruchamiania lokalnego musisz najpierw uruchomić polecenie az login , aby się zalogować.

Aby sprawdzić środowisko uruchomieniowe usługi Azure Functions, użyj następującego polecenia cmdlet:

Get-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>"

Zastąp <FUNCTION_APP> ciąg nazwą aplikacji funkcji i <RESOURCE_GROUP>. Bieżąca wartość FUNCTIONS_EXTENSION_VERSION ustawienia jest zwracana w tabeli skrótów.

Przypinanie do określonej wersji

Usługa Azure Functions umożliwia użycie FUNCTIONS_EXTENSION_VERSION ustawienia aplikacji w celu określenia wersji środowiska uruchomieniowego używanej przez daną aplikację funkcji. Po określeniu tylko wersji głównej (~4) aplikacja funkcji zostanie automatycznie zaktualizowana do nowych wersji pomocniczych środowiska uruchomieniowego, gdy staną się dostępne. Aktualizacje wersji pomocniczej są wykonywane automatycznie, ponieważ nowe wersje pomocnicze nie powinny wprowadzać zmian powodujących niezgodność.

Aplikacje systemu Linux używają linuxFxVersion ustawienia witryny wraz z FUNCTIONS_EXTENSION_VERSION programem , aby określić prawidłowy obraz podstawowy systemu Linux, w którym mają być uruchamiane funkcje. Podczas tworzenia nowej aplikacji funtion w systemie Linux środowisko uruchomieniowe automatycznie wybiera prawidłowy obraz podstawowy na podstawie wersji środowiska uruchomieniowego stosu językowego.

Przypinanie do określonej wersji środowiska uruchomieniowego powoduje ponowne uruchomienie aplikacji funkcji.

Po określeniu określonej wersji pomocniczej (takiej jak 4.0.12345) w FUNCTIONS_EXTENSION_VERSIONprogramie aplikacja funkcji jest przypięta do tej konkretnej wersji środowiska uruchomieniowego, dopóki jawnie nie zdecydujesz się na powrót do aktualizacji automatycznych. Należy przypiąć tylko określoną wersję pomocniczą wystarczająco długo, aby rozwiązać wszelkie problemy z aplikacją funkcji, które uniemożliwiają określanie wersji głównej. Starsze wersje pomocnicze są regularnie usuwane ze środowiska produkcyjnego. Po przypięciu do wersji pomocniczej, która zostanie usunięta, aplikacja funkcji zostanie uruchomiona w najbliższej istniejącej wersji zamiast wersji ustawionej w FUNCTIONS_EXTENSION_VERSIONprogramie . W anonsach usługi App Service ogłaszane są drobne usunięcia wersji.

Uwaga

Podczas próby opublikowania z programu Visual Studio w aplikacji przypiętej do określonej pomocniczej wersji środowiska uruchomieniowego zostanie wyświetlone okno dialogowe z monitem o zaktualizowanie do najnowszej wersji lub anulowanie publikowania. Aby uniknąć tego sprawdzenia, kiedy musisz użyć określonej wersji pomocniczej, dodaj <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> właściwość w .csproj pliku.

Użyj jednej z tych metod, aby tymczasowo przypiąć aplikację do określonej wersji środowiska uruchomieniowego:

Poniższa procedura umożliwia wyświetlanie i aktualizowanie wersji środowiska uruchomieniowego używanego aktualnie przez aplikację funkcji.

W witrynie Azure Portal przejdź do swojej aplikacji funkcji.
W obszarze Ustawienia wybierz pozycję Konfiguracja. Na karcie Ustawienia środowiska uruchomieniowego funkcji znajdź wersję środowiska uruchomieniowego. Zwróć uwagę na określoną wersję środowiska uruchomieniowego. W poniższym przykładzie wersja jest ustawiona na ~4.

Aby przypiąć aplikację do określonej wersji pomocniczej, wybierz pozycję Ustawienia>aplikacji FUNCTIONS_EXTENSION_VERSION, zmień wartość na wymaganą wersję pomocniczą i wybierz przycisk OK.
Wybierz pozycję Zapisz>kontynuuj, aby zastosować zmiany i ponownie uruchomić aplikację.

Ustawienie można zaktualizować FUNCTIONS_EXTENSION_VERSION w aplikacji funkcji za pomocą polecenia az functionapp config appsettings set .

az functionapp config appsettings set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--settings FUNCTIONS_EXTENSION_VERSION=<VERSION>

Wybierz pozycję Wypróbuj w poprzednim przykładzie kodu, aby uruchomić polecenie w usłudze Azure Cloud Shell. Możesz również uruchomić interfejs wiersza polecenia platformy Azure lokalnie , aby wykonać to polecenie. Podczas uruchamiania lokalnego musisz najpierw uruchomić polecenie az login , aby się zalogować.

Użyj tego skryptu, aby przypiąć środowisko uruchomieniowe usługi Functions:

Update-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>" -AppSetting @{"FUNCTIONS_EXTENSION_VERSION" = "<VERSION>"} -Force

Zastąp <FUNCTION_APP> ciąg nazwą aplikacji funkcji i <RESOURCE_GROUP> nazwą grupy zasobów aplikacji funkcji. Ponadto zastąp <VERSION> element konkretną wersją pomocniczą, która jest tymczasowo potrzebna do kierowania. Zaktualizowaną wartość FUNCTIONS_EXTENSION_VERSION ustawienia można sprawdzić w zwracanej tabeli skrótów.

Aplikacja funkcji zostanie ponownie uruchomiona po wprowadzeniu zmiany w ustawieniu aplikacji.

Aby przypiąć aplikację funkcji do określonej wersji środowiska uruchomieniowego w systemie Linux, należy ustawić adres URL obrazu podstawowego specyficznego dla wersji w linuxFxVersion ustawieniu witryny w formacie DOCKER|<PINNED_VERSION_IMAGE_URI>.

Ważne

Przypięte aplikacje funkcji w systemie Linux nie otrzymują regularnych aktualizacji funkcji zabezpieczeń i hostów. Jeśli nie jest zalecane przez specjalistę pomocy technicznej, użyj FUNCTIONS_EXTENSION_VERSION ustawienia i standardowej linuxFxVersion wartości dla języka i wersji, na przykład Python|3.9. Prawidłowe wartości można znaleźć w artykule referencyjnym.linuxFxVersion

Przypinanie do określonego środowiska uruchomieniowego nie jest obecnie obsługiwane w przypadku aplikacji funkcji systemu Linux uruchomionych w planie Zużycie.

Poniżej przedstawiono przykład linuxFxVersion wartości wymaganej do przypięcia aplikacji funkcji Node.js 16 do określonej wersji środowiska uruchomieniowego 4.14.0.3:

DOCKER|mcr.microsoft.com/azure-functions/node:4.14.0.3-node16

W razie potrzeby specjalista pomocy technicznej może podać prawidłowy identyfikator URI obrazu podstawowego dla aplikacji.

Użyj następujących poleceń interfejsu wiersza polecenia platformy Azure, aby wyświetlić i ustawić element linuxFxVersion. Obecnie nie można ustawić linuxFxVersion w portalu ani przy użyciu programu Azure PowerShell.

Aby wyświetlić bieżącą wersję środowiska uruchomieniowego, użyj polecenia az functionapp config show .
```
az functionapp config show --name <function_app> \
--resource-group <my_resource_group> --query 'linuxFxVersion' -o tsv
```
W tym kodzie zastąp <function_app> ciąg nazwą aplikacji funkcji. Zastąp <my_resource_group> również nazwą grupy zasobów aplikacji funkcji. Zwracana jest bieżąca linuxFxVersion wartość.
Aby zaktualizować linuxFxVersion ustawienie w aplikacji funkcji, użyj polecenia az functionapp config set .
```
az functionapp config set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--linux-fx-version <LINUX_FX_VERSION>
```
Zastąp <FUNCTION_APP> ciąg nazwą aplikacji funkcji. Zastąp <RESOURCE_GROUP> również nazwą grupy zasobów aplikacji funkcji. Na koniec zastąp <LINUX_FX_VERSION> wartość określonego obrazu udostępnionego Użytkownikowi przez specjalistę pomocy technicznej.

Te polecenia można uruchomić w usłudze Azure Cloud Shell , wybierając pozycję Otwórz usługę Cloud Shell w poprzednich przykładach kodu. Możesz również użyć interfejsu wiersza polecenia platformy Azure lokalnie , aby wykonać to polecenie po wykonaniu polecenia w celu zalogowania az login się.

Aplikacja funkcji jest uruchamiana ponownie po wprowadzeniu zmiany w konfiguracji lokacji.

Następne kroki

Zobacz Informacje o wersji dla wersji środowiska uruchomieniowego

Jak ustawić docelowe wersje środowiska uruchomieniowego usługi Azure Functions

Aktualizowanie wersji środowiska uruchomieniowego

Wyświetlanie bieżącej wersji środowiska uruchomieniowego

Przypinanie do określonej wersji

Następne kroki

Dodatkowe zasoby