Een versie kiezen voor de runtime van Azure Functions

Een functie-app wordt uitgevoerd op een specifieke versie van de Azure Functions-runtime. Functie-apps worden standaard gemaakt in de nieuwste 4.x-versie van de Functions-runtime. Uw functie-apps worden alleen ondersteund wanneer ze worden uitgevoerd op een ondersteunde primaire versie. In dit artikel wordt uitgelegd hoe u een functie-app in Azure configureert om een specifieke versie te targeten of vast te maken wanneer dat nodig is.

De manier waarop u zich richt op een specifieke versie, is afhankelijk van of u Windows of Linux gebruikt. Deze versie van het artikel ondersteunt Windows. Kies uw besturingssysteem bovenaan het artikel.

De manier waarop u zich richt op een specifieke versie, is afhankelijk van of u Windows of Linux gebruikt. Deze versie van het artikel ondersteunt Linux. Kies uw besturingssysteem bovenaan het artikel.

Belangrijk

Indien mogelijk moet u altijd uw functies uitvoeren op de meest recente ondersteunde versie van de Azure Functions-runtime. U moet uw app alleen vastmaken aan een specifieke versie wanneer u wordt gevraagd dit te doen vanwege een probleem in de nieuwste versie. U moet altijd naar de nieuwste runtimeversie gaan zodra uw functies correct kunnen worden uitgevoerd.

Tijdens de lokale ontwikkeling moet uw geïnstalleerde versie van Azure Functions Core Tools overeenkomen met de primaire runtimeversie die wordt gebruikt door de functie-app in Azure. Zie Core Tools-versies voor meer informatie.

Uw runtimeversie bijwerken

Indien mogelijk moet u uw functie-apps altijd uitvoeren op de meest recente ondersteunde versie van de Azure Functions-runtime. Als uw functie-app momenteel wordt uitgevoerd op een oudere versie van de runtime, moet u uw app migreren naar versie 4.x

Wanneer uw app bestaande functies heeft, moet u voorzorgsmaatregelen nemen voordat u overstapt op een latere primaire runtimeversie. In de volgende artikelen worden belangrijke wijzigingen tussen belangrijke versies beschreven, waaronder taalspecifieke wijzigingen die fouten veroorzaken. Ze bieden u ook stapsgewijze instructies voor een geslaagde migratie van uw bestaande functie-app.

• Migreren van runtime-versie 3.x naar versie 4.x
• Migreren van runtime-versie 1.x naar versie 4.x

Zie De huidige runtimeversie weergeven om de huidige runtimeversie te bepalen.

De huidige runtimeversie weergeven

U kunt de huidige runtimeversie van uw functie-app op een van de volgende manieren bekijken:

Portal

Gebruik de volgende procedure om de runtime-versie weer te geven en bij te werken die momenteel wordt gebruikt door een functie-app.

1. Blader in de Azure-portal naar uw functie-app.

2. Kies Configuratie onder Instellingen. Ga op het tabblad Runtime-instellingen naar de runtime-versie. Noteer de specifieke runtimeversie. In onderstaand voorbeeld is de versie ingesteld op ~4.

   

Azure-CLI

U kunt deze FUNCTIONS_EXTENSION_VERSION bekijken vanuit de Azure CLI.

Bekijk met behulp van de Azure CLI de huidige runtimeversie met de az functionapp config appsettings list opdracht.

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

Vervang in deze code door <function_app> de naam van uw functie-app. Vervang ook door <my_resource_group> de naam van de resourcegroep voor uw functie-app.

U ziet de FUNCTIONS_EXTENSION_VERSION volgende uitvoer, die voor de duidelijkheid is afgekapt:

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

Kies Open Cloud Shell in het vorige codevoorbeeld om de opdracht uit te voeren in Azure Cloud Shell. U kunt de Azure CLI ook lokaal uitvoeren om deze opdracht uit te voeren. Wanneer u lokaal werkt, moet u eerst worden uitgevoerd az login om u aan te melden.

Powershell

Gebruik de volgende cmdlet om de Azure Functions-runtime te controleren:

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

Vervang door <FUNCTION_APP> de naam van uw functie-app en <RESOURCE_GROUP>. De huidige waarde van de FUNCTIONS_EXTENSION_VERSION instelling wordt geretourneerd in de hash-tabel.

Vastmaken aan een specifieke versie

Met Azure Functions kunt u de FUNCTIONS_EXTENSION_VERSION toepassingsinstelling gebruiken om de runtimeversie te richten die wordt gebruikt door een bepaalde functie-app. Wanneer u alleen de primaire versie opgeeft (~4), wordt de functie-app automatisch bijgewerkt naar nieuwe secundaire versies van de runtime wanneer deze beschikbaar zijn. Secundaire versie-updates worden automatisch uitgevoerd omdat nieuwe secundaire versies geen belangrijke wijzigingen mogen introduceren.

Linux-apps gebruiken de linuxFxVersion site-instelling samen FUNCTIONS_EXTENSION_VERSION om de juiste Linux-basisinstallatiekopieën te bepalen waarin u uw functies kunt uitvoeren. Wanneer u een nieuwe funtion-app in Linux maakt, kiest de runtime automatisch de juiste basisinstallatiekopie voor u op basis van de runtimeversie van uw taalstack.

Door vast te maken aan een specifieke runtimeversie, wordt uw functie-app opnieuw opgestart.

Wanneer u een specifieke secundaire versie (zoals 4.0.12345) opgeeft FUNCTIONS_EXTENSION_VERSION, wordt de functie-app vastgemaakt aan die specifieke versie van de runtime totdat u expliciet wilt terugkeren naar automatische updates. U moet alleen vastmaken aan een specifieke secundaire versie die lang genoeg is om eventuele problemen met uw functie-app op te lossen die voorkomen dat u zich richt op de primaire versie. Oudere secundaire versies worden regelmatig verwijderd uit de productieomgeving. Wanneer u bent vastgemaakt aan een secundaire versie die wordt verwijderd, wordt uw functie-app in plaats daarvan uitgevoerd op de dichtstbijzijnde bestaande versie in plaats van de versieset in FUNCTIONS_EXTENSION_VERSION. Verwijderingen van secundaire versies worden aangekondigd in App Service-aankondigingen.

Notitie

Wanneer u vanuit Visual Studio probeert te publiceren naar een app die is vastgemaakt aan een specifieke secundaire versie van de runtime, wordt u gevraagd om bij te werken naar de nieuwste versie of de publicatie te annuleren. Als u deze controle wilt voorkomen wanneer u een specifieke secundaire versie moet gebruiken, voegt u de <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> eigenschap toe aan uw .csproj bestand.

Gebruik een van deze methoden om uw app tijdelijk vast te maken aan een specifieke versie van de runtime:

Portal

Gebruik de volgende procedure om de runtime-versie weer te geven en bij te werken die momenteel wordt gebruikt door een functie-app.

1. Blader in de Azure-portal naar uw functie-app.

2. Kies Configuratie onder Instellingen. Ga op het tabblad Runtime-instellingen naar de runtime-versie. Noteer de specifieke runtimeversie. In onderstaand voorbeeld is de versie ingesteld op ~4.

   

3. Als u uw app wilt vastmaken aan een specifieke secundaire versie, selecteert u Toepassingsinstellingen>FUNCTIONS_EXTENSION_VERSION, wijzigt u Waarde in de vereiste secundaire versie en selecteert u OK.

4. Selecteer Opslaan>doorgaan om wijzigingen toe te passen en de app opnieuw op te starten.

Azure-CLI

U kunt de FUNCTIONS_EXTENSION_VERSION instelling in de functie-app bijwerken met de opdracht az functionapp config appsettings set .

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

Vervang <FUNCTION_APP> door de naam van uw functie-app en <RESOURCE_GROUP> door de naam van de resourcegroep voor uw functie-app. Vervang ook door <VERSION> de specifieke secundaire versie die u tijdelijk nodig hebt om u te richten.

Kies Uitproberen in het vorige codevoorbeeld om de opdracht uit te voeren in Azure Cloud Shell. U kunt de Azure CLI ook lokaal uitvoeren om deze opdracht uit te voeren. Wanneer u lokaal werkt, moet u eerst worden uitgevoerd az login om u aan te melden.

Powershell

Gebruik dit script om de Functions-runtime vast te maken:

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

Vervang <FUNCTION_APP> door de naam van uw functie-app en <RESOURCE_GROUP> door de naam van de resourcegroep voor uw functie-app. Vervang ook door <VERSION> de specifieke secundaire versie die u tijdelijk nodig hebt om u te richten. U kunt de bijgewerkte waarde van de FUNCTIONS_EXTENSION_VERSION instelling in de geretourneerde hash-tabel controleren.

De functie-app wordt opnieuw opgestart nadat de wijziging is aangebracht in de toepassingsinstelling.

Als u uw functie-app wilt vastmaken aan een specifieke runtimeversie op Linux, stelt u een versiespecifieke basisinstallatiekopieën-URL in de linuxFxVersion site-instelling in de indeling DOCKER|<PINNED_VERSION_IMAGE_URI>in.

Belangrijk

Vastgemaakte functie-apps op Linux ontvangen geen regelmatige updates voor beveiliging en hostfunctionaliteit. Gebruik, tenzij aanbevolen door een ondersteuningsmedewerker, de FUNCTIONS_EXTENSION_VERSION instelling en een standaardwaarde linuxFxVersion voor uw taal en versie, zoals Python|3.9. Zie het linuxFxVersion naslagartikel voor geldige waarden.

Vastmaken aan een specifieke runtime wordt momenteel niet ondersteund voor Linux-functie-apps die worden uitgevoerd in een verbruiksabonnement.

Hier volgt een voorbeeld van de waarde die is vereist voor het linuxFxVersion vastmaken van een Node.js 16-functie-app aan een specifieke runtimeversie van 4.14.0.3:

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

Indien nodig kan een ondersteuningsmedewerker u een geldige basisinstallatiekopieën-URI voor uw toepassing bieden.

Gebruik de volgende Azure CLI-opdrachten om de linuxFxVersionopdracht weer te geven en in te stellen. U kunt momenteel niet instellen linuxFxVersion in de portal of met behulp van Azure PowerShell.

• Als u de huidige runtimeversie wilt weergeven, gebruikt u deze met de opdracht az functionapp config show .

  az functionapp config show --name <function_app> \
  --resource-group <my_resource_group> --query 'linuxFxVersion' -o tsv
  

  Vervang in deze code door <function_app> de naam van uw functie-app. Vervang ook door <my_resource_group> de naam van de resourcegroep voor uw functie-app. De huidige waarde van linuxFxVersion wordt geretourneerd.

• Als u de linuxFxVersion instelling in de functie-app wilt bijwerken, gebruikt u de opdracht az functionapp config set .

  az functionapp config set --name <FUNCTION_APP> \
  --resource-group <RESOURCE_GROUP> \
  --linux-fx-version <LINUX_FX_VERSION>
  

  Vervang door <FUNCTION_APP> de naam van uw functie-app. Vervang ook door <RESOURCE_GROUP> de naam van de resourcegroep voor uw functie-app. Vervang ten slotte door de waarde van een specifieke afbeelding die u door een ondersteuningsmedewerker <LINUX_FX_VERSION> hebt verstrekt.

U kunt deze opdrachten uitvoeren vanuit Azure Cloud Shell door Open Cloud Shell te kiezen in de voorgaande codevoorbeelden. U kunt de Azure CLI ook lokaal gebruiken om deze opdracht uit te voeren nadat u az login zich hebt aangemeld.

De functie-app wordt opnieuw opgestart nadat de wijziging is aangebracht in de siteconfiguratie.

Volgende stappen

Releaseopmerkingen voor runtimeversies bekijken