Questa pagina descrive come configurare e accedere a Mainframe Assessment Tool. Mainframe Assessment Tool può essere sottoposto a deployment come istanza di macchina virtuale (VM) o su un cluster Google Kubernetes Engine. Puoi eseguire l'upgrade solo delle istanze di Mainframe Assessment Tool di cui è stato eseguito il deployment come istanza VM.
Dopo aver eseguito il deployment di Mainframe Assessment Tool, puoi connetterti e interagire con l'interfaccia utente grafica basata sul web per analizzare le applicazioni mainframe.
Prima di iniziare
Completa i passaggi per prepararti alla rilevamento e alla valutazione.
Opzione 1: configura l'istanza VM di Mainframe Assessment Tool
Per configurare un'istanza VM di Mainframe Assessment Tool:
Nella Google Cloud console, fai clic su
Attiva Cloud Shell.Per creare un'istanza VM di Mainframe Assessment Tool, esegui questo comando:
gcloud compute instances create mainframe-assessment-tool-1-instance \ --machine-type=MACHINE_TYPE \ --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --scopes=cloud-platform --image-project=migrate-modernize-public \ --image-family=mainframe-assessment-tool --zone=ZONE \ --boot-disk-size=DISK_SIZESostituisci quanto segue:
- MACHINE_TYPE: il tipo di macchina della VM.
- SERVICE_ACCOUNT_NAME: il nome del account di servizio dedicato che hai creato.
- PROJECT_ID: l' Google Cloud ID progetto.
- DISK_SIZE: le dimensioni del disco di avvio.
- ZONE: la zona in cui vuoi creare la VM. Sono supportate tutte le località degli endpoint dei modelli Google.
Utilizza la tabella seguente per determinare i valori di MACHINE_TYPE e DISK_SIZE in base alle dimensioni previste dei dati di valutazione.
Dimensioni del file ZIP di valutazione MACHINE_TYPE DISK_SIZE Inferiori a 5 MB e2-standard-4 100GB Tra 5 MB e 50 MB e2-standard-8 100GB Superiori a 50 MB o più valutazioni in parallelo e2-highmem-16 300GB Se hai configurato il firewall nel tuo progetto in modo da consentire i tunnel IAP solo per le VM con determinati tag di rete, puoi anche aggiungere i tag di rete utilizzando il flag
--tags. Ad esempio,--tags=assessment-iap.Se il tuo progetto ha già una configurazione Cloud NAT funzionante, aggiungi il flag
--no-addressal comandogcloudche crea la VM.
Accedi alla VM di Mainframe Assessment Tool dal computer
Puoi accedere a Mainframe Assessment Tool dal tuo computer basato su Linux, macOS o Windows utilizzando Google Cloud CLI tramite un tunnel Identity-Aware Proxy.
Per creare un tunnel criptato su una porta dell'istanza VM di Mainframe Assessment Tool, esegui questo comando:
gcloud compute start-iap-tunnel VM_NAME 4000 --zone=ZONE \
--local-host-port=localhost:LOCAL_PORT --project=PROJECT_ID
Sostituisci quanto segue:
- VM_NAME: il nome della VM.
- ZONE: la zona della VM.
- LOCAL_PORT: qualsiasi numero di porta sulla macchina locale che vuoi utilizzare per la connessione tramite tunnel a Mainframe Assessment Tool.
- PROJECT_ID: l'ID progetto della VM.
Google Cloud CLI esegue un test di connettività con l'istanza VM, quindi apre un tunnel e mostra un numero di porta come segue:
Listening on port 6060.
Tutto il traffico inviato a localhost:LOCAL_PORT viene inoltrato
all'istanza VM di Mainframe Assessment Tool. La porta è accessibile solo dalle applicazioni in esecuzione sul computer locale.
Per accedere a Mainframe Assessment Tool dal computer locale, apri un browser web e vai
a localhost:LOCAL_PORT.
Opzione 2: esegui il deployment di Mainframe Assessment Tool su un cluster GKE
Per eseguire il deployment di Mainframe Assessment Tool su un cluster GKE:
Nella Google Cloud console, fai clic su
Attiva Cloud Shell.Abilita l'API Google Kubernetes Engine per il tuo Google Cloud progetto.
Se nel tuo progetto non esiste già un cluster GKE, creane uno e assicurati che sia configurato il pool di identità del carico di lavoro.
Per creare un cluster GKE, esegui questo comando:
gcloud container clusters create CLUSTER_NAME \ --project=PROJECT_ID \ --zone=ZONE \ --machine-type=MACHINE_TYPE \ --enable-ip-alias \ --release-channel="stable" \ --workload-pool=PROJECT_ID.svc.id.goog \ --disk-size=DISK_SIZESostituisci quanto segue:
- CLUSTER_NAME: il nome del nuovo cluster GKE.
- PROJECT_ID: l' Google Cloud ID progetto.
- MACHINE_TYPE: il tipo di macchina di ogni nodo.
- ZONE: la zona in cui vuoi creare il cluster. Sono supportate tutte le località degli endpoint dei modelli Google.
DISK_SIZE: le dimensioni del disco di avvio.
Utilizza la tabella seguente per determinare i valori di MACHINE_TYPE e DISK_SIZE in base alle dimensioni previste dei dati di valutazione:
Dimensioni del file ZIP di valutazione MACHINE_TYPE DISK_SIZE Inferiori a 5 MB e2-standard-4 100GB Tra 5 MB e 50 MB e2-standard-8 100GB Superiori a 50 MB o più valutazioni in parallelo e2-highmem-16 300GB
Abilita Workload Identity Federation for GKE su cluster e pool di nodi.
Nel tuo ambiente, crea una directory per gli script di deployment:
mkdir DESTINATION_DIRECTORYSostituisci
DESTINATION_DIRECTORYcon un nome per la directory.Per scaricare gli script di deployment, esegui questo comando:
gcloud storage cp "gs://mainframe-ai-release/mat/VERSION/kustomize_deployment.zip" DESTINATION_DIRECTORYSostituisci quanto segue:
- VERSION: la versione di Mainframe Assessment Tool che vuoi installare, ad esempio
mainframe-assessment-2-8-0. - DESTINATION_DIRECTORY: la directory di destinazione sulla tua macchina in cui viene scaricato lo script.
- VERSION: la versione di Mainframe Assessment Tool che vuoi installare, ad esempio
Per associare il tuo Google Cloud service account (GSA) al service account Kubernetes (KSA), esegui questo comando:
gcloud iam service-accounts add-iam-policy-binding \ SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --role="roles/iam.workloadIdentityUser" \ --member="serviceAccount:PROJECT_ID.svc.id.goog[VERSION/mat-service-account]"Sostituisci quanto segue:
- PROJECT_ID: l' Google Cloud ID progetto.
- VERSION: la versione di Mainframe Assessment Tool, ad esempio
mainframe-assessment-2-8-0.
Concedi le autorizzazioni di lettura, scrittura ed esecuzione nella directory di destinazione:
chmod -R u+rwx DESTINATION_DIRECTORYEstrai gli script scaricati:
cd DESTINATION_DIRECTORY && unzip kustomize_deployment.zipSostituisci DESTINATION_DIRECTORY con la directory in cui hai scaricato gli script di deployment.
Per creare i container ed eseguire il deployment di Mainframe Assessment Tool, esegui questo comando:
./deploy.sh PROJECT_ID ZONE \ CLUSTER_NAME VERSION \ us-docker.pkg.dev/migrate-modernize-public/mainframe-assessment-prod \ SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
I container dovrebbero essere operativi entro pochi minuti.
Accedi a Mainframe Assessment Tool di cui è stato eseguito il deployment su GKE dal computer
Puoi accedere a Mainframe Assessment Tool dal tuo computer Linux, macOS o Windows utilizzando il comando kubectl per configurare l'inoltro delle porte.
Per creare l'inoltro delle porte criptato:
Per configurare l'accesso al cluster, esegui questo comando:
gcloud container clusters get-credentials CLUSTER_NAME \ --zone ZONE --project PROJECT_IDPer configurare l'inoltro delle porte, esegui questo comando:
kubectl port-forward service/assessor-frontend LOCAL_PORT:4000 -n VERSIONSostituisci quanto segue:
- LOCAL_PORT: un numero di porta sulla macchina locale
utilizzato per la connessione tramite tunnel a Mainframe Assessment Tool. Ti consigliamo di utilizzare
8080,8000o3000. Se queste porte non sono disponibili, utilizza un numero di porta superiore a 1024, ad esempio3001. - VERSION: la versione di Mainframe Assessment Tool di cui è stato eseguito il deployment sul cluster GKE.
- LOCAL_PORT: un numero di porta sulla macchina locale
utilizzato per la connessione tramite tunnel a Mainframe Assessment Tool. Ti consigliamo di utilizzare