Tutorial: configurazione di una pipeline CI/CD da utilizzare con Micro Focus Enterprise Developer

1. Accedi e apri la console all'indirizzo AWS Management Console /cloudformazione. AWS CloudFormation https://console.aws.amazon.com

2. Creare un nuovo stack utilizzando una delle seguenti opzioni:

   • Scegli Crea stack. Questa è la sola opzione se si dispone di uno stack attualmente in esecuzione.

   • Nella pagina Stacks, scegli Crea stack. Questa opzione è visibile solo se non esistono stack in esecuzione.

3. Nella pagina Specificare il modello:

   • In Prepara il modello, scegli Il modello è pronto.

   • In Specificare modello, scegli Amazon S3 URL come origine del modello e inserisci uno dei seguenti valori URLs a seconda del tuo. Regione AWS

     • https://m2-us-east-1.s3.us-east-1.amazonaws.com/cicd/mf/basic-infra.yaml

     • https://m2-eu-central-1.s3.eu-central-1.amazonaws.com/cicd/mf/basic-infra.yaml

   • Per accettare le tue impostazioni, scegli Avanti.

   Viene visualizzata la pagina Crea stack.

   

   Apporta le seguenti modifiche:

   • Fornite i valori appropriati per il nome dello stack e i parametri per la configurazione di rete.

   • La maggior parte dei parametri nelle configurazioni di distribuzione sono precompilati in modo appropriato, quindi non è necessario modificarli. A seconda del modello Regione AWS, modifica il AWS CloudFormation modello di pipeline in uno dei seguenti Amazon URLs S3.

     • https://m2-us-east-1.s3.amazonaws.com/cicd/mf/pipeline.yaml

     • https://m2-eu-central-1.s3.eu-central-1.amazonaws.com/cicd/mf/pipeline.yaml

   • Scegli Next (Successivo).

   Nota

   Non modificare i valori dei parametri predefiniti a meno che non sia stato tu stesso a modificare il AWS CloudFormation modello.

4. In Configura le opzioni dello stack, scegli Avanti.

5. In Capacità, scegli Riconosco che AWS CloudFormation potrebbe creare IAM risorse per consentire l'autorizzazione AWS CloudFormation a creare un IAM ruolo per tuo conto. Seleziona Crea stack.

   Nota

   Il provisioning di questo stack può richiedere dai 3 ai 5 minuti.

6. Dopo che lo stack è stato creato correttamente, vai alla sezione Output dello stack appena fornito. Qui troverai il bucket Amazon S3 in cui caricare il codice del mainframe e i file dipendenti.

   

1. Scaricate l'applicazione di esempio sul computer locale. BankDemo

2. Carica bankdemo.zip dal tuo computer locale nel bucket Amazon S3 creato in. Crea l'infrastruttura di base della pipeline CI/CD

3. Scarica config_git.yml.

4. Modifica il, config_git.yml se necessario, come segue:

   • Aggiungi il nome del tuo repository di destinazione, il ramo di destinazione e il messaggio di commit.

     repository-config:
       target-repository: bankdemo-repo
       target-branch: main
       commit-message: Initial commit for bankdemo-repo main branch

   • Aggiungi l'indirizzo email a cui desideri ricevere le notifiche.

     pipeline-config:
       # Send pipeline failure notifications to these email addresses
       alert-notifications:
         - myname@mycompany.com
       # Send notifications for manual approval before production deployment to these email addresses
       approval-notifications:
         - myname@mycompany.com 

5. Carica il config_git.yml file contenente la definizione della struttura delle cartelle del CodeCommit repository nel bucket Amazon S3 creato in. Crea l'infrastruttura di base della pipeline CI/CD Ciò richiamerà la funzione Lambda che fornirà automaticamente il repository e la pipeline.

   Questo creerà un CodeCommit repository con il nome fornito nel config_git.yml file target-repository definito, ad esempio. bankdemo-repo

   La funzione Lambda creerà anche lo stack di pipeline CI/CD. AWS CloudFormation Lo AWS CloudFormation stack avrà lo stesso prefisso del target-repository nome fornito seguito da una stringa casuale (ad esempio. bankdemo-repo-01234567 È possibile trovare il CodeCommit repository URL e accedere URL alla pipeline creata nella console di gestione. AWS

   

6. Se la creazione del CodeCommit repository è completa, la pipeline CI/CD verrà attivata immediatamente per eseguire un CI/CD completo.

7. Una volta inviato, il file attiverà automaticamente la pipeline che si occuperà della creazione, della distribuzione in staging, dell'esecuzione di alcuni test e dell'approvazione manuale prima di distribuirlo nell'ambiente di produzione.

1. Avvia Enterprise Developer da Windows Start. Scegliete Micro Focus Enterprise Developer, quindi scegliete Enterprise Developer for Eclipse. Se state iniziando per la prima volta, potrebbe volerci del tempo.

2. In Eclipse Launcher, in Workspace: entra e C:\Users\<username>\workspace scegli Avvia.

   Nota

   Assicurati di scegliere la stessa posizione dopo la riconnessione all'istanza 2.0. AppStream La selezione dell'area di lavoro non è persistente.

3. In Benvenuto, scegli Apri COBOL prospettiva. Questo verrà mostrato solo la prima volta per un nuovo spazio di lavoro.

1. Scegli Finestra/Prospettiva/Prospettiva aperta/Altro... /Git.

2. Scegli Clona un repository Git.

3. In Clone Git Repository, inserisci le seguenti informazioni:

   • In Location URI, inserisci il nome HTTPS URL del CodeCommit repository.

     Nota

     Copia il clone URL HTTPS per il CodeCommit repository nella console di AWS gestione e incollalo qui. URIVerrà suddiviso nei percorsi Host e Repository.

   • L'utente CodeCommit archivia le credenziali in Authentication User and Password e seleziona Archivia in Secure Store.

4. In Selezione del ramo, scegli Filiale principale, quindi scegli Avanti.

5. In Destinazione locale, in Directory, inserisci C:\Users\<username>\workspace e scegli Fine.

   Il processo di clonazione è completato quando BANKDEMO [main] viene visualizzato nella vista Git Repositories.

1. Passa alla COBOLprospettiva.

2. In Project, disattiva Crea automaticamente.

3. In File, scegli Nuovo, quindi COBOLProgetto Mainframe.

4. In New Mainframe COBOL Project, inserisci le seguenti informazioni:

   • Nel nome del progetto, immetteteBankDemo.

   • Scegliete il modello Micro Focus [64 bit].

   • Scegli Fine.

5. In COBOLExplorer, espandete il nuovo BankDemo progetto.

   Nota

   [BANKDEMO main]tra parentesi quadre indica che il progetto è collegato al BankDemo CodeCommit repository locale.

6. Se la visualizzazione ad albero non mostra le voci relative a COBOL Programmi, Taccuini, BMS Sorgenti e JCL File, scegliete Aggiorna dal menu contestuale del progetto. BankDemo

7. Dal menu BankDemo contestuale, scegliete Proprietà/Micro Focus/Impostazioni progetto/: COBOL

   • Scegliete Set di caratteri - ASCII.

   • Scegliete Applica, quindi Chiudi.

8. Se la compilazione del COBOL sorgente BMS and non viene avviata immediatamente, verificate nel menu Progetto che l'opzione Genera automaticamente sia abilitata.

   L'output di Build verrà visualizzato nella vista Console e dovrebbe essere completato dopo alcuni minuti con messaggi BUILD SUCCESSFUL eBuild finished with no errors.

   L' BankDemo applicazione dovrebbe ora essere compilata e pronta per l'esecuzione locale.

1. In COBOLExplorer, espandiBANKDEMO / config.

2. Nell'editor, apriBANKDEMO_ED.json.

3. Trova la stringa ED_Home= e modifica il percorso in modo che punti al progetto Enterprise Developer, come segue:D:\\<username>\\workspace\\BANKDEMO. Notate l'uso delle doppie barre (\\) nella definizione del percorso.

4. Salva e chiudi il file.

5. Scegliete Server Explorer.

6. Dal menu contestuale predefinito, scegliete Apri pagina di amministrazione. La pagina di amministrazione di Micro Focus Enterprise Server viene aperta nel browser predefinito.

7. Solo per le sessioni AppStream 2.0, apportate le seguenti modifiche in modo da poter preservare la regione locale di Enterprise Server per i test locali:

   • In Directory Server/Default, scegli PROPERTIES/Configurazione.

   • Sostituisci la posizione del repository conD:\<username>\My Files\Home Folder\MFDS.

   Nota

   È necessario completare i passaggi da 5 a 8 dopo ogni nuova connessione a un'istanza AppStream 2.0.

8. In Directory Server/Default, scegli Importa, quindi completa i seguenti passaggi:

   • Nel passaggio 1: Tipo di importazione, scegli JSONe scegli Avanti.

   • Nel Passaggio 2: Carica, fai clic per caricare il file nel quadrato blu.

   • In Scegli il file da caricare, inserisci:

     • Nome del file:D:\<username>\workspace\BANKDEMO\config\BANKDEMO_ED.json.

     • Seleziona Apri.

   • Scegli Next (Successivo).

   • Nel passaggio 3: Le regioni cancellano le porte dagli endpoint.

   • Scegli Next (Successivo).

   • Nel passaggio 4: Importa, scegli Importa.

   • Scegli Fine.

   L'elenco mostrerà ora un nuovo nome di serverBANKDEMO.

1. Scegli Enterprise Developer.

2. In Server Explorer, scegli Predefinito, quindi scegli Aggiorna dal menu contestuale.

   Ora dovrebbe essere visualizzato BANKDEMO anche l'elenco dei server.

3. Scegli BANKDEMO.

4. Dal menu contestuale, scegli Associa al progetto, quindi scegli BANKDEMO.

5. Dal menu contestuale, scegli Start.

   La visualizzazione della console dovrebbe mostrare il registro per l'avvio del server.

   Se BANKDEMO CASSI5030I PLTPI Phase 2 List(PI) Processing Completed viene visualizzato il messaggio, il server è pronto per testare l'CICSBANKDEMOapplicazione.

1. Da Windows Start, avviate Micro Focus Rumba+ Desktop /Rumba+ Desktop.

2. In Benvenuto, scegliete CREATE NEWSESSION/Mainframe Display.

3. In Mainframe Display, scegliete Connessione/Configura.

4. In Configurazione della sessione, scegliete Connessione/TN3270.

5. In Nome host/ Indirizzo, scegli Inserisci e inserisci l'indirizzo IP127.0.0.1.

6. In Porta Telnet, inserisci la porta6000.

7. Scegli Applica.

8. Scegli Connetti.

   La schermata di CICS benvenuto mostra la schermata con il messaggio della riga 1:This is the Micro Focus MFE CICS region BANKDEMO.

9. Premi CTRL +Shift+Z per cancellare lo schermo.

1. In una schermata vuota, inserisciBANK.

2. Nella schermata BANK10, nel campo di immissione dell'ID utente... :, inserisci guest e premi Invio.

3. Nella schermata BANK20, nel campo di immissione prima di Calcola il costo di un prestito, inserisci / (barra anteriore) e premi Invio.

4. Nella schermata BANK70:

   • Nella sezione L'importo che desideri prendere in prestito... :, entra10000.

   • In A un tasso di interesse di... :, inserisci5.0.

   • In Per quanti mesi... :, entra10.

   • Premere Invio.

   Dovrebbe essere visualizzato il seguente risultato:

   Resulting monthly payment.............:   $1023.06

   Questo completa la configurazione dell'BANKDEMOapplicazione in Enterprise Developer.

1. In Server Explorer, scegli Predefinito, quindi scegli Aggiorna dal menu contestuale.

2. Scegliete BANKDEMO.

3. Dal menu contestuale, scegliete Stop.

   La visualizzazione della console dovrebbe mostrare il registro relativo all'arresto del server.

   Se Server: BANKDEMO stopped successfully viene visualizzato il messaggio, il server si è spento correttamente.

Le regole di analisi definite in Micro Focus Enterprise Analyzer possono essere esportate da Enterprise Analyzer e importate in Enterprise Developer per eseguire le stesse regole di analisi tra le fonti del progetto Enterprise Developer.

1. Aprire Window/Preferences/Micro Focus/COBOL/Code Analysis/Rules.

2. Scegli Modifica... e inserisci il nome della cartella D:\PhotonUser\My Files\Home Folder\AnalysisRules contenente il file delle regoleLoan+Calculation+Update.General-1.xml.

3. Scegli Fine.

4. Scegliete Applica, quindi scegliete Chiudi.

5. Dal menu contestuale del BANKDEMO progetto, scegli Code Analysis.

   Dovresti vedere una voce per Loan Calculation Update.

Con la nuova regola di analisi vogliamo identificare i COBOL programmi e le righe di codice presenti che corrispondono ai modelli di ricerca *LOAN* e *RATE* nelle espressioni*PAYMENT*, nelle istruzioni e nelle variabili. Questo ci aiuterà a navigare all'interno del codice e a identificare le modifiche necessarie.

1. Dal menu contestuale del BANKDEMO progetto, scegliete Analisi del codice/Aggiornamento del calcolo del prestito.

   Questo eseguirà la regola di ricerca ed elencherà i risultati in una nuova scheda chiamata Code Analysis. L'esecuzione dell'analisi è completata quando la barra di avanzamento verde in basso a destra scompare.

   La scheda Analisi del codice dovrebbe visualizzare un elenco esteso diBBANK20P.CBL, BBANK70P.CBL ciascuna delle quali elenca le istruzioni, le espressioni e le variabili che corrispondono ai modelli di ricerca. SBANK70P.CBL

   Guardando il risultato, BBANK20P.CBL sono stati spostati solo i valori letterali che corrispondono al modello di ricerca. Quindi questo programma può essere ignorato.

2. Nella barra dei menu della scheda scegli - Icona per comprimere tutto.

3. Espandi SBANK70P.CBL e seleziona qualsiasi riga in qualsiasi ordine con un doppio clic per vedere come si aprirà il codice sorgente ed evidenzierà la riga selezionata nel codice sorgente. Riconoscerai anche che tutte le righe sorgente identificate sono contrassegnate.

Per prima cosa cambieremo la BMS mappaMBANK70.BMS, il programma di gestione dello schermo SBANK70P.CBL e il quaderno CBANKDAT.CPY per visualizzare il nuovo campo. Per evitare la codifica non necessaria in questo esercizio, nella cartella sono disponibili moduli sorgente modificati. D:\PhotonUser\My Files\Home Folder\BANKDEMO-exercise\Exercise01 Normalmente uno sviluppatore utilizza i risultati dell'analisi del codice per navigare e modificare i sorgenti. Se hai tempo e desideri apportare le modifiche manuali, fallo con le informazioni fornite in *Modifica manuale in MBANK7 0. BMSe SBANK7 0P. CBL(Opzionale) *.

Per modifiche rapide, copia i seguenti file:

1. Da ..\BANKDEMO-exercise\Exercis01\screens\MBANK70.BMS a D:\PhotonUser\workspace\bankdemo\source\screens.

2. Da .\BANKDEMO-exercise\Exercis01\cobol\SBANK70P.CBL a D:\PhotonUser\workspace\bankdemo\source\cobol.

3. Da ..\BANKDEMO-exercise\Exercis01\copybook\CBANKDAT.CPY a D:\PhotonUser\workspace\bankdemo\source\copybook.

4. Per assicurarti che tutti i programmi interessati dalle modifiche vengano compilati, scegli Project/Clean... /Pulisci tutto il progetto.

Per le modifiche manuali a MBANK70.BMS eSBANK70P.CBL, completa i seguenti passaggi:

• Per la modifica manuale del BMS MBANK70.BMS codice sorgente aggiungi dopo il PAYMENT campo:

  • TXT09 con gli stessi attributi di TXT 08 e INITIAL il valore «Importo totale del prestito»

  • TOTALcon gli stessi attributi di PAYMENT

Modifiche al test

Per testare le modifiche, ripeti i passaggi nelle seguenti sezioni:

1. Avvia il BANKDEMO server da Enterprise Developer

2. Avvia il terminale Rumba 3270

3. Esegui BankDemo una transazione

   Inoltre ora dovresti vedere anche il testoTotal Loan Amount.....................:.

4. Arresta il BANKDEMO server da Enterprise Developer

Nella seconda fase modificheremo BBANK70P.CBL e aggiungeremo il calcolo per l'importo totale del prestito. La fonte preparata con le modifiche richieste è disponibile nella D:\PhotonUser\My Files\Home Folder\BANKDEMO-exercise\Exercise01 cartella. Se hai tempo e desideri apportare le modifiche manuali, fallo con le informazioni fornite in *Modifica manuale in BBANK7 0P. CBL(Opzionale) *.

Per una modifica rapida, copia il seguente file:

• Da ..\BANKDEMO-exercise\Exercis01\source\cobol\BBANK70P.CBL a D:\PhotonUser\workspace\bankdemo\source\cobol.

Per apportare una modifica manuale aBBANK70P.CBL, completa i seguenti passaggi:

• Utilizzate il risultato dell'analisi del codice per identificare le modifiche richieste.

Modifiche al test

Per testare le modifiche, ripeti i passaggi nelle seguenti sezioni:

1. Avvia il BANKDEMO server da Enterprise Developer

2. Avvia il terminale Rumba 3270

3. Esegui BankDemo una transazione

   Inoltre ora dovresti vedere anche il testoTotal Loan Amount.....................: $10230.60.

4. Arresta il BANKDEMO server da Enterprise Developer

Esegui il commit delle modifiche nell' CodeCommit archivio centrale e attiva la pipeline CI/CD per creare, testare e implementare le modifiche.

1. Dal BANKDEMO progetto, nel menu contestuale, scegli Team/Commit.

2. Nella scheda Git Staging, inserisci il seguente messaggio di commit:Added Total Amount Calculation.

3. Scegli Commit e Push... .

4. Apri la CodePipeline console e controlla lo stato dell'esecuzione della pipeline.

   Nota

   In caso di problemi con la funzione Enterprise Developer o Teams Commit o Push, usa l'interfaccia a riga di comando Git Bash.

Nella prima fase estraiamo la routine di calcolo del prestito in una COBOL sezione. Questo passaggio è necessario per estrarre il codice in un COBOL programma autonomo nel passaggio successivo.

1. Apri BBANK70P.CBL nell'editor. COBOL

2. Nell'editor, scegli dal menu contestuale Code Analysis/Loan Calculation Update. Questo eseguirà la scansione della fonte corrente solo alla ricerca di modelli definiti nella regola di analisi.

3. Nel risultato nella scheda Analisi del codice, trova la prima istruzione aritmetica. DIVIDE WS-LOAN-INTEREST BY 12

4. Fai doppio clic sull'istruzione per accedere alla riga sorgente nell'Editor. Questa è la prima dichiarazione della routine di calcolo del prestito.

5. Contrassegna il seguente blocco di codice per la routine di calcolo del prestito da estrarre in una sezione.

   DIVIDE WS-LOAN-INTEREST BY 12
                GIVING WS-LOAN-INTEREST ROUNDED.
              COMPUTE WS-LOAN-MONTHLY-PAYMENT ROUNDED =
                ((WS-LOAN-INTEREST * ((1 + WS-LOAN-INTEREST)
                    ** WS-LOAN-TERM)) /
                (((1 + WS-LOAN-INTEREST) * WS-LOAN-TERM) - 1 ))
                    * WS-LOAN-PRINCIPAL.
   EXER01     COMPUTE WS-LOAN-TOTAL-PAYMENT =
   EXER01             (WS-LOAN-MONTHLY-PAYMENT * WS-LOAN-TERM). 

6. Dal menu contestuale dell'editor, scegli Refactor/Extract to Section... .

7. Inserisci il nome della nuova sezione: LOAN - CALCULATION.

8. Scegli OK.

   Il blocco di codice contrassegnato è stato ora estratto LOAN-CALCULATION nella nuova sezione e il blocco di codice è stato sostituito con l'PERFROM LOAN-CALCULATIONistruzione.

Modifiche al test

Per testare le modifiche, ripeti i passaggi descritti nelle sezioni seguenti.

1. Avvia il BANKDEMO server da Enterprise Developer

2. Avvia il terminale Rumba 3270

3. Esegui BankDemo una transazione

   Inoltre ora dovresti vedere anche il testoTotal Loan Amount.....................: $10230.60.

4. Arresta il BANKDEMO server da Enterprise Developer

   Nota

   Se vuoi evitare i passaggi precedenti per estrarre il blocco di codice in una sezione, puoi copiare il codice sorgente modificato per il passaggio 1 da ..\BANKDEMO-exercise\Exercis02\Step1\cobol\BBANK70P.CBL aD:\PhotonUser\workspace\bankdemo\source\cobol.

Nel passaggio 2 il blocco di codice della LOAN-CALCULATION sezione verrà estratto in un programma autonomo e il codice originale verrà sostituito con il codice per chiamare il nuovo sottoprogramma.

1. Apri BBANK70P.CBL nell'editor e trova la nuova PERFORM LOAN-CALCULATION istruzione creata nel passaggio 1.

2. Posiziona il cursore all'interno del nome della sezione. Sarà contrassegnato in grigio.

3. Dal menu contestuale, seleziona Refactor->Estrai sezione/paragrafo dal programma... .

4. In Estrai sezione/paragrafo da programma, inserisci Nuovo nome di file:. LOANCALC CBL.

5. Scegli OK.

   Il nuovo LOANCALC.CBL programma si aprirà nell'editor.

6. Scorri verso il basso e controlla il codice estratto e generato per l'interfaccia di chiamata.

7. Seleziona l'editor con BBANK70P.CBL e vai a. LOAN-CALCULATION SECTION Controlla il codice generato per chiamare il nuovo sottoprogrammaLOANCALC.CBL.

   Nota

   L'CALListruzione utilizza DFHEIBLK e chiama LOANCALC con DFHCOMMAREA i blocchi CICS di controllo. Poiché vogliamo chiamare il nuovo LOANCALC.CBL sottoprogramma come non CICS programma, dobbiamo rimuovere DFHEIBLK e DFHCOMMAREA interrompere la chiamata commentando o eliminando.

Modifiche ai test

Per testare le modifiche, ripeti i passaggi descritti nelle sezioni seguenti.

1. Avvia il BANKDEMO server da Enterprise Developer

2. Avvia il terminale Rumba 3270

3. Esegui BankDemo una transazione

   Inoltre ora dovresti vedere anche il testoTotal Loan Amount.....................: $10230.60.

4. Arresta il BANKDEMO server da Enterprise Developer

   Nota

   Se vuoi evitare i passaggi precedenti per estrarre il blocco di codice in una sezione, puoi copiare il codice sorgente modificato per lo Step 1 da ..\BANKDEMO-exercise\Exercis02\Step2\cobol\BBANK70P.CBL e LOANCALC.CBL versoD:\PhotonUser\workspace\bankdemo\source\cobol.

Invia le modifiche al CodeCommit repository centrale e attiva la pipeline CI/CD per creare, testare e implementare le modifiche.

1. Dal BANKDEMO progetto, nel menu contestuale, scegli Team/Commit.

2. Nella scheda Git Staging

   • Aggiungi Unstaged Stages. LOANCALC CBLe. LOANCALC CBL.mfdirset.

   • Inserisci un messaggio di commit:. Added Total Amount Calculation

3. Scegli Commit e Push... .

4. Apri la CodePipeline console e controlla lo stato dell'esecuzione della pipeline.

   Nota

   In caso di problemi con la funzione Enterprise Developer o Teams Commit o Push, usa l'interfaccia a riga di comando Git Bash.