Esegui il replatforming delle applicazioni Linux nei container

L'integrazione di Migrate to Containers con Cloud Code ti consente di modernizzare i componenti delle applicazioni Linux eseguiti su macchine virtuali (VM) e generare artefatti che possono essere implementati in Google Kubernetes Engine e Cloud Run, direttamente nel tuo IDE, utilizzando una macchina Linux.

In questa guida imparerai come eseguire il replatforming di un'applicazione esistente in un container GKE utilizzando l'estensione Cloud Code nel tuo IDE su una macchina Linux.

Questa guida è rivolta agli sviluppatori su una macchina Linux che hanno una conoscenza pratica di VS Code, conoscono Google Cloude hanno una VM che esegue il componente dell'applicazione.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Google Kubernetes Engine API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Google Kubernetes Engine API.

   Enable the API

8. Se non l'hai ancora fatto, installa l'estensione Cloud Code.
9. Crea e configura un cluster GKE.
10. Assicurati di sapere quale tipo di migrazione vuoi eseguire. Per ulteriori informazioni sui workload supportati, consulta Esaminare le versioni di Kubernetes, i workload e i sistemi operativi compatibili.
11. Prepara le macchine di origine e locali per la modernizzazione. Cloud Code supporta solo Linux per la modernizzazione.

Aggiungere un'origine di ripiattaforma

In questa sezione, se non l'hai già fatto, installa l'interfaccia a riga di comando del client predittivo del Centro di migrazione (mcdc) e altri strumenti di Migrate to Containers sulla tua macchina locale e aggiungi un'origine di ripiattaforma seguendo questi passaggi:

1. Nella barra delle attività dell'IDE, fai clic su Cloud Code e poi espandi Explorer di Replatform Apps.

2. Se è la prima volta che utilizzi Migrate to Containers in Cloud Code, devi installare l'interfaccia a riga di comando mcdc e altri strumenti di Migrate to Containers sulla tua macchina locale facendo clic su Installa strumenti. In caso contrario, procedi al passaggio successivo.

3. Fai clic su Modifica fonti. Si apre un file mcdc-sources.json vuoto. Aggiungi le fonti nel seguente formato:

   [
     {
       "title": "SOURCE_NAME",
       "host": "HOSTNAME",
       "user": "USER",
       "identityFile":"IDENTITY-FILE-PATH"
     }
   ]
   

4. Per visualizzare le origini in Explorer Esegui il re-platforming delle app, tieni il puntatore su Explorer Esegui il re-platforming delle app e fai clic sul pulsante Ricarica origini memorizzato nella cache visualizzato.

(Facoltativo) Generare una valutazione di idoneità

Prima di tentare di eseguire il replatforming dell'applicazione in un container, ti consigliamo di generare una valutazione dell'idoneità dell'origine, che ti avvisa se l'origine è in grado di eseguire il replatforming di un container.

Per generare una valutazione dell'idoneità della fonte, fai clic con il tasto destro del mouse sulla fonte e seleziona Valuta fonte. Si apre il terminale nell'IDE e vengono visualizzati i log della valutazione della sorgente.

Al termine della valutazione, mcdc genera un report di valutazione di Fit nell'IDE.

Se le tue fonti sono segnalate come Idonee, puoi eseguire il replatforming della tua applicazione.

Eseguire il re-platforming dell'applicazione

Cloud Code crea uno spazio di lavoro dedicato per ogni riassegnazione della piattaforma e ti consente di eseguire le attività Copia, Analizza e Genera nello spazio di lavoro per automatizzare i passaggi di riassegnazione della piattaforma. Se esegui l'attività Genera senza prima eseguire le attività Copia e Analizza, queste vengono eseguite automaticamente prima di generare gli artefatti.

Le sezioni seguenti ti guidano nell'esecuzione di ciascuna di queste attività e nel riassegnare la tua applicazione a un container utilizzando Cloud Code.

Per scoprire di più sul ciclo di vita di una migrazione, consulta la sezione Architettura dell'interfaccia a riga di comando di Migrate to Containers.

Creare un nuovo workspace di ripiattaformizzazione

Prima di creare un nuovo workspace di ripiattaformizzazione, devi sapere quali parametri di migrazione selezionare per il tipo di migrazione. Per saperne di più sui parametri per ogni tipo di migrazione, consulta Creare un piano di migrazione.

Per creare un nuovo spazio di lavoro di replatform con artefatti nel tuo IDE:

1. In Esplora Esegui il replatforming delle app, fai clic con il tasto destro del mouse sull'origine di cui vuoi eseguire il replatforming, quindi fai clic su Esegui il replatforming.

2. Dall'elenco di opzioni visualizzato nel menu, seleziona un percorso di ripiattaformizzazione.

3. Seleziona una nuova directory dello spazio di lavoro in cui eseguire il replatforming dell'applicazione, fai clic su Ok e poi su Crea spazio di lavoro per il replatforming.

4. Seleziona i parametri di migrazione per il tipo di migrazione.

5. (Facoltativo) Se hai selezionato il tipo di migrazione WebSphere e vuoi utilizzare uno scanner binario, seleziona il file binaryAppScanner.jar.

   La generazione dello spazio di lavoro richiede alcuni secondi. Si apre la nuova directory dello spazio di lavoro in una nuova finestra dell'IDE.

Copiare i file dalla VM allo spazio di lavoro

Per copiare i file dalla VM allo spazio di lavoro nell'IDE, segui questi passaggi:

1. (Facoltativo) La CLI mcdc applica filtri per ridurre le dimensioni della copia, ma puoi modificare il file filters.txt per ridurre ulteriormente le dimensioni della copia. Per scoprire come ridurre le dimensioni della copia, consulta Ridurre le dimensioni del file system copiato.

2. Apri il riquadro dei comandi premendo Ctrl+Shift+P.

3. Cerca e seleziona Tasks: Run Task, quindi seleziona m2c: Copy. La copia dei file potrebbe richiedere alcuni minuti.

Analizza il file system della VM e genera un piano di migrazione

Per analizzare il file system della VM e generare un piano di migrazione, segui questi passaggi:

1. Apri il riquadro dei comandi premendo Ctrl+Shift+P.

2. Cerca e seleziona Attività: esegui attività, quindi seleziona m2c: Analyze (m2c: Analizza).

   Se l'attività di analisi non riesce, devi modificare i parametri di migrazione tramite il file analyze-args.ini. Questo file contiene una riga per parametro con la documentazione di accompagnamento sul parametro.

   Se l'analisi va a buon fine, Cloud Code crea una directory denominata migration-plan che contiene i risultati dell'analisi sotto forma di file config.yaml. Puoi modificare questo file per cambiare il modo in cui vengono generati gli artefatti.

   La struttura del file config.yaml varia in base al tipo di migrazione. Per saperne di più sui tipi di migrazione supportati, consulta le seguenti pagine:

   • VM Linux
   • Server Tomcat
   • Carichi di lavoro WebSphere
   • Server JBoss
   • Server Apache
   • Siti WordPress

Genera artefatti

Per generare gli artefatti, devi eseguire l'attività Genera nel tuo IDE. Se non hai già eseguito le attività Copia e Analizza nelle sezioni precedenti, l'attività Genera le esegue automaticamente entrambe prima di generare gli artefatti.

Per generare gli artefatti, segui questi passaggi:

1. Apri il riquadro dei comandi premendo Ctrl+Shift+P.

2. Cerca e seleziona Tasks: Run Task (Attività: esegui attività), quindi seleziona m2c: Generate (m2c: genera). Vengono generati gli artefatti nella directory src, che contiene un file skaffold.yaml utilizzato per creare ed eseguire il deployment di un'immagine container. Ogni tipo di migrazione genera artefatti diversi, ma di solito tutti i tipi di migrazione creano uno o più dockerfile e una specifica di deployment GKE a cui fa riferimento skaffold.yaml.

   Al termine della generazione degli artefatti, la riassegnazione della piattaforma dell'applicazione è completata.

3. (Facoltativo) Se vuoi modificare il piano di migrazione, modifica il file config.yaml ed esegui di nuovo l'attività m2c: Generate.

   Altrimenti, se sei soddisfatto dei risultati della ripiattaforma, puoi procedere a eseguire l'applicazione in un container GKE.

Esegui l'applicazione in un container GKE

In questa sezione, esegui l'applicazione ripiattaformata in un container GKE, visualizza i log dell'applicazione in esecuzione e pulisci le risorse.

Se non hai ancora creato e configurato un cluster GKE, segui le istruzioni riportate in Creare e configurare un cluster GKE in Cloud Code per VS Code.

Per scoprire di più sul debug delle applicazioni GKE, consulta Eseguire il debug delle applicazioni Kubernetes con Cloud Code per VS Code.

Esegui e visualizza l'applicazione

Ora che hai completato la configurazione, puoi eseguire l'applicazione e visualizzarla in tempo reale. Cloud Code monitora il file system per rilevare le modifiche in modo da poter modificare ed eseguire nuovamente l'app in tempo reale.

Per eseguire l'applicazione, segui questi passaggi:

1. Nella barra di stato di Cloud Code, fai clic sul nome del progetto attivo.

   

2. Nel menu di selezione rapida visualizzato, seleziona Esegui su Kubernetes.

3. Conferma se utilizzare il contesto del cluster attuale o passare a un altro.

4. Se richiesto, scegli un registro delle immagini in cui eseguire il push delle immagini. Se stai creando un nuovo registro delle immagini utilizzando gcr.io/PROJECT_ID, assicurati che il registro delle immagini si trovi nello stesso progetto del cluster.

   Viene visualizzata una finestra di output in cui puoi monitorare lo stato di avanzamento dell'applicazione in esecuzione. Nell'output del terminale vedrai anche un live streaming dei log dei pod in esecuzione.

5. Una volta che l'applicazione è in esecuzione su Kubernetes, la finestra di output mostra un indirizzo IP. Per utilizzare questo indirizzo IP collegato per accedere alla tua applicazione, premi Ctrl e fai clic sull'indirizzo.

Una volta avviata la sessione di debug, nel riquadro Sessioni di sviluppo viene visualizzata la visualizzazione della registrazione strutturata. Quando un'attività inizia, viene visualizzata con un semicerchio rotante progress_activity.

Se un'attività va a buon fine, accanto al passaggio viene visualizzato un segno di spunta check_circle.

Per visualizzare i dettagli di un passaggio, fai clic sul passaggio nel riquadro Sessione di sviluppo. Il riquadro Output mostra il passaggio nell'output di logging.

Esegui la pulizia

Dopo aver arrestato l'applicazione, tutte le risorse Kubernetes di cui è stato eseguito il deployment durante l'esecuzione vengono eliminate automaticamente.

Per evitare che al tuo account vengano addebitati costi per altre risorse utilizzate in questa guida rapida, assicurati di eliminare il progetto o il cluster che hai creato se vuoi riutilizzare il progetto.

Per eliminare il cluster:

1. Fai clic su Cloud Code ed espandi Explorer di Kubernetes.
2. Tieni il puntatore sopra il nome del cluster e poi fai clic su open_in_new Apri nella console Google Cloud .
3. Fai clic su Elimina e quindi su Elimina.

Per eliminare il progetto (e le risorse associate, inclusi eventuali cluster):

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Per eliminare tutti i file locali creati durante il processo di riassegnazione della piattaforma:

1. Apri la tavolozza dei comandi (Ctrl+Shift+P).
2. Cerca e seleziona Tasks: Run Task (Attività: esegui attività), quindi seleziona m2c: Cleanup (m2c: pulizia).