Esercizio - Pubblicare per la distribuzione dipendente dal framework

Completato

Le distribuzioni dipendenti dal framework sono l'impostazione predefinita per le app ASP.NET Core. Quando si pubblica un'app dipendente dal framework, nel pacchetto di distribuzione sono inclusi solo i file e le dipendenze dell'app. Il runtime .NET non è incluso. Per eseguire l'app, è necessario che nel computer di destinazione sia installata la versione corretta del runtime .NET.

Il responsabile del team ti ha chiesto di preparare l'app del tuo team per l'implementazione. Poiché il server in cui verrà eseguita l'app ha già installato il runtime .NET, è possibile pubblicare l'app come distribuzione dipendente dal framework. Ciò riduce le dimensioni del pacchetto di distribuzione e semplifica la distribuzione dell'app.

In questo esercizio si pubblica un'app ASP.NET Core come distribuzione dipendente dal framework.

Creare un'app ASP.NET Core

È necessaria un'app ASP.NET Core per svolgere il ruolo dell'app del team. Verrà ora creata una nuova app ASP.NET Core usando l'estensione C# Dev Kit in Visual Studio Code.

1. Avvia Visual Studio Code.

2. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.

3. Cercare e selezionare .NET New Project (Nuovo progetto .NET).

4. Cercare e selezionare ASP.NET Core Empty.

   

5. Selezionare o creare una cartella per il nuovo progetto.

6. Assegnare alla nuova app il nome MyWebApp.

7. Selezionare Crea progetto per creare il progetto.

Eseguire l'app

Provare l'app per assicurarsi che venga eseguita.

1. In Visual Studio Code premere F5 per compilare ed eseguire l'app.

   1. Quando richiesto, selezionare C# come debugger.
   2. Quando richiesto, selezionare C#: MyWebApp [Configurazione predefinita] come configurazione di avvio da usare.

   Questo comando avvia l'app e la ospita in un server Web locale. Viene visualizzata una finestra del browser e viene visualizzato "Hello, World!".

2. Chiudere la finestra del browser e arrestare l'app premendo MAIUSC+F5 in Visual Studio Code.

Pubblicare l'app come distribuzione dipendente dal framework

Dopo aver verificato che l'app viene eseguita correttamente, è possibile pubblicarla come distribuzione dipendente dal framework.

1. In Visual Studio Code premere CTRL+' per aprire la finestra del terminale.

2. Passare alla directory MyWebApp .

   cd MyWebApp
   

3. Eseguire il comando seguente per pubblicare l'app:

   dotnet publish -c Release -o publish-fd    
   

   Nel comando precedente:

   • -c Release specifica che l'app deve essere compilata in modalità di rilascio. In questo modo l'app viene ottimizzata per le prestazioni.
   • -o specifica il nome della directory di output. In questo caso, la directory di output sarà denominata publish-fd.

   Questo comando pubblica l'app come distribuzione dipendente dal framework nella directory publish-fd .

4. Nella finestra Esplora risorse di Visual Studio Code espandere il contenuto della directory MyWebApp/publish-fd e visualizzare l'elenco dei file. La directory include i file e le dipendenze dell'app, ma non il runtime .NET o i file di codice sorgente. Alcuni dei file e delle directory inclusi sono:

   • MyWebApp.dll'**: L'app compilata.
   • Altri file MyWebApp. : file aggiuntivi necessari per eseguire l'app.
   • appsettings.json: file di configurazione per l'app.
   • web.config: file di configurazione per IIS (Internet Information Services) in Windows.
   • wwwroot: quando presente, questa directory contiene asset Web statici pubblicati, ad esempio file HTML, CSS e JavaScript. Questa directory non viene generata se il progetto non contiene asset Web statici, quindi non è presente in questo caso.

5. Passare alla directory publish-fd ed eseguire l'app.

   cd publish-fd
   dotnet MyWebApp.dll
   

   Questo comando avvia l'app pubblicata e la ospita in Kestrel. I Web browser che si connettono all'app visualizzano la stessa pagina di benvenuto predefinita ASP.NET Core.

6. Chiudere il Web browser e arrestare l'app premendo CTRL+C nella finestra del terminale.