Utilizzo della piattaforma .NET di - AWS App Runner

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 e contiene il pacchetto di runtime per una versione di.NET e alcuni strumenti e pacchetti di dipendenze popolari. App Runner utilizza questa immagine di runtime gestita come immagine di base e aggiunge il codice dell'applicazione per creare un'immagine Docker. Quindi distribuisce questa immagine per eseguire il servizio Web in un contenitore.

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.

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 membri BuildCommand 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"