View a markdown version of this page

QuickStart: Distribuisci un'applicazione .NET Core su Windows su Elastic Beanstalk - AWS Elastic Beanstalk
Il tuo AWS accountPrerequisitiPassaggio 1: creare un'applicazione .NET Core su WindowsPassaggio 2: esegui l'applicazione localmenteFase 3: Distribuisci la tua applicazione.NET Core su Windows con l'interfaccia a riga di comando di EBFase 4: Esegui l'applicazione su Elastic BeanstalkFase 5: rimozioneAWS risorse per la tua applicazioneFasi successiveEsegui l'implementazione con la console

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à.

QuickStart: Distribuisci un'applicazione .NET Core su Windows su Elastic Beanstalk

Questo QuickStart tutorial illustra il processo di creazione di un'applicazione .NET Core su Windows e la sua distribuzione in un AWS Elastic Beanstalk ambiente.

Non per uso in produzione

Gli esempi sono solo a scopo dimostrativo. Non utilizzare applicazioni di esempio in produzione.

Il tuo AWS account

Se non sei già un AWS cliente, devi creare un AWS account. La registrazione ti consente di accedere a Elastic Beanstalk e agli altri AWS servizi di cui hai bisogno.

Se hai già un AWS account, puoi passare a. Prerequisiti

Registrati per un Account AWS

Per iniziare AWS, hai bisogno di un Account AWS. Per informazioni sulla creazione di un Account AWS, vedere Guida introduttiva a Account AWS nella Guida Gestione dell’account AWS di riferimento.

Prerequisiti

Per seguire le procedure in questa guida, devi usare un terminale a riga di comando o una shell per eseguire i comandi. I comandi vengono visualizzati in elenchi preceduti dal simbolo del prompt (>) e dal nome della directory corrente, se appropriato.

C:\eb-project> this is a command
this is output

CLI EB

Questo tutorial utilizza l'interfaccia a riga di comando di Elastic Beanstalk (CLI EB). Per istruzioni dettagliate su come configurare e utilizzare la CLI EB, consulta Installa EB CLI con lo script di configurazione (consigliato) e Configurazione dell'interfaccia a riga di comando EB.

.NET Core su Windows

Se non hai installato .NET SDK sul tuo computer locale, puoi installarlo seguendo il link Download.NET sul sito Web della documentazione.NET.

Verifica l'installazione di .NET SDK eseguendo il comando seguente.

C:\> dotnet --info

Passaggio 1: creare un'applicazione .NET Core su Windows

Crea una directory di progetto.

C:\> mkdir eb-dotnetcore
C:\> cd eb-dotnetcore

Quindi, crea un'applicazione di servizio web RESTful Hello World di esempio eseguendo i seguenti comandi.

C:\eb-dotnetcore> dotnet new web --name HelloElasticBeanstalk
C:\eb-dotnetcore> cd HelloElasticBeanstalk

Passaggio 2: esegui l'applicazione localmente

Esegui il seguente comando per eseguire l'applicazione localmente.

C:\eb-dotnetcore\HelloElasticBeasntalk> dotnet run

L'output dovrebbe assomigliare al testo seguente.

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:7222
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5228
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\Users\Administrator\eb-dotnetcore\HelloElasticBeanstalk
Nota

Il dotnet comando seleziona una porta a caso quando l'applicazione viene eseguita localmente. In questo esempio la porta è 5228. Quando si distribuisce l'applicazione nell'ambiente Elastic Beanstalk, l'applicazione verrà eseguita sulla porta 5000.

Inserisci l'indirizzo URL http://localhost:port nel tuo browser web. Per questo esempio specifico, il comando èhttp://localhost:5228. Il browser web dovrebbe visualizzare «Hello World!».

Fase 3: Distribuisci la tua applicazione.NET Core su Windows con l'interfaccia a riga di comando di EB

Esegui i seguenti comandi per creare un ambiente Elastic Beanstalk per questa applicazione.

Per creare un ambiente e distribuire l'applicazione .NET Core su Windows

  1. Esegui i seguenti comandi nella HelloElasticBeanstalk directory per pubblicare e comprimere l'applicazione.

    C:\eb-dotnetcore\HelloElasticBeasntalk> dotnet publish -o site
C:\eb-dotnetcore\HelloElasticBeasntalk> cd site
C:\eb-dotnetcore\HelloElasticBeasntalk\site> Compress-Archive -Path * -DestinationPath ../site.zip
C:\eb-dotnetcore\HelloElasticBeasntalk\site> cd ..

  2. Create un nuovo file nella HelloElasticBeanstalk chiamata aws-windows-deployment-manifest.json con i seguenti contenuti: 

    {
    "manifestVersion": 1,
    "deployments": {
        "aspNetCoreWeb": [
        {
            "name": "test-dotnet-core",
            "parameters": {
                "appBundle": "site.zip",
                "iisPath": "/",
                "iisWebSite": "Default Web Site"
            }
        }
        ]
    }
}

  3. Inizializza il repository della CLI EB con il comando eb init.

    C:\eb-dotnetcore\HelloElasticBeasntalk> eb init -p iis dotnet-windows-server-tutorial --region us-east-2

    Questo comando crea un'applicazione denominata dotnet-windows-server-tutorial e configura il repository locale per creare ambienti con la versione più recente della piattaforma server Windows.

  4. Crea un ambiente e distribuisci in esso l'applicazione con eb create: Elastic Beanstalk crea automaticamente un file zip per l'applicazione e lo avvia sulla porta 5000.

    C:\eb-dotnetcore\HelloElasticBeasntalk> eb create dotnet-windows-server-env

    Elastic Beanstalk impiega circa cinque minuti per creare il tuo ambiente.

Fase 4: Esegui l'applicazione su Elastic Beanstalk

Una volta completato il processo di creazione del tuo ambiente, apri il tuo sito web con. eb open

C:\eb-dotnetcore\HelloElasticBeasntalk> eb open

Complimenti! Hai implementato un'applicazione .NET Core su Windows con Elastic Beanstalk! Si aprirà una finestra del browser che utilizza il nome di dominio creato per l'applicazione.

Fase 5: rimozione

Puoi terminare il tuo ambiente quando hai finito di lavorare con l'applicazione. Elastic Beanstalk interrompe tutte le AWS risorse associate all'ambiente.

Per terminare l'ambiente Elastic Beanstalk con l'EB CLI, esegui il seguente comando.

C:\eb-dotnetcore\HelloElasticBeasntalk> eb terminate

AWS risorse per la tua applicazione

Hai appena creato un'applicazione a istanza singola. Si tratta di una semplice applicazione di esempio con una singola istanza EC2, quindi non richiede il bilanciamento del carico o il ridimensionamento automatico. Per le applicazioni a istanza singola Elastic Beanstalk crea le seguenti risorse: AWS

  • Istanza EC2: una macchina virtuale di Amazon EC2 configurata per eseguire applicazioni Web sulla piattaforma selezionata.

    Ogni piattaforma esegue un insieme diverso di software, file di configurazione e script per supportare una versione della lingua, un framework, un container Web specifici o una determinata combinazione di tutti questi elementi. La maggior parte delle piattaforme utilizza Apache o nginx come proxy inverso che elabora il traffico web su cui viene eseguita l'app Web, inoltra le richieste all'app, fornisce asset statici e genera log degli accessi e di errore.

  • Gruppo di sicurezza istanze: un gruppo di sicurezza di Amazon EC2 configurato per abilitare il traffico in entrata sulla porta 80. Questa risorsa consente al traffico TTP proveniente dal load balancer di raggiungere l'istanza EC2 in esecuzione sull'app Web. Per impostazione predefinita, il traffico non è consentito su altre porte.

  • Bucket Amazon S3: posizione di storage per il codice sorgente, i log e altri artefatti creati quando si utilizza Elastic Beanstalk.

  • CloudWatch Allarmi Amazon: due CloudWatch allarmi che monitorano il carico sulle istanze nel tuo ambiente e vengono attivati se il carico è troppo alto o troppo basso. Quando viene attivato un allarme, il gruppo Auto Scaling aumenta o diminuisce di conseguenza.

  • CloudFormation stack: Elastic Beanstalk utilizza CloudFormation per avviare le risorse nel tuo ambiente e propagare le modifiche alla configurazione. Le risorse sono definite in un modello, visualizzabile nella console CloudFormation.

  • Nome di dominio: un nome di dominio che reindirizza alla tua app web nel modulo. subdomain region.elasticbeanstalk.com.

Elastic Beanstalk gestisce tutte queste risorse. Quando arresti l'ambiente, Elastic Beanstalk termina tutte le risorse che contiene.

Fasi successive

Quando disponi di un'applicazione in esecuzione in un ambiente, puoi distribuire una nuova versione dell'applicazione o un'applicazione diversa in qualsiasi momento. La distribuzione di una nuova versione dell'applicazione è molto veloce perché non richiede il provisioning o il riavvio delle istanze EC2. Puoi anche esplorare il tuo nuovo ambiente utilizzando la console Elastic Beanstalk. Per i passaggi dettagliati, consulta Esplora il tuo ambiente nel capitolo Guida introduttiva di questa guida.

Prova altri tutorial

Se desideri provare altri tutorial con diverse applicazioni di esempio, consulta. QuickStart per ASP.NET

Dopo aver distribuito una o due applicazioni di esempio e essere pronti per iniziare a sviluppare ed eseguire .NET Core su applicazioni Windows in locale, consulta Configurazione dell'ambiente di sviluppo .NET

Esegui l'implementazione con la console Elastic Beanstalk

Puoi anche utilizzare la console Elastic Beanstalk per avviare l'applicazione di esempio. Per i passaggi dettagliati, consulta Creare un'applicazione di esempio nel capitolo Guida introduttiva di questa guida.