Modernizza l'applicazione CardDemo mainframe utilizzando AWS Transform - Prontuario AWS
RiepilogoPrerequisiti e limitazioniArchitetturaStrumentiBest practiceEpicheRisoluzione dei problemiRisorse correlate

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Modernizza l'applicazione CardDemo mainframe utilizzando AWS Transform

Creato da Santosh Kumar Singh (AWS) e Cheryl du Preez (AWS)

Riepilogo

AWS Transformè progettato per accelerare la modernizzazione delle applicazioni mainframe. Utilizza l'intelligenza artificiale generativa per semplificare il processo di modernizzazione del mainframe. Automatizza attività complesse, come l'analisi del codice legacy, la documentazione del mainframe, l'estrazione delle regole aziendali, la scomposizione delle applicazioni monolitiche in un dominio aziendale e il refactoring del codice. Accelera i progetti di modernizzazione automatizzando attività complesse, come l'analisi delle applicazioni e la pianificazione delle sequenze di migrazione. Durante la scomposizione di applicazioni monolitiche, AWS Transform sequenzia in modo intelligente la trasformazione delle applicazioni mainframe, il che aiuta a trasformare le funzioni aziendali in parallelo. AWS Transform può accelerare il processo decisionale e migliorare l'agilità operativa e l'efficienza della migrazione.

Questo modello offre step-by-step istruzioni per aiutarvi a testare le capacità di modernizzazione del mainframe AWS Transform utilizzando CardDemo, che è un esempio di applicazione mainframe open source.

Prerequisiti e limitazioni

Prerequisiti

  • Un attivo Account AWS

  • AWS IAM Identity Center, abilitato

  • Autorizzazioni che consentono agli amministratori di abilitare AWS Transform

  • Autorizzazioni che consentono agli amministratori di accettare le richieste di connessione Amazon Simple Storage Service (Amazon S3) per l'applicazione Web AWS Transform

Limitazioni

  • AWS Transform è disponibile solo in alcuni. Regioni AWS Per un elenco completo delle regioni supportate, consulta Regioni supportate per AWS Transform.

  • AWS Transform supporta l'analisi del codice, la generazione di documenti, l'estrazione, la scomposizione e il refactoring delle regole aziendali da Common Business-Oriented Language (COBOL) a Java. Per ulteriori informazioni, vedere Funzionalità e caratteristiche chiave e Tipi di file supportati per la trasformazione delle applicazioni mainframe.

  • È prevista una quota di servizio per le funzionalità di trasformazione del mainframe in. AWS Transform Per ulteriori informazioni, vedere Quotas for. AWS Transform

  • Per collaborare su uno spazio di lavoro condiviso, tutti gli utenti devono essere utenti registrati della stessa istanza associata all'istanza dell' AWS Transform applicazione Web. AWS IAM Identity Center

  • Il bucket Amazon S3 e AWS Transform devono trovarsi nella stessa Account AWS regione.

Architettura

Il diagramma seguente mostra l'architettura configurata secondo questo modello.

Utilizzo di AWS Transform per modernizzare un'applicazione mainframe archiviata in un bucket Amazon S3.

Il diagramma mostra il flusso di lavoro seguente:

  1. AWS Transform utilizza un connettore per accedere all'applicazione CardDemo mainframe, archiviata in un bucket Amazon S3.

  2. AWS Transform utilizza AWS IAM Identity Center per gestire l'accesso e l'autenticazione degli utenti. Il sistema implementa più livelli di controlli di sicurezza per l'autenticazione, l'autorizzazione, la crittografia e la gestione degli accessi per proteggere codice e artefatti durante l'elaborazione. Gli utenti interagiscono con l' AWS Transform agente tramite un'interfaccia di chat. Puoi fornire istruzioni all'agente AI per attività specifiche in inglese. Per ulteriori informazioni, consulta Human in the loop (HITL) nella AWS Transform documentazione.

  3. L'agente AI interpreta le istruzioni dell'utente, crea un piano di lavoro, divide il lavoro in attività eseguibili e lo esegue in modo autonomo. Gli utenti possono rivedere e approvare la trasformazione. Le attività di trasformazione includono quanto segue:

    • Analisi del codice: AWS Transform analizza il codice contenuto in ogni file alla ricerca di dettagli quali il nome del file, il tipo di file, le righe di codice e i relativi percorsi. L'agente analizza il codice sorgente, esegue classificazioni, crea mappature delle dipendenze e identifica eventuali artefatti mancanti. Identifica inoltre i componenti duplicati.

    • Generazione di documenti: AWS Transform genera documentazione per l'applicazione mainframe. Analizzando il codice, può creare automaticamente una documentazione dettagliata dei programmi applicativi, comprese le descrizioni della logica aziendale, dei flussi, delle integrazioni e delle dipendenze presenti nei sistemi legacy.

    • Estrazione della logica aziendale: AWS Transform analizza i programmi COBOL per documentarne la logica aziendale principale, per aiutarvi a comprendere la logica aziendale fondamentale.

    • Scomposizione del codice: AWS Transform scompone il codice in domini che tengono conto delle dipendenze tra programmi e componenti. Il raggruppamento di file e programmi correlati all'interno dello stesso dominio migliora l'organizzazione e aiuta a preservare la struttura logica dell'applicazione quando la scompone in componenti più piccoli.

    • Pianificazione dell'ondata di migrazione: in base ai domini creati durante la fase di decomposizione, AWS Transform genera un piano di ondata di migrazione con l'ordine di modernizzazione consigliato.

    • Rifattorizzazione del codice: AWS Transform rifattorizza il codice in tutti i file di dominio o in alcuni file di dominio in codice Java. L'obiettivo di questo passaggio è preservare la logica aziendale fondamentale dell'applicazione rifattorizzandola in un'applicazione Java modernizzata e ottimizzata per il cloud.

  4. AWS Transform archivia il codice rifattorizzato, i documenti generati, gli artefatti associati e le librerie di runtime nel tuo bucket Amazon S3. Puoi eseguire le operazioni indicate di seguito:

    • Accedi alla cartella runtime nel tuo bucket Amazon S3.

    • Crea e distribuisci l'applicazione seguendo le istruzioni Compila e distribuisci la tua applicazione modernizzata dopo il refactoring riportato nella documentazione. AWS Transform

    • Tramite l'interfaccia di chat, richiedi e scarica un esempio o un modello Hashicorp AWS CloudFormation Terraform AWS Cloud Development Kit (AWS CDK). Questi modelli possono aiutarti a distribuire AWS le risorse necessarie per supportare l'applicazione refactorizzata.

    • Utilizzate Reforge per migliorare la qualità del codice rifattorizzato utilizzando modelli di linguaggio di grandi dimensioni (). LLMs Il motore di refactoring preserva l'equivalenza funzionale di COBOL trasformandolo in codice Java. Reforge è un passaggio opzionale disponibile dopo la trasformazione. Questo passaggio serve LLMs a ristrutturare il codice in modo che assomigli da vicino a Java nativo, il che può migliorare la leggibilità e la manutenibilità. Reforge aggiunge anche commenti leggibili dall'uomo per aiutarti a comprendere il codice e implementa modelli di codifica e best practice moderni.

Strumenti

Servizi AWS

  • AWS Transformutilizza l'intelligenza artificiale agentica per aiutarti ad accelerare la modernizzazione dei carichi di lavoro legacy, come .NET, mainframe e carichi di lavoro. VMware

  • AWS IAM Identity Centerti aiuta a gestire centralmente l'accesso Single Sign-On (SSO) alle tue applicazioni e a quelle cloud. Account AWS

  • Amazon Simple Storage Service (Amazon S3) è un servizio di archiviazione degli oggetti basato sul cloud che consente di archiviare, proteggere e recuperare qualsiasi quantità di dati.

Archivio di codice

È possibile utilizzare l'applicazione AWS CardDemomainframe open source come applicazione di esempio per iniziare con la modernizzazione del mainframe.

Best practice

  • Inizia in piccolo: inizia con codice piccolo e meno complesso (15.000—20.000 righe di codice) per comprendere come analizza e trasforma le applicazioni mainframe. AWS Transform

  • Combina con l'esperienza umana: utilizza AWS Transform come acceleratore mentre applichi l'esperienza umana per risultati ottimali.

  • Revisione e test accurati: rivedi sempre attentamente il codice trasformato ed esegui test completi per convalidare l'equivalenza funzionale dopo la trasformazione.

  • Fornisci feedback: per fornire feedback e suggerimenti per il miglioramento, utilizza il pulsante Invia feedback in AWS Management Console o crea un caso con. Supporto AWS Per ulteriori informazioni, consulta Creazione di una richiesta di supporto. Il tuo contributo è prezioso per il miglioramento del servizio e lo sviluppo futuro.

Epiche

AttivitàDescrizioneCompetenze richieste

Creare un bucket.

Crea un bucket Amazon S3 nella stessa regione in cui AWS Transform è Account AWS abilitato. Questo bucket viene utilizzato per archiviare il codice dell'applicazione mainframe e lo AWS Transform utilizza per archiviare i documenti generati, il codice refactorizzato e altri file associati alla trasformazione. Per istruzioni, consulta Creazione di un bucket nella documentazione di Amazon S3.

Informazioni generali su AWS

Preparare l'applicazione mainframe di esempio.

  1. Immettete il seguente comando per clonare il CardDemorepository sulla workstation locale:

    git clone https://github.com/aws-samples/aws-mainframe-modernization-carddemo.git

  2. Crea una nuova cartella denominata. carddemo

  3. Copiate la app cartella, che contiene il codice sorgente del mainframe, dal repository clonato nella cartella. carddemo

  4. Comprimi la cardemo cartella in un file ZIP.

  5. Carica il file ZIP nel bucket Amazon S3 che hai creato. Per istruzioni, consulta Caricamento di oggetti nella documentazione di Amazon S3.

Sviluppatore di app, ingegnere DevOps
AttivitàDescrizioneCompetenze richieste

Aggiungi utenti a IAM Identity Center.

Aggiungi i tuoi potenziali utenti a IAM Identity Center. Segui le istruzioni in Aggiungere utenti in IAM Identity Center nella AWS Transform documentazione.

Amministratore AWS

Abilita AWS Transform e aggiungi utenti.

  1. Abilitare AWS Transform. Segui le istruzioni riportate in Abilita AWS Transform.

  2. Aggiungi utenti a AWS Transform. Segui le istruzioni riportate in Aggiungere utenti a AWS Transform.

Amministratore AWS

Configura l'accesso degli utenti all'applicazione AWS Transform web.

Ogni utente deve accettare l'invito ad accedere all'applicazione AWS Transform web. Segui le istruzioni riportate in Accettazione dell'invito nella AWS Transform documentazione.

Sviluppatore dell'app, proprietario dell'app

Accedi all'applicazione AWS Transform web.

Segui le istruzioni riportate in Accesso a AWS Transform.

Sviluppatore dell'app, proprietario dell'app

Configura uno spazio di lavoro.

Configura uno spazio di lavoro in cui gli utenti possano collaborare nell' AWS Transform applicazione web. Segui le istruzioni in Configurazione dell'area di lavoro nella documentazione. AWS Transform

Amministratore AWS
AttivitàDescrizioneCompetenze richieste

Crea un lavoro di trasformazione.

Crea un processo di trasformazione per modernizzare l'applicazione CardDemo mainframe. Per istruzioni, consulta Creare e avviare un lavoro nella AWS Transform documentazione. Quando ti viene chiesto di impostare gli obiettivi nell'interfaccia di AWS Transform chat, scegli Esegui la modernizzazione del mainframe (da IBM z/OS a AWS), quindi scegli Analizza codice, Genera documentazione tecnica, Logica aziendale, Decomponi codice, Pianifica la sequenza di migrazione e Trasforma il codice in Java.

Sviluppatore di app, proprietario dell'app

Configura il connettore.

Stabilisci un connettore per il bucket Amazon S3 che contiene l' CardDemo applicazione mainframe. Questo connettore consente di accedere AWS Transform alle risorse nel bucket ed eseguire funzioni di trasformazione consecutive. Per istruzioni, consulta Configurare un connettore nella AWS Transform documentazione.

Amministratore AWS

Esegui l'analisi del codice.

  1. Nella pagina Specificare la posizione dell'asset, inserisci il percorso del bucket Amazon S3 per il file carddemo ZIP che hai caricato.

  2. Scegli Approva e invia a. AWS Transform Inizia ad analizzare il codice.

  3. Monitora lo stato nella scheda Worklog.

  4. Una volta completata l'analisi, in Analizza il codice nel riquadro di navigazione a sinistra, scegli Visualizza i risultati dell'analisi del codice.

  5. (Facoltativo) Scegliete Scarica per scaricare l'elenco completo delle risorse, il codice sorgente mancante e il file di dipendenza.

Per ulteriori informazioni, consultate Analisi del codice nella AWS Transform documentazione.

Sviluppatore di app, proprietario dell'app

Genera documentazione tecnica.

  1. Nel riquadro di navigazione a sinistra, in Genera documentazione tecnica, scegli Seleziona file e configura le impostazioni.

  2. Espandi COBOL o JCL, quindi seleziona uno o più file.

  3. Scegliete il livello di dettaglio della documentazione:

    • Riepilogo: fornisce una panoramica di alto livello di ogni file compreso nell'ambito. Inoltre, fornisce un riepilogo di ogni file in una riga.

    • Specifiche funzionali dettagliate: fornisce dettagli completi per ogni file nell'ambito della trasformazione delle applicazioni mainframe. Alcuni dettagli includono logica e flusso, regole aziendali identificate, flusso di dati, dipendenze, elaborazione di input e output e vari dettagli sulle transazioni.

  4. Scegli Invia a. AWS Transform

  5. Monitora l'avanzamento nella scheda Worklog.

    Nota

    Il tempo di generazione dei documenti varia da minuti a ore, a seconda del numero di file e righe di codice.

  6. Al termine, scegli Rivedi i risultati della documentazione.

  7. Accedi al documento generato tramite l'applicazione web o scaricalo. La documentazione generata viene inoltre archiviata nel bucket Amazon S3.

  8. Esplora la documentazione generata ponendo domande specifiche nell'interfaccia di chat. Ad esempio, puoi dire «Dimmi le funzionalità di CBACT01C».

Per ulteriori informazioni, consulta Generare documentazione tecnica nella documentazione. AWS Transform

Sviluppatore di app, proprietario dell'app

Estrai la logica aziendale.

  1. Nel riquadro di navigazione a sinistra, espandi Estrai la logica aziendale, quindi scegli Seleziona i file per l'estrazione della logica aziendale.

  2. Espandi COBOL o JCL, quindi seleziona uno o più file.

  3. Scegliete Invia a. AWS Transform

  4. Monitora l'avanzamento nella scheda Worklog.

    Nota

    Il tempo di estrazione della logica aziendale varia da minuti a ore, a seconda del numero di file e righe di codice.

  5. Quando l'estrazione è completa, scegli Rivedi i risultati dell'estrazione della logica aziendale.

  6. Selezionate un file COBOL o JCL, quindi scegliete Visualizza.

  7. Modificate l'ambito nel diagramma di flusso e nelle regole funzionali per esaminare i diversi livelli dei diagrammi di flusso, incluso il codice di supporto.

  8. (Facoltativo) Esamina la logica di business generata, archiviata in formato JSON nel tuo bucket Amazon S3.

Per ulteriori informazioni, consulta Extract business logic nella documentazione. AWS Transform

Sviluppatore di app, proprietario dell'app

Decomponi il codice.

  1. Nel riquadro di navigazione a sinistra, espandi Decomponi codice, quindi scegli Scomponi in domini.

  2. Nell'elenco Azioni, scegli Crea dominio.

  3. Inserisci un nome per il nuovo dominio, ad esempioBill payment.

  4. (Facoltativo) Fornisci una descrizione.

  5. Nella barra di ricerca Trova fileCB00, cerca e seleziona il file.

  6. Scegli Contrassegna come seme.

  7. Verifica che il flag del seme cambi da No a Sì.

  8. Scegli Create (Crea).

  9. Scegli Save (Salva).

  10. Scegliete Decompose.

  11. Controlla l'output di scomposizione scegliendo il nome di dominio.

  12. Quando la scomposizione è completa, scegli Invia a. AWS Transform

Per ulteriori informazioni sulla decomposizione e sui semi, vedete Decomposizione nella documentazione. AWS Transform

Sviluppatore di app, proprietario dell'app

Pianifica le ondate migratorie.

Pianifica le ondate di migrazione per l' CardDemo applicazione. Segui le istruzioni riportate nella pianificazione delle ondate di migrazione nella AWS Transform documentazione per rivedere e modificare il piano delle ondate.

Sviluppatore dell'app, proprietario dell'app

Rifattorizza il codice.

  1. Effettua il refactoring dell'applicazione CardDemo mainframe in codice Java in tutti i file di dominio o in alcuni file di dominio. Segui le istruzioni contenute nel codice Refactor nella documentazione. AWS Transform

  2. Una volta completato il processo di refactoring, create e distribuite l'applicazione Java modernizzata. Segui le istruzioni riportate in Crea e distribuisci la tua applicazione modernizzata dopo il refactoring nella documentazione. AWS Transform

Sviluppatore di app, proprietario dell'app

(Facoltativo) Usa Reforge per migliorare il codice Java.

  1. Crea un nuovo lavoro, quindi inserisci un obiettivo di. Reforge the code

  2. Inserisci il nome di un progetto che è stato modernizzato. AWS Transform Questo progetto dovrebbe essere nel tuo bucket Amazon S3.

  3. Inserisci l'elenco delle classi Java che specifica le classi di servizio da riforgiare.

  4. Esamina l'output generato nel bucket Amazon S3.

Per ulteriori informazioni, consulta Reforge nella documentazione. AWS Transform

Sviluppatore dell'app, proprietario dell'app

Semplifica l'implementazione.

AWS Transform può fornire modelli Infrastructure as Code (IaC) per CloudFormation AWS CDK Terraform. Questi modelli consentono di distribuire i componenti principali, tra cui risorse di elaborazione, database, archiviazione e sicurezza.

  1. Nell'interfaccia di AWS Transform chat, richiedi i modelli inserendoShare the mainframe refactor <service> templates, <service> dov'è uno dei servizi IaC supportati.

  2. Implementa il modello utilizzando il tuo servizio preferito. Ad esempio, consulta le seguenti risorse:

Per ulteriori informazioni, consulta le funzionalità di distribuzione nella AWS Transform documentazione.

Sviluppatore di app, proprietario dell'app

Risoluzione dei problemi

ProblemaSoluzione

Non è possibile visualizzare il codice sorgente o il documento generato nell'applicazione AWS Transform Web.

Aggiungi una policy all'autorizzazione CORS per il bucket Amazon S3 da AWS Transform consentire come origine. Per ulteriori informazioni, consulta le autorizzazioni CORS del bucket S3 nella documentazione. AWS Transform

Risorse correlate

AWS documentazione

Altre risorse AWS

Video e tutorial

Nota

AWS Transform era precedentemente noto come Amazon Q Developer transform for mainframe.