Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Utilizzo della piattaforma .NET di
La piattaforma AWS App Runner .NET fornisce runtime gestiti. Ogni runtime semplifica la creazione e l'esecuzione di contenitori con applicazioni Web basate su una versione.NET. Quando si utilizza un runtime .NET, App Runner si avvia con un'immagine di runtime .NET gestita. Questa immagine è basata sull'immagine Docker di Amazon Linux
Si specifica un runtime per il servizio App Runner quando si crea un servizio utilizzando la console App Runner o l'CreateServiceoperazione API. Puoi anche specificare un runtime come parte del codice sorgente. Usa la runtime
parola chiave in un file di configurazione di App Runner che includi nel tuo repository di codice. La convenzione di denominazione di un runtime gestito è. <language-name><major-version>
Per i nomi e le versioni di runtime di.NET validi, vedere. NETinformazioni sulla versione in fase di esecuzione.
App Runner aggiorna il runtime del servizio alla versione più recente a ogni distribuzione o aggiornamento del servizio. Se l'applicazione richiede una versione specifica di un runtime gestito, è possibile specificarla utilizzando la runtime-version
parola chiave nel file di configurazione di App Runner. È possibile utilizzare qualsiasi livello di versione, inclusa una versione principale o secondaria. App Runner effettua solo aggiornamenti di livello inferiore al runtime del servizio.
Sintassi della versione per i runtime.NET: major
[.minor
[.patch
]]
Ad esempio: 6.0.9
Gli esempi seguenti mostrano il blocco della versione:
-
6.0
— Blocca le versioni principali e secondarie. App Runner aggiorna solo le versioni patch. -
6.0.9
— Blocca a una versione di patch specifica. App Runner non aggiorna la versione di runtime.
Argomenti
Configurazione del runtime di.NET
Quando scegli un runtime gestito, devi anche configurare, come minimo, creare ed eseguire comandi. Li configuri durante la creazione o l'aggiornamento del servizio App Runner. Puoi farlo utilizzando uno dei seguenti metodi:
-
Utilizzo della console App Runner: specifica i comandi nella sezione Configure build del processo di creazione o della scheda di configurazione.
-
Utilizzo dell'API App Runner: richiama l'operazione CreateServiceor UpdateServiceAPI. Specificate i comandi utilizzando i
StartCommand
membriBuildCommand
e del tipo di CodeConfigurationValuesdati. -
Utilizzo di un file di configurazione: specifica uno o più comandi di compilazione in un massimo di tre fasi di compilazione e un singolo comando di esecuzione che serve per avviare l'applicazione. Sono disponibili impostazioni di configurazione opzionali aggiuntive.
Fornire un file di configurazione è facoltativo. Quando crei un servizio App Runner utilizzando la console o l'API, specifichi se App Runner ottiene le impostazioni di configurazione direttamente al momento della creazione o da un file di configurazione.
Esempi di runtime di.NET
Gli esempi seguenti mostrano i file di configurazione di App Runner per la creazione e l'esecuzione di un servizio.NET. L'ultimo esempio è il codice sorgente di un'applicazione.NET completa che è possibile distribuire su un servizio di runtime.
Nota
La versione di runtime utilizzata in questi esempi è la 6.0.9
. Puoi sostituirla con una versione che desideri utilizzare. Per la versione di runtime di.NET più recente supportata, vedi. NETinformazioni sulla versione in fase di esecuzione.
Questo esempio mostra un file di configurazione minimo che è possibile utilizzare con un runtime gestito.NET. Per le ipotesi che App Runner fa con un file di configurazione minimo, vedi. Esempi di file di configurazione
Esempio apprunner.yaml
version: 1.0 runtime: dotnet6 build: commands: build: - dotnet publish -c Release -o out run: command: dotnet out/HelloWorldDotNetApp.dll
Questo esempio mostra l'uso di tutte le chiavi di configurazione con un runtime gestito.NET.
Nota
La versione di runtime utilizzata in questi esempi è la 6.0.9
. Puoi sostituirla con una versione che desideri utilizzare. Per la versione di runtime di.NET più recente supportata, vedi. NETinformazioni sulla versione in fase di esecuzione.
Esempio apprunner.yaml
version: 1.0 runtime: dotnet6 build: commands: pre-build: - scripts/prebuild.sh build: - dotnet publish -c Release -o out post-build: - scripts/postbuild.sh env: - name: MY_VAR_EXAMPLE value: "example" run: runtime-version:
6.0.9
command: dotnet out/HelloWorldDotNetApp.dll network: port: 5000 env: APP_PORT env: - name: ASPNETCORE_URLS value: "http://*:5000"
Questo esempio mostra il codice sorgente di un'applicazione.NET completa che è possibile distribuire su un servizio di runtime.
Nota
-
Esegui il comando seguente per creare una semplice app web.NET 6:
dotnet new web --name HelloWorldDotNetApp -f net6.0
-
Aggiungi il
apprunner.yaml
all'app web.NET 6 creata.
Esempio HelloWorldDotNetApp
version: 1.0 runtime: dotnet6 build: commands: build: - dotnet publish -c Release -o out run: command: dotnet out/HelloWorldDotNetApp.dll network: port: 5000 env: APP_PORT env: - name: ASPNETCORE_URLS value: "http://*:5000"