Linguaggi e runtime supportati in App Web statiche di Azure

Articolo
05/28/2024

App Web statiche di Azure funzionalità due posizioni diverse in cui le versioni del runtime e del linguaggio sono importanti, sul front-end e per l'API.

Tipo di runtime	Descrizione
Front-end	Versione responsabile dell'esecuzione dei passaggi di compilazione del sito Web che compilano l'applicazione front-end.
API	Versione e runtime di Funzioni di Azure usati nell'applicazione Web.

Front-end

È possibile specificare la versione usata per compilare il front-end dell'app Web statica. La configurazione di una versione non predefinita è spesso necessaria solo se è necessario specificare come destinazione le versioni precedenti.

È possibile specificare la versione di runtime che compila il front-end dell'app Web statica nel file package.json nella engines sezione del file.

{
  ...
  "engines": {
   "node": ">=14.0.0"
  }
}

API

Il supporto sottostante per le API in App Web statiche di Azure viene fornito da Funzioni di Azure. Per informazioni dettagliate, vedere le Funzioni di Azure linguaggi e runtime supportati.

Le versioni seguenti sono supportate per le funzioni gestite in App Web statiche. Se l'applicazione richiede una versione non elencata, è consigliabile portare le proprie funzioni nell'app.

Per configurare la versione del runtime del linguaggio API, impostare la apiRuntime proprietà nella platform sezione su uno dei valori supportati seguenti.

Versione del runtime del linguaggio	Sistema operativo	Versione di Funzioni di Azure	Valore `apiRuntime`	Data di fine supporto
.NET Core 3.1	Windows	3.x	`dotnet:3.1`	sabato 3 dicembre 2022
.NET 6.0 in-process	Windows	4.x	`dotnet:6.0`	-
Isolato .NET 6.0	Windows	4.x	`dotnet-isolated:6.0`	-
Isolato .NET 7.0	Windows	4.x	`dotnet-isolated:7.0`	-
.NET 8.0 isolato	Windows	4.x	`dotnet-isolated:8.0`	-
Node.js 12.x	Linux	3.x	`node:12`	sabato 3 dicembre 2022
Node.js 14.x	Linux	4.x	`node:14`	-
Node.js 16.x	Linux	4.x	`node:16`	-
Node.js 18.x	Linux	4.x	`node:18`	-
Node.js 20.x (anteprima)	Linux	4.x	`node:20`	-
Python 3.8	Linux	4.x	`python:3.8`	-
Python 3.9	Linux	4.x	`python:3.9`	-
Python 3.10	Linux	4.x	`python:3.10`	-

.NET

Per modificare la versione di runtime in un'app .NET, modificare il TargetFramework valore nel file csproj . Anche se facoltativo, se si imposta un apiRuntime valore nel file staticwebapp.config.json , assicurarsi che il valore corrisponda a quello definito nel file csproj .

L'esempio seguente illustra come aggiornare l'elemento TargetFramework per NET 8.0 come versione del runtime del linguaggio API nel file csproj .

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    ...
  </PropertyGroup>
...

Node.js

La configurazione di esempio seguente illustra come usare la apiRuntime proprietà per selezionare Node.js 16 come versione del runtime del linguaggio API nel file staticwebapp.config.json .

{
  ...
  "platform": {
    "apiRuntime": "node:16"
  }
  ...
}

Python

La configurazione di esempio seguente illustra come usare la apiRuntime proprietà per selezionare Python 3.8 come versione del runtime del linguaggio API nel file staticwebapp.config.json .

{
  ...
  "platform": {
    "apiRuntime": "python:3.8"
  }
  ...
}

Riabilitare i proxy nella versione 4.x

Funzioni di Azure supporta la riabilitare i proxy nella versione 4.x. Per abilitare il supporto proxy nelle funzioni gestite per l'app Web statica, impostare su SWA_ENABLE_PROXIES_MANAGED_FUNCTIONS true nelle impostazioni dell'applicazione.

[! NOTA] Anche se i proxy sono supportati nella versione 4.x, è consigliabile usare l'integrazione di Azure Gestione API con le app per le funzioni gestite, quindi l'app non è dipendente dai proxy.

Elementi deprecati

Nota

Ora che Funzioni di Azure v3 è stato ritirato, App Web statiche usa Funzioni di Azure v4 per il supporto del runtime dell'API per Python 3.8. Ridistribuire l'app per abilitare questa modifica. Sebbene non sia consigliabile, è possibile ripristinare la versione 3 impostando la variabile USEV3_FOR_PYTHON38 di ambiente su true.

I runtime seguenti sono deprecati in App Web statiche di Azure. Per altre informazioni sulla modifica del runtime, vedere Specificare la versione del runtime del linguaggio API in App Web statiche di Azure ed Eseguire la migrazione delle app da Funzioni di Azure versione 3.x alla versione 4.x.

.NET Core 3.1
Node.js 12.x

Condividi tramite