Configura y accede a la Mainframe Assessment Tool

En esta página, se describe cómo configurar y acceder a Mainframe Assessment Tool. La herramienta de evaluación de mainframe se puede implementar como una instancia de máquina virtual (VM) o en un clúster de Google Kubernetes Engine. Solo puedes actualizar las instancias de Mainframe Assessment Tool implementadas como instancias de VM.

Después de implementar Mainframe Assessment Tool, puedes conectarte a la interfaz gráfica de usuario basada en la Web y analizar tus aplicaciones para mainframe.

Antes de comenzar

Completa los pasos para prepararte para el descubrimiento y la evaluación.

Opción 1: Configura la instancia de VM de Mainframe Assessment Tool

Para configurar una instancia de VM de la herramienta de evaluación de Mainframe, sigue estos pasos:

  1. En la Google Cloud consola, haz clic en Botón de activar ShellActivar Cloud Shell.

    Ir a la consola de Google Cloud

  2. Para crear una instancia de VM de la herramienta de evaluación de Mainframe, ejecuta el siguiente 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

    Reemplaza lo siguiente:

    • MACHINE_TYPE: Es el tipo de máquina de la VM.
    • SERVICE_ACCOUNT_NAME: Es el nombre de la cuenta de servicio dedicada que creaste.
    • PROJECT_ID: Es el ID del proyecto de Google Cloud .
    • DISK_SIZE: Es el tamaño del disco de arranque.
    • ZONE: La zona donde deseas crear la VM. Se admiten todas las zonas en las ubicaciones de extremos del modelo de Google.

    Usa la siguiente tabla para determinar los valores de MACHINE_TYPE y DISK_SIZE según el tamaño esperado de los datos de evaluación.

    Tamaño del archivo ZIP de la evaluación MACHINE_TYPE DISK_SIZE
    Menos de 5 MB e2-standard-4 100GB
    Entre 5 MB y 50 MB e2-standard-8 100GB
    Más de 50 MB o varias evaluaciones en paralelo e2-highmem-16 300 GB

    Si configuraste el firewall de tu proyecto para permitir túneles de IAP solo para las VMs con ciertas etiquetas de red, también puedes agregar las etiquetas de red con la marca --tags. Por ejemplo, --tags=assessment-iap

    Si tu proyecto ya tiene una configuración de Cloud NAT en funcionamiento, agrega la marca --no-address al comando gcloud que crea la VM.

Accede a la VM de Mainframe Assessment Tool desde tu computadora

Puedes acceder a Mainframe Assessment Tool desde tu computadora Linux, macOS o Windows con Google Cloud CLI a través de un túnel de Identity-Aware Proxy.

Para crear un túnel encriptado a un puerto de la instancia de VM de Mainframe Assessment Tool, ejecuta el siguiente comando:

   gcloud compute start-iap-tunnel VM_NAME 4000 --zone=ZONE \
     --local-host-port=localhost:LOCAL_PORT --project=PROJECT_ID

Reemplaza lo siguiente:

  • VM_NAME: el nombre de la VM.
  • ZONE: Es la zona de la VM.
  • LOCAL_PORT: Cualquier número de puerto en tu máquina local que desees usar para la conexión a través de un túnel a la herramienta de Mainframe Assessment.
  • PROJECT_ID: Es el ID del proyecto de la VM.

Google Cloud CLI realiza una prueba de conectividad con la instancia de VM. Luego, abre un túnel y muestra un número de puerto de la siguiente manera:

   Listening on port 6060.

Todo el tráfico enviado a localhost:LOCAL_PORT se reenvía a la instancia de VM de Mainframe Assessment Tool. Solo las aplicaciones que se ejecutan en tu computadora local pueden acceder al puerto.

Para acceder a Mainframe Assessment Tool desde tu computadora local, abre un navegador web y ve a localhost:LOCAL_PORT.

Opción 2: Implementa la Mainframe Assessment Tool en un clúster de GKE

Para implementar la herramienta de evaluación de mainframe en un clúster de GKE, sigue estos pasos:

  1. En la Google Cloud consola, haz clic en Botón de activar ShellActivar Cloud Shell.

    Ir a la consola de Google Cloud

  2. Habilita la API de Google Kubernetes Engine para tu proyecto Google Cloud .

  3. Si aún no existe un clúster de GKE en tu proyecto, crea uno y asegúrate de que esté configurado el grupo de identidades para cargas de trabajo.

    Para crear un clúster de GKE, ejecuta el siguiente 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

    Reemplaza lo siguiente:

    • CLUSTER_NAME: Es el nombre del clúster de GKE nuevo.
    • PROJECT_ID: Es el ID del proyecto de Google Cloud .
    • MACHINE_TYPE: Es el tipo de máquina de cada nodo.
    • ZONE: Es la zona en la que deseas crear el clúster. Se admiten todas las zonas en las ubicaciones de extremos del modelo de Google.

    • DISK_SIZE: Es el tamaño del disco de arranque.

      Usa la siguiente tabla para determinar los valores de MACHINE_TYPE y DISK_SIZE según el tamaño esperado de los datos de tu evaluación:

      Tamaño del archivo ZIP de la evaluación MACHINE_TYPE DISK_SIZE
      Menos de 5 MB e2-standard-4 100GB
      Entre 5 MB y 50 MB e2-standard-8 100GB
      Más de 50 MB o varias evaluaciones en paralelo e2-highmem-16 300 GB

  4. Habilita la federación de identidades para cargas de trabajo para GKE en clústeres y grupos de nodos.

  5. En tu entorno, crea un directorio para las secuencias de comandos de implementación:

    mkdir DESTINATION_DIRECTORY

    Reemplaza DESTINATION_DIRECTORY por un nombre para el directorio.

  6. Para descargar las secuencias de comandos de implementación, ejecuta el siguiente comando:

    gcloud storage cp "gs://mainframe-ai-release/mat/VERSION/kustomize_deployment.zip" DESTINATION_DIRECTORY

    Reemplaza lo siguiente:

    • VERSION: Es la versión de Mainframe Assessment Tool que deseas instalar, por ejemplo, mainframe-assessment-2-8-0.
    • DESTINATION_DIRECTORY: Es el directorio de destino en tu máquina donde se descarga la secuencia de comandos.

  7. Para vincular tu cuenta de servicio de Google (GSA) a la cuenta de servicio de Kubernetes (KSA), ejecuta el siguiente comando: Google Cloud 

    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]"

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto de Google Cloud .
    • VERSION: Es la versión de Mainframe Assessment Tool, por ejemplo, mainframe-assessment-2-8-0.

  8. Otorga permisos de lectura, escritura y ejecución en el directorio de destino:

    chmod -R u+rwx DESTINATION_DIRECTORY

  9. Extrae las secuencias de comandos descargadas:

    cd DESTINATION_DIRECTORY && unzip kustomize_deployment.zip

    Reemplaza DESTINATION_DIRECTORY por el directorio en el que descargaste las secuencias de comandos de implementación.

  10. Para crear los contenedores y, luego, implementar la herramienta de evaluación de Mainframe, ejecuta el siguiente 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

Los contenedores deberían estar operativos en unos minutos.

Accede a la Mainframe Assessment Tool implementada en GKE desde tu computadora

Puedes acceder a Mainframe Assessment Tool desde tu computadora Linux, macOS o Windows con el comando kubectl para configurar el reenvío de puertos.

Para crear un reenvío de puertos encriptado, sigue estos pasos:

  1. Para configurar el acceso al clúster, ejecuta el siguiente comando:

    gcloud container clusters get-credentials CLUSTER_NAME \
 --zone ZONE --project PROJECT_ID

  2. Para configurar el reenvío de puertos, ejecuta el siguiente comando:

    kubectl port-forward service/assessor-frontend LOCAL_PORT:4000 -n VERSION

    Reemplaza lo siguiente:

    • LOCAL_PORT: Es un número de puerto en tu máquina local que se usa para la conexión a través de un túnel a Mainframe Assessment Tool. Te recomendamos que uses 8080, 8000 o 3000. Si estos puertos no están disponibles, usa cualquier número de puerto superior a 1024, por ejemplo, 3001.
    • VERSION: Es la versión de la herramienta de evaluación de Mainframe implementada en el clúster de GKE.

¿Qué sigue?