Configurar e acessar a Mainframe Assessment Tool

Esta página descreve como configurar e acessar a Mainframe Assessment Tool. A Mainframe Assessment Tool pode ser implantada como uma instância de máquina virtual (VM) ou em um cluster do Google Kubernetes Engine. Só é possível fazer upgrade das instâncias da Mainframe Assessment Tool implantadas como uma instância de VM.

Depois de implantar a Mainframe Assessment Tool, você pode se conectar e interagir com a interface gráfica do usuário baseada na Web para analisar seus aplicativos de mainframe.

Antes de começar

Conclua as etapas para se preparar para a descoberta e a avaliação.

Opção 1: configurar a instância de VM da Mainframe Assessment Tool

Para configurar uma instância de VM da Mainframe Assessment Tool, siga estas etapas:

  1. No Google Cloud console do, clique em Botão "Ativar shell"Ativar o Cloud Shell.

    Acesse o Google Cloud console

  2. Para criar uma instância de VM da Mainframe Assessment Tool, execute o seguinte 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

    Substitua:

    • MACHINE_TYPE: o tipo de máquina da VM.
    • SERVICE_ACCOUNT_NAME: o nome da conta de serviço dedicada que você criou.
    • PROJECT_ID: o Google Cloud ID do projeto.
    • DISK_SIZE: o tamanho do disco de inicialização.
    • ZONE: a zona em que você quer criar a VM. Todos os locais de endpoint do modelo do Google são compatíveis.

    Use a tabela a seguir para determinar os valores de MACHINE_TYPE e DISK_SIZE com base no tamanho esperado dos dados de avaliação.

    Tamanho do arquivo ZIP de avaliação MACHINE_TYPE DISK_SIZE
    Menor que 5 MB e2-standard-4 100GB
    Entre 5 MB e 50 MB e2-standard-8 100GB
    Maior que 50 MB ou várias avaliações em paralelo e2-highmem-16 300GB

    Se você configurou o firewall no projeto para permitir túneis IAP apenas para VMs com determinadas tags de rede, também é possível adicionar as tags de rede usando a flag --tags. Por exemplo, --tags=assessment-iap.

    Se o projeto já tiver uma configuração do Cloud NAT em funcionamento, adicione a flag --no-address ao comando gcloud que cria a VM.

Acessar a VM da Mainframe Assessment Tool no computador

É possível acessar a Mainframe Assessment Tool no computador Linux, macOS ou Windows usando a Google Cloud CLI por um túnel do Identity-Aware Proxy.

Para criar um túnel criptografado para uma porta da instância de VM da Mainframe Assessment Tool, execute o seguinte comando:

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

Substitua:

  • VM_NAME: o nome da VM.
  • ZONE: a zona da VM.
  • LOCAL_PORT: qualquer número de porta na máquina local que você quer usar para a conexão em túnel com a Mainframe Assessment Tool.
  • PROJECT_ID: o ID do projeto da VM.

A Google Cloud CLI executa um teste de conectividade com a instância de VM, abre um túnel e mostra um número de porta da seguinte maneira:

   Listening on port 6060.

Todo o tráfego enviado para localhost:LOCAL_PORT é encaminhado para a instância de VM da Mainframe Assessment Tool. A porta só pode ser acessada por aplicativos em execução no computador local.

Para acessar a Mainframe Assessment Tool no computador local, abra um navegador da Web e acesse localhost:LOCAL_PORT.

Opção 2: implantar a Mainframe Assessment Tool em um cluster do GKE

Para implantar a Mainframe Assessment Tool em um cluster do GKE, siga estas etapas:

  1. No Google Cloud console do, clique em Botão "Ativar shell"Ativar o Cloud Shell.

    Acesse o Google Cloud console

  2. Ative a API Google Kubernetes Engine para o Google Cloud projeto.

  3. Se um cluster do GKE ainda não existir no projeto, crie um cluster do GKE e verifique se o pool de identidade da carga de trabalho está configurado.

    Para criar um cluster do GKE, execute o seguinte 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

    Substitua:

    • CLUSTER_NAME: o nome do novo cluster do GKE.
    • PROJECT_ID: o Google Cloud ID do projeto.
    • MACHINE_TYPE: o tipo de máquina de cada nó.
    • ZONE: a zona em que você quer criar o cluster. Todos os locais de endpoint do modelo do Google são compatíveis.

    • DISK_SIZE: o tamanho do disco de inicialização.

      Use a tabela a seguir para determinar os valores de MACHINE_TYPE e DISK_SIZE com base no tamanho esperado dos dados de avaliação:

      Tamanho do arquivo ZIP de avaliação MACHINE_TYPE DISK_SIZE
      Menor que 5 MB e2-standard-4 100GB
      Entre 5 MB e 50 MB e2-standard-8 100GB
      Maior que 50 MB ou várias avaliações em paralelo e2-highmem-16 300GB

  4. Ative a federação de identidade da carga de trabalho para o GKE em clusters e pools de nós.

  5. No seu ambiente, crie um diretório para os scripts de implantação:

    mkdir DESTINATION_DIRECTORY

    Substitua DESTINATION_DIRECTORY por um nome para o diretório.

  6. Para fazer o download dos scripts de implantação, execute o seguinte comando:

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

    Substitua:

    • VERSION: a versão da Mainframe Assessment Tool que você quer instalar, por exemplo, mainframe-assessment-2-8-0.
    • DESTINATION_DIRECTORY: o diretório de destino na sua máquina em que o script é baixado.

  7. Para vincular sua Google Cloud conta de serviço (GSA) à conta de serviço do Kubernetes (KSA), execute o seguinte 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]"

    Substitua:

    • PROJECT_ID: o Google Cloud ID do projeto.
    • VERSION: a versão da Mainframe Assessment Tool, por exemplo, mainframe-assessment-2-8-0.

  8. Conceda permissões de leitura, gravação e execução no diretório de destino:

    chmod -R u+rwx DESTINATION_DIRECTORY

  9. Extraia os scripts baixados:

    cd DESTINATION_DIRECTORY && unzip kustomize_deployment.zip

    Substitua DESTINATION_DIRECTORY pelo diretório em que você baixou os scripts de implantação.

  10. Para criar os contêineres e implantar a Mainframe Assessment Tool, execute o seguinte 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

Os contêineres precisam estar operacionais em alguns minutos.

O servidor MCP está desativado por padrão. Para instruções sobre como ativar o servidor nessa implantação, consulte Ativar o servidor MCP em um cluster do GKE.

Acessar a Mainframe Assessment Tool implantada no GKE no computador

É possível acessar a Mainframe Assessment Tool no computador Linux, macOS ou Windows usando o comando kubectl para configurar o encaminhamento de portas.

Para criar o encaminhamento de portas criptografado, siga estas etapas:

  1. Para configurar o acesso ao cluster, execute o seguinte comando:

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

  2. Para configurar o encaminhamento de portas, execute o seguinte comando:

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

    Substitua:

    • LOCAL_PORT: um número de porta na máquina local usado para a conexão em túnel com a Mainframe Assessment Tool. Recomendamos usar 8080, 8000 ou 3000. Se essas portas não estiverem disponíveis, use qualquer número de porta maior que 1024, por exemplo, 3001.
    • VERSION: a versão da Mainframe Assessment Tool implantada no cluster do GKE.

A seguir