Modernizzare un'applicazione Node.js

Bob è un partner IA SDLC (Software Development Lifecycle) che potenzia i tuoi flussi di lavoro esistenti. In questo tutorial, imparerai alcune delle funzionalità principali di Bob modernizzando un'API Express TypeScript da Node.js 16 a Node.js 22. Non hai bisogno di esperienza in Node.js o TypeScript per completare il tutorial. Imparerai come Bob analizza le dipendenze e modernizza i pattern di codice.

Bob fornisce quattro capacità essenziali che userai durante l'aggiornamento dell'API:

Questo tutorial utilizza un'API REST Express TypeScript come progetto di esempio. Tuttavia, non hai bisogno di esperienza in Node.js o TypeScript.

Per completare questo tutorial, hai bisogno di quanto segue:

Avvia IBM Bob e clona il repository di esempio per iniziare a lavorare con l'applicazione Node.js che modernizzerai.

Crea un Dockerfile per eseguire l'applicazione in un ambiente containerizzato, eliminando la necessità di installare Node.js o dipendenze localmente.

Prima di modernizzare, verifica che il codice legacy si compili ed esegua correttamente. Questa baseline assicura che tu possa identificare eventuali problemi introdotti dalla modernizzazione.

Durante la fase di build, Bob ti dirà che la build è fallita perché il Dockerfile usa npm ci, che richiede un file package-lock.json che non esiste.

Nel pannello chat di Bob, dì a Bob di compilare e testare l'applicazione.

Bob ti chiede di salvare una modifica al Dockerfile che risolverà il problema package-lock.json con il seguente messaggio:

La capacità di Bob di rilevare e correggere errori di build è un esempio di come lavora con te per risolvere i problemi durante i deployment.

Una volta che Bob applica la correzione e completa la build, mostra un riepilogo dei risultati di build e test, confermando che l'applicazione legacy funziona correttamente in un ambiente containerizzato. Hai ora una baseline verificata con cui confrontarti dopo aver modernizzato l'applicazione nella sezione successiva.

Tu e Bob avete verificato che l'applicazione legacy funziona correttamente.

Prima di modernizzare, clicca sul menu a discesa di selezione della modalità e passa alla modalità Ask di Bob. La modalità Ask può solo leggere file, quindi puoi esplorare il codice in sicurezza senza fare modifiche accidentali. Puoi anche digitare /ask nella chat di Bob per passare alla modalità Ask.

Bob supporta le menzioni di contesto @ che ti permettono di fare riferimento a file, cartelle o problemi specifici direttamente nei tuoi prompt. Le menzioni di contesto danno a Bob informazioni precise su ciò di cui vuoi discutere.

Esplora i file package.json, tsconfig.json e Dockerfile dicendo esplicitamente a Bob quali file analizzare usando le menzioni @. Imparare su questi file ti aiuta a comprendere i requisiti di modernizzazione prima di apportare modifiche.

Nel pannello chat di Bob, esegui il seguente prompt:

Il simbolo @ dice a Bob di includere package.json come contesto. Bob non inizia a rispondere immediatamente; esplora prima la tua codebase, leggendo file, seguendo pattern e analizzando il codice. Non interrompere questa fase di esplorazione.

Bob identifica i seguenti aggiornamenti necessari per Node.js 22:

Chiedi a Bob di analizzare la configurazione TypeScript del progetto:

Bob risponde con i seguenti componenti che devi aggiornare per Node.js 22:

Chiedi a Bob di analizzare il Dockerfile del progetto:

Bob risponde con ciò che deve essere aggiornato per Node.js 22:

Ora comprendi cosa deve essere aggiornato. Nella sezione successiva, passi alla modalità Agent e fai fare le modifiche a Bob.

Bob ha determinato i seguenti requisiti di modernizzazione per package.json, tsconfig.json e Dockerfile:

Per iniziare a modernizzare l'applicazione, torna alla modalità Agent in modo che Bob possa apportare modifiche al codice.

Nel pannello chat di Bob, esegui il seguente prompt di modernizzazione. Nota i riferimenti @ che puntano Bob ai file specifici su cui lavora:

Bob ti dà un riepilogo di tutti i componenti che ha aggiornato nella modernizzazione:

Tu e Bob avete modernizzato l'applicazione.

Usa la funzionalità di codifica letteraria di Bob per aggiornare il titolo del todo di esempio, segnando l'app come modernizzata. La codifica letteraria ti permette di scrivere istruzioni in linguaggio naturale direttamente nel tuo editor invece di usare il pannello chat.

Hai aggiornato l'API usando la codifica letteraria. Quando testerai l'API nella sezione successiva, vedrai questo nuovo titolo nella risposta dell'API.

Verifica la modernizzazione del codice e la tua modifica di codice letterario ricostruendo e testando il container Docker.

Torna alla modalità Agent e descrivi cosa vuoi che Bob verifichi:

Una volta che Bob ha verificato che l'applicazione è stata modernizzata, ti dà il seguente riepilogo:

L'API funziona correttamente, e il titolo è stato aggiornato a "Welcome to the Modernized Node.js 22 API", confermando che Bob ha preservato il comportamento esistente mentre modernizzava la versione di Node.js e le dipendenze.

In questo tutorial, hai imparato come modernizzare un'API Express da Node.js 16 a Node.js 22 usando Bob. Bob ha analizzato le tue dipendenze, aggiornato i file di configurazione e modernizzato la configurazione Docker preservando tutte le funzionalità.

Quindi, lavora attraverso la serie di tutorial Inizia con IBM Bob per saperne di più sulle funzionalità e capacità di Bob.