Eine Node.js-Anwendung modernisieren

Bob ist ein KI-SDLC-Partner (Software Development Lifecycle), der Ihre bestehenden Workflows erweitert. In diesem Tutorial lernen Sie einige der Kernfunktionen von Bob kennen, indem Sie eine TypeScript Express API von Node.js 16 auf Node.js 22 modernisieren. Sie benötigen keine Erfahrung mit Node.js oder TypeScript, um das Tutorial abzuschließen. Sie lernen, wie Bob Abhängigkeiten analysiert und Code-Muster modernisiert.

Bob bietet vier wesentliche Funktionen, die Sie beim Upgrade der API verwenden werden:

Dieses Tutorial verwendet eine TypeScript Express REST API als Beispielprojekt. Sie benötigen jedoch keine Erfahrung mit Node.js oder TypeScript.

Um dieses Tutorial abzuschließen, benötigen Sie Folgendes:

Starten Sie IBM Bob und klonen Sie das Beispiel-Repository, um mit der Node.js-Anwendung zu arbeiten, die Sie modernisieren werden.

Erstellen Sie ein Dockerfile, um die Anwendung in einer containerisierten Umgebung auszuführen, wodurch die lokale Installation von Node.js oder Abhängigkeiten entfällt.

Bevor Sie modernisieren, überprüfen Sie, ob der Legacy-Code korrekt erstellt wird und läuft. Diese Baseline stellt sicher, dass Sie alle Probleme identifizieren können, die die Modernisierung einführt.

Während der Build-Phase teilt Bob Ihnen mit, dass der Build fehlgeschlagen ist, weil das Dockerfile npm ci verwendet, was eine package-lock.json-Datei erfordert, die nicht existiert.

Sagen Sie Bob im Bob-Chat-Panel, dass es die Anwendung erstellen und testen soll.

Bob bittet Sie, eine Änderung am Dockerfile zu speichern, die das package-lock.json-Problem mit der folgenden Nachricht behebt:

Bobs Fähigkeit, Build-Fehler zu erkennen und zu beheben, ist ein Beispiel dafür, wie es mit Ihnen zusammenarbeitet, um Probleme während Bereitstellungen zu beheben und zu lösen.

Sobald Bob die Korrektur anwendet und den Build abschließt, wird eine Zusammenfassung der Build- und Testergebnisse angezeigt, die bestätigt, dass die Legacy-Anwendung korrekt in einer containerisierten Umgebung funktioniert. Sie haben nun eine verifizierte Baseline, mit der Sie nach der Modernisierung der Anwendung im nächsten Abschnitt vergleichen können.

Sie und Bob haben überprüft, dass die Legacy-Anwendung korrekt funktioniert.

Bevor Sie modernisieren, klicken Sie auf das Dropdown-Menü zur Modusauswahl und wechseln Sie zu Bobs Ask-Modus. Der Ask-Modus kann nur Dateien lesen, sodass Sie Code sicher erkunden können, ohne versehentlich Änderungen vorzunehmen. Sie können auch /ask im Bob-Chat eingeben, um in den Ask-Modus zu wechseln.

Bob unterstützt @ Kontext-Erwähnungen, mit denen Sie bestimmte Dateien, Ordner oder Probleme direkt in Ihren Eingabeaufforderungen referenzieren können. Kontext-Erwähnungen geben Bob präzise Informationen darüber, worüber Sie sprechen möchten.

Erkunden Sie die Dateien package.json, tsconfig.json und Dockerfile, indem Sie Bob explizit mitteilen, welche Dateien es mit @ Erwähnungen analysieren soll. Das Lernen über diese Dateien hilft Ihnen, die Modernisierungsanforderungen zu verstehen, bevor Sie Änderungen vornehmen.

Führen Sie im Bob-Chat-Panel die folgende Eingabeaufforderung aus:

Das @-Symbol teilt Bob mit, package.json als Kontext einzubeziehen. Bob beginnt nicht sofort mit der Beantwortung; es erkundet zuerst Ihre Codebasis, liest Dateien, folgt Mustern und analysiert Code. Unterbrechen Sie diese Erkundungsphase nicht.

Bob identifiziert die folgenden für Node.js 22 erforderlichen Updates:

Bitten Sie Bob, die TypeScript-Konfiguration des Projekts zu analysieren:

Bob antwortet mit den folgenden Komponenten, die Sie für Node.js 22 aktualisieren müssen:

Bitten Sie Bob, das Dockerfile des Projekts zu analysieren:

Bob antwortet mit dem, was für Node.js 22 aktualisiert werden muss:

Sie verstehen jetzt, was aktualisiert werden muss. Im nächsten Abschnitt wechseln Sie in den Agenten-Modus und lassen Bob die Änderungen vornehmen.

Bob hat die folgenden Modernisierungsanforderungen für package.json, tsconfig.json und Dockerfile ermittelt:

Um mit der Modernisierung der Anwendung zu beginnen, wechseln Sie zurück in den Agenten-Modus, damit Bob Code-Änderungen vornehmen kann.

Führen Sie in der Bob-Chat-Oberfläche die folgende Modernisierungseingabeaufforderung aus. Beachten Sie die @-Referenzen, die Bob auf die spezifischen Dateien hinweisen, an denen es arbeitet:

Nachdem Bob die Aktualisierungen und Tests abgeschlossen hat, wird eine Zusammenfassung ähnlich der folgenden angezeigt:

Sie und Bob haben die Anwendung modernisiert.

Verwenden Sie Bobs literarische Programmierung-Funktion, um den Beispiel-Todo-Titel zu aktualisieren und die App als modernisiert zu markieren. Literarische Programmierung ermöglicht es Ihnen, Anweisungen in einfacher Sprache direkt in Ihrem Editor zu schreiben, anstatt das Chat-Panel zu verwenden.

Sie haben die API mit literarischer Programmierung aktualisiert. Wenn Sie die API im folgenden Abschnitt testen, sehen Sie diesen neuen Titel in der API-Antwort.

Überprüfen Sie die Code-Modernisierung und Ihre literarische Code-Änderung, indem Sie den Docker-Container neu erstellen und testen.

Wechseln Sie zurück in den Agenten-Modus und beschreiben Sie, was Bob überprüfen soll:

Sobald Bob überprüft hat, dass die Anwendung modernisiert wurde, gibt es Ihnen die folgende Zusammenfassung:

Die API funktioniert korrekt, und der Titel wurde auf "Welcome to the Modernized Node.js 22 API" aktualisiert, was bestätigt, dass Bob das bestehende Verhalten beibehalten hat, während die Node.js-Version und Abhängigkeiten modernisiert wurden.

In diesem Tutorial haben Sie gelernt, wie Sie eine Express API von Node.js 16 auf Node.js 22 mit Bob modernisieren. Bob hat Ihre Abhängigkeiten analysiert, Konfigurationsdateien aktualisiert und das Docker-Setup modernisiert, während alle Funktionen erhalten blieben.