Configurare e accedere a Mainframe Assessment Tool

Questa pagina descrive come configurare e accedere a Mainframe Assessment Tool. Lo strumento di valutazione del mainframe può essere implementato 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 tue applicazioni mainframe.

Prima di iniziare

Completa i passaggi per prepararti alla scoperta e alla valutazione.

Opzione 1: configura l'istanza VM di Mainframe Assessment Tool

Per configurare un'istanza VM di Mainframe Assessment Tool:

Nella console Google Cloud , fai clic su Attiva Cloud Shell.
Vai alla console Google Cloud

Per creare un'istanza VM di Mainframe Assessment Tool, esegui il seguente 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_SIZE

Sostituisci 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: il tuo ID progetto Google Cloud .
DISK_SIZE: le dimensioni del disco di avvio.
ZONE: la zona in cui vuoi creare la VM. Sono supportate tutte le zone nelle posizioni degli endpoint del modello 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 del test	`MACHINE_TYPE`	`DISK_SIZE`
Meno di 5 MB	e2-standard-4	100 GB
Tra 5 MB e 50 MB	e2-standard-8	100 GB
Più di 50 MB o più valutazioni in parallelo	e2-highmem-16	300GB

Se hai configurato il firewall nel tuo progetto per 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-address al comando gcloud che crea la VM.

Accedere 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 a una porta dell'istanza VM di Mainframe Assessment Tool, esegui il seguente 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 tua macchina locale che vuoi utilizzare per la connessione in tunnel allo strumento di valutazione mainframe.
PROJECT_ID: l'ID progetto del progetto 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 alle applicazioni in esecuzione sul computer locale.

Per accedere a Mainframe Assessment Tool dal computer locale, apri un browser web e vai all'indirizzo 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 console Google Cloud , fai clic su Attiva Cloud Shell.
Vai alla console Google Cloud
Abilita l'API Google Kubernetes Engine per il tuo progetto Google Cloud .

Se nel tuo progetto non esiste già un cluster GKE, creane uno e assicurati che il pool di identità dei workload sia configurato.

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_SIZE

Sostituisci quanto segue:

CLUSTER_NAME: il nome del nuovo cluster GKE
PROJECT_ID: il tuo ID progetto Google Cloud .
MACHINE_TYPE: il tipo di macchina di ogni nodo.
ZONE: la zona in cui vuoi creare il cluster. Sono supportate tutte le zone nelle posizioni degli endpoint del modello 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 del test	`MACHINE_TYPE`	`DISK_SIZE`
Meno di 5 MB	e2-standard-4	100 GB
Tra 5 MB e 50 MB	e2-standard-8	100 GB
Più di 50 MB o più valutazioni in parallelo	e2-highmem-16	300GB

Abilita Workload Identity Federation for GKE su cluster e pool di nodi.

Nota :in GKE Autopilot, Workload Identity Federation è sempre abilitata.
Nel tuo ambiente, crea una directory per gli script di deployment:
```
mkdir DESTINATION_DIRECTORY
```
Sostituisci DESTINATION_DIRECTORY con 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_DIRECTORY
```
Sostituisci 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 macchina in cui viene scaricato lo script.
Per associare il tuo service account Google Cloud (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: il tuo ID progetto Google Cloud .
- 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_DIRECTORY
```
Estrai gli script scaricati:
```
cd DESTINATION_DIRECTORY && unzip kustomize_deployment.zip
```
Sostituisci DESTINATION_DIRECTORY con la directory in cui hai scaricato gli script di deployment.

Per creare i container e implementare 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.

Accedere a Mainframe Assessment Tool di cui è stato eseguito il deployment in 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_ID

Per configurare il port forwarding, esegui questo comando:
```
kubectl port-forward service/assessor-frontend LOCAL_PORT:4000 -n VERSION
```
Sostituisci quanto segue:
- LOCAL_PORT: un numero di porta sulla macchina locale utilizzato per la connessione in tunnel a Mainframe Assessment Tool. Ti consigliamo di utilizzare 8080, 8000 o 3000. Se queste porte non sono disponibili, utilizza un numero di porta superiore a 1024, ad esempio 3001.
- VERSION: la versione di Mainframe Assessment Tool di cui è stato eseguito il deployment sul cluster GKE.

Passaggi successivi

Scopri come configurare le impostazioni di Mainframe Assessment Tool.

Configurare e accedere a Mainframe Assessment Tool Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Opzione 1: configura l'istanza VM di Mainframe Assessment Tool

Accedere alla VM di Mainframe Assessment Tool dal computer

Opzione 2: esegui il deployment di Mainframe Assessment Tool su un cluster GKE

Accedere a Mainframe Assessment Tool di cui è stato eseguito il deployment in GKE dal computer

Passaggi successivi

Configurare e accedere a Mainframe Assessment Tool