Containerizzazione e migrazione delle app ASP.NET a Servizio app di Azure

Questo articolo illustra come inserire in contenitori ASP.NET applicazioni ed eseguirne la migrazione al servizio app di Azure usando lo strumento Azure Migrate App Containerization. Il processo di containerizzazione non richiede l'accesso alla codebase e offre un modo semplice per inserire in contenitori le applicazioni esistenti. Lo strumento funziona usando lo stato di esecuzione delle applicazioni in un server per determinare i componenti dell'applicazione. Consente quindi di creare un pacchetto in un'immagine del contenitore. È possibile distribuire l'applicazione in contenitori nel Servizio app di Azure.

Lo strumento di containerizzazione delle applicazioni di Azure Migrate attualmente supporta:

• Containerizzazione delle app ASP.NET e relativa distribuzione in contenitori Windows nel Servizio app di Azure.
• Containerizzazione delle app ASP.NET e relativa distribuzione in contenitori Windows nel servizio Azure Kubernetes. Altre informazioni su questo scenario di containerizzazione.
• Containerizzazione delle app Web Java in Apache Tomcat (nei server Linux) e relativa distribuzione in contenitori Linux nel servizio Azure Kubernetes. Altre informazioni su questo scenario di containerizzazione.
• Containerizzazione delle app Web Java in Apache Tomcat (nei server Linux) e relativa distribuzione in contenitori Linux nel Servizio app di Azure. Altre informazioni su questo scenario di containerizzazione.

Lo strumento Containerizzazione delle applicazioni consente di:

• Individuare i componenti dell'applicazione. Lo strumento si connette in remoto ai server applicazioni che eseguono l'applicazione ASP.NET e individua i componenti dell'applicazione. Crea un Dockerfile che è possibile usare per creare un'immagine del contenitore per l'applicazione.
• Compilare l'immagine del contenitore. È possibile esaminare e personalizzare ulteriormente il Dockerfile in base ai requisiti dell'applicazione e usarlo per compilare l'immagine del contenitore dell'applicazione. Viene eseguito il push dell'immagine del contenitore dell'applicazione in un registro Azure Container specificato.
• Distribuire in Servizio app di Azure. Lo strumento genera quindi i file di distribuzione necessari per distribuire l'applicazione in contenitori nel Servizio app di Azure.

Non tutte le applicazioni trarranno vantaggio da un passaggio diretto ai contenitori senza essere sottoposte a una notevole riprogettazione. Tuttavia, alcuni dei vantaggi dello spostamento di app esistenti in contenitori senza riscrittura includono:

• Miglioramento dell'utilizzo dell'infrastruttura. Quando si usano i contenitori, più applicazioni possono condividere risorse ed essere ospitate nella stessa infrastruttura. Questo consente di consolidare l'infrastruttura e migliorare l'utilizzo.
• Gestione semplificata. Ospitando le applicazioni in piattaforme gestite moderne come il servizio Azure Kubernetes e il Servizio app di Azure, è possibile semplificare le procedure di gestione. È possibile ottenere questa semplificazione ritirando o riducendo i processi di gestione e manutenzione dell'infrastruttura che tradizionalmente si eseguono in un'infrastruttura di proprietà.
• Portabilità dell'applicazione. Con la crescente adozione e standardizzazione delle piattaforme e dei formati di specifica dei contenitori, la portabilità delle applicazioni non rappresenta più un problema.
• Adottare la gestione moderna usando DevOps. L'uso di contenitori consente di adottare e standardizzare procedure moderne per la gestione e la sicurezza e la transizione a DevOps.

Questa esercitazione illustra come:

Prerequisiti

Prima di iniziare questa esercitazione, è necessario:

Preparare un account utente Azure

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Dopo aver configurato la sottoscrizione, è necessario un account utente di Azure con:

• Autorizzazioni di proprietario nella sottoscrizione di Azure.
• Autorizzazioni per registrare le app Microsoft Entra.

Se è appena stato creato un account Azure gratuito, si è proprietari della propria sottoscrizione. Se non si ha il ruolo di proprietario della sottoscrizione, collaborare con il proprietario per assegnare le autorizzazioni nel modo seguente:

1. Nel portale di Azure cercare "sottoscrizioni". In Servizi selezionare Sottoscrizioni:

   

2. Nella pagina Sottoscrizioni selezionare la sottoscrizione in cui si vuole creare un progetto di Azure Migrate.

3. Nel riquadro sinistro della sottoscrizione selezionare Controllo di accesso (IAM).

4. Nella scheda Controlla accesso cercare l'account utente pertinente.

5. In Aggiungi un'assegnazione di ruolo selezionare Aggiungi:

   

6. Nella pagina Aggiungi assegnazione di ruolo selezionare il ruolo Proprietario e quindi selezionare l'account (azmigrateuser nell'esempio). Selezionare quindi Salva.

   

   L'account Azure deve anche disporre delle autorizzazioni per registrare le app Microsoft Entra.

7. Nel portale di Azure, andare su Microsoft Entra ID>Utenti>Impostazioni utente.

8. In Impostazioni utente verificare che gli utenti di Microsoft Entra possano registrare le applicazioni. Questa opzione è impostata su Sì per impostazione predefinita.

   

   Importante

   Microsoft consiglia di usare i ruoli con minori autorizzazioni. Ciò consente di migliorare la sicurezza dell'organizzazione. L'amministratore globale è un ruolo con privilegi elevati che deve essere limitato agli scenari di emergenza quando non è possibile usare un ruolo esistente.

9. Se l'opzione Registrazioni app è impostata su No, chiedere all'amministratore tenant/globale di assegnare l'autorizzazione richiesta. In alternativa, l'amministratore tenant/globale può assegnare il ruolo Sviluppatore applicazione a un account per consentire la registrazione di app Microsoft Entra. Per altre informazioni, vedere Assegnare ruoli agli utenti.

Scaricare e installare lo strumento Containerizzazione delle applicazioni di Azure Migrate

1. Scarica il programma di installazione della containerizzazione delle app di Azure Migrate in un computer Windows.

2. Aprire PowerShell in modalità amministratore e modificare la directory di PowerShell nella cartella che contiene il programma di installazione.

3. Eseguire lo script di installazione usando questo comando:

   .\AppContainerizationInstaller.ps1
   

Aprire lo strumento Containerizzazione delle applicazioni

1. Aprire un browser in qualsiasi computer in grado di connettersi al computer Windows che esegue lo strumento Containerizzazione delle applicazioni. Vai all'URL dello strumento: https://nome della macchina o indirizzo IP:44369.

   In alternativa, è possibile aprire l'app dal desktop usando il relativo collegamento.

2. Se viene visualizzato un avviso che indica che la connessione non è privata, selezionare Avanzate e continuare con il sito Web. Questo avviso compare quando l'interfaccia Web usa un certificato TLS/SSL autofirmato.

3. Nella schermata di accesso usare l'account amministratore locale del computer per accedere.

4. Selezionare ASP.NET app Web come tipo di applicazione da inserire in contenitori.

5. Nell'elenco Servizio di Azure di destinazione selezionare Contenitori nel servizio app di Azure:

   

Completare i prerequisiti dello strumento

1. Accettare le condizioni di licenza e leggere le informazioni di terze parti.
2. Nell'app Web strumento Configurare i prerequisiti completare questi passaggi:

   • Connettività. Lo strumento verifica se il computer Windows dispone dell'accesso a Internet. Se il computer usa un proxy:

     1. Selezionare Configura proxy per specificare l'indirizzo proxy (nel formato indirizzo IP o FQDN) e la porta di ascolto.

     2. Se il proxy richiede l'autenticazione, specificare le credenziali.

     3. Se sono stati aggiunti i dettagli del proxy o disabilitato il proxy o l'autenticazione, selezionare Salva per attivare di nuovo il controllo della connettività.

     È supportato solo il proxy HTTP.

   • Installare gli aggiornamenti. Lo strumento verifica automaticamente la disponibilità degli aggiornamenti più recenti e li installa. È anche possibile installare manualmente la versione più recente dello strumento.

   • Installare lo Strumento di distribuzione Web Microsoft. Lo strumento verifica che lo Strumento di distribuzione Web Microsoft sia installato nel computer Windows che esegue lo strumento Containerizzazione delle applicazioni di Azure Migrate.

   • Abilitare la comunicazione remota di PowerShell. Lo strumento inviterà l'utente a verificare che la comunicazione remota di PowerShell sia abilitata nei server applicazioni che eseguono le applicazioni ASP.NET da inserire in contenitori.

Accedere ad Azure

1. Selezionare Accedi per accedere all'account Azure.

   Per eseguire l'autenticazione con Azure, è necessario un codice del dispositivo. Se si seleziona Accedi , verrà aperta una finestra contenente il codice del dispositivo. Se la finestra non viene visualizzata, verificare di aver disabilitato il blocco popup nel browser.

2. Selezionare Copia codice e Accedi per copiare il codice del dispositivo e aprire una richiesta di accesso di Azure in una nuova scheda del browser:

   

3. Nella nuova scheda incollare il codice del dispositivo e completare l'accesso usando le credenziali dell'account Azure. Dopo aver eseguito l'accesso, è possibile chiudere la scheda del browser e tornare all'interfaccia Web dello strumento Containerizzazione delle applicazioni.

4. Selezionare il tenant di Azure che si vuole usare.

5. Specificare la sottoscrizione di Azure da usare.

Individuare le applicazioni ASP.NET

Lo strumento Containerizzazione delle applicazioni si connette in remoto ai server applicazioni usando le credenziali fornite e tenta di individuare le applicazioni ASP.NET ospitate nei server applicazioni.

1. Specificare l'indirizzo IP del server/FQDN e le credenziali del server che esegue l'applicazione ASP.NET che deve essere usata per connettersi in remoto al server per l'individuazione delle applicazioni.

   • Le credenziali specificate devono essere per un amministratore locale (Windows) nel server applicazioni.
   • Per gli account di dominio (l'utente deve essere un amministratore nel server applicazioni), anteporre il nome utente con il nome di dominio in questo formato: <domain\user name>.
   • Per gli account locali (l'utente deve essere un amministratore sul server dell'applicazione), anteporre al nome utente il nome host in questo formato: <nome host\nome utente>.
   • È possibile eseguire l'individuazione delle applicazioni per un massimo di cinque server alla volta.

2. Selezionare Convalida per verificare che il server applicazioni sia raggiungibile dal computer che esegue lo strumento e che le credenziali siano valide. Al termine della convalida, la colonna Stato mostrerà lo stato mappato:

   

3. Selezionare Continua per avviare l'individuazione delle applicazioni nei server applicazioni selezionati.

4. Al termine dell'individuazione delle applicazioni, selezionare le applicazioni da inserire in contenitori:

   

5. Specificare un nome per il contenitore di destinazione per ogni applicazione selezionata. Specificare il nome del contenitore come <name:tag>, dove viene usato il tag per l'immagine del contenitore. Ad esempio, è possibile specificare il nome del contenitore di destinazione come nomeapp:v1.

Parametrizzare le configurazioni dell'applicazione

La parametrizzazione della configurazione la rende disponibile come parametro deploy-time. La parametrizzazione consente di configurare un'impostazione quando si distribuisce l'applicazione anziché impostarla come hardcoded in un valore specifico nell'immagine del contenitore. Questa opzione, ad esempio, è utile per parametri come le stringhe di connessione di database.

1. Selezionare configurazioni dell'app per esaminare le configurazioni rilevate.

2. Selezionare i parametri da parametrizzare e quindi selezionare Applica:

   

Esternalizzare le dipendenze del file system

È possibile aggiungere altre cartelle usate dall'applicazione. Specificare se devono far parte dell'immagine del contenitore o se devono essere esternalizzate all'archiviazione permanente tramite la condivisione file di Azure. L'uso dell'archiviazione permanente esterna è ideale per le applicazioni con stato che archiviano lo stato all'esterno del contenitore o hanno altro contenuto statico archiviato nel file system.

1. Selezionare Modifica in Cartelle applicazione per esaminare le cartelle dell'applicazione rilevate. Queste cartelle sono state identificate come artefatti obbligatori necessari per l'applicazione. Verranno copiati nell'immagine del contenitore.

2. Selezionare Aggiungi cartella e specificare i percorsi di cartella da aggiungere.

3. Per aggiungere più cartelle allo stesso volume, separare i valori con virgole.

4. Selezionare Condivisione file di Azure come opzione di archiviazione se si vuole archiviare le cartelle all'esterno del contenitore nell'archiviazione permanente.

5. Selezionare Salva dopo aver esaminato le cartelle dell'applicazione:

   

6. Selezionare Continua per passare alla fase di compilazione dell'immagine del contenitore.

Compilare l'immagine del contenitore

1. Nell'elenco a discesa selezionare un Registro Azure Container che verrà usato per compilare e archiviare le immagini del contenitore per le app. È possibile usare un registro Azure Container esistente o crearne uno nuovo selezionando Crea nuovo registro:

   

   Nota

   Vengono visualizzati solo i registri contenitori di Azure con l'account utente amministratore abilitato. L'account utente amministratore è attualmente necessario per distribuire un'immagine da un Registro Azure Container al Servizio app di Azure. Per altre informazioni, vedere Eseguire l'autenticazione con un registro Azure Container.

2. I Dockerfile necessari per compilare le immagini del contenitore per ogni applicazione selezionata vengono generati all'inizio del passaggio di compilazione. Selezionare Rivedi per esaminare il Dockerfile. È anche possibile aggiungere tutte le personalizzazioni necessarie al Dockerfile nel passaggio di revisione e salvare le modifiche prima di avviare il processo di compilazione.

3. Selezionare le applicazioni per cui si vogliono compilare immagini e quindi selezionare Compila. Selezionando Compila verrà avviata la compilazione dell'immagine del contenitore per ogni applicazione. Lo strumento monitora lo stato della compilazione e consente di continuare con il passaggio successivo al termine della compilazione.

4. È possibile monitorare lo stato di avanzamento della compilazione selezionando Build in Progress (Compila in corso ) nella colonna stato. Il collegamento si attiverà un paio di minuti dopo l'attivazione del processo di compilazione.

5. Al termine della compilazione, selezionare Continua per specificare le impostazioni di distribuzione:

   

Distribuire l'app in contenitori nel servizio app di Azure

Dopo aver compilato l'immagine del contenitore, il passaggio successivo consiste nel distribuire l'applicazione come contenitore nel servizio app di Azure.

1. Selezionare il piano di Servizio app di Azure che deve essere usato dall'applicazione.

   Se non si ha un piano di servizio app o si vuole creare un nuovo piano di servizio app da usare, è possibile crearne uno selezionando Crea nuovo piano di servizio app.

2. Selezionare Continua dopo aver selezionato il piano di servizio app.

3. Se le configurazioni dell'applicazione sono state parametrizzate, specificare l'archivio di segreti da usare per l'applicazione. È possibile scegliere Azure Key Vault o le impostazioni applicazione del Servizio app di Azure per la gestione dei segreti dell'applicazione. Per altre informazioni, vedere Configurare le stringhe di connessione.

   • Se sono state selezionate le impostazioni dell'applicazione del servizio app per gestire i segreti, selezionare Continua.
   • Se si desidera utilizzare un Azure Key Vault per gestire i segreti dell'applicazione, specificare il Key Vault che si desidera utilizzare.
     • Se non si ha un insieme di credenziali delle chiavi di Azure o si vuole creare un nuovo insieme di credenziali delle chiavi, è possibile crearne uno selezionando Crea nuovo insieme di credenziali delle chiavi di Azure.
     • Lo strumento assegnerà automaticamente le autorizzazioni necessarie per la gestione dei segreti tramite l'insieme di credenziali delle chiavi.

4. Se sono state aggiunte altre cartelle e si è selezionata l'opzione condivisione file per l'archiviazione permanente, specificare la condivisione file di Azure da usare nello strumento di Containerizzazione delle applicazioni durante la distribuzione. Lo strumento copia le cartelle dell'applicazione configurate per File di Azure e le monta nel contenitore dell'applicazione durante la distribuzione. 

   Se non si ha una condivisione file di Azure o si vuole creare una nuova condivisione file di Azure, è possibile crearne una selezionando Crea nuovo account di archiviazione e condivisione file.

5. È ora necessario specificare la configurazione della distribuzione per l'applicazione. Selezionare Configura per personalizzare la distribuzione per l'applicazione. Nel passaggio di configurazione è possibile fornire le personalizzazioni seguenti:

   • Nome. Specificare un nome dell'app univoco per l'applicazione. Questo nome verrà usato per generare l'URL dell'applicazione. Verrà usato anche come prefisso per altre risorse create come parte della distribuzione.
   • Configurazione dell'applicazione. Per tutte le configurazioni applicazione parametrizzate, specificare i valori da usare per la distribuzione corrente.
   • Configurazione dell'archiviazione. Esaminare le informazioni relative a tutte le cartelle dell'applicazione configurate per l'archiviazione permanente.

   

6. Dopo il salvataggio della configurazione di distribuzione per l'applicazione, lo strumento genererà il file YAML di distribuzione Kubernetes per l'applicazione.

   • Selezionare Rivedi per esaminare la configurazione della distribuzione per le applicazioni.

   • Selezionare le applicazioni da distribuire.

   • Selezionare Distribuisci per avviare la distribuzione per le applicazioni selezionate.

     

   • Dopo la distribuzione dell'applicazione, è possibile selezionare la colonna Stato distribuzione per tenere traccia delle risorse distribuite per l'applicazione.

Risoluzione dei problemi

Per risolvere i problemi con lo strumento Containerizzazione delle applicazioni, è possibile esaminare i file di log nel computer Windows che esegue lo strumento. I file di log per lo strumento si trovano in C:\ProgramData\Microsoft Azure Migrate App Containerization\Logs.

Passaggi successivi

• Containerizzazione delle applicazioni Web ASP.NET e distribuzione sui container Windows nell'Azure Kubernetes Service (AKS)
• Containerizzazione delle app Web Java su Apache Tomcat (su server Linux) e distribuzione su contenitori Linux su AKS (Azure Kubernetes Service)
• Containerizzazione di app Web Java in Apache Tomcat (in server Linux) e distribuzione in contenitori Linux nel servizio app