Configurar e acessar a Mainframe Assessment Tool

Nesta página, descrevemos como configurar e acessar a Mainframe Assessment Tool. A ferramenta de avaliação de mainframe 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 ferramenta de avaliação de mainframe, é possível 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 ferramenta de avaliação de mainframe, siga estas etapas:

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

    Acesse o console do Google Cloud .

  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 ID do projeto Google Cloud .
    • DISK_SIZE: o tamanho do disco de inicialização.
    • ZONE: a zona em que você quer criar a VM. Todas as zonas nos 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 da avaliação MACHINE_TYPE DISK_SIZE
    Com menos de 5 MB e2-standard-4 100 GB
    Entre 5 MB e 50 MB e2-standard-8 100 GB
    Maior que 50 MB ou várias avaliações em paralelo e2-highmem-16 300GB

    Se você configurou o firewall no seu projeto para permitir túneis do 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 funcional do Cloud NAT, adicione a flag --no-address ao comando gcloud que cria a VM.

Acessar a VM da Mainframe Assessment Tool no seu computador

É possível acessar a ferramenta de avaliação de mainframe em um computador com 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 ferramenta de avaliação do mainframe, 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ê queira 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 da VM da Mainframe Assessment Tool. A porta é acessível apenas por aplicativos em execução no seu computador local.

Para acessar a ferramenta de avaliação do mainframe 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 ferramenta de avaliação de mainframe em um cluster do GKE, siga estas etapas:

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

    Acesse o console do Google Cloud .

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

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

    Para criar um cluster do GKE, execute o comando a seguir:

      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 ID do projeto Google Cloud .
    • MACHINE_TYPE: o tipo de máquina de cada nó.
    • ZONE: a zona em que você quer criar o cluster; Todas as zonas nos 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 da avaliação MACHINE_TYPE DISK_SIZE
      Com menos de 5 MB e2-standard-4 100 GB
      Entre 5 MB e 50 MB e2-standard-8 100 GB
      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 máquina em que o script é baixado.

  7. Para vincular sua conta de serviço Google Cloud (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 ID do projeto Google Cloud .
    • 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 ferramenta de avaliação do mainframe, 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 devem estar operacionais em alguns minutos.

Acessar a Mainframe Assessment Tool implantada no GKE pelo computador

É possível acessar a ferramenta de avaliação do mainframe em um computador Linux, macOS ou Windows usando o comando kubectl para configurar o encaminhamento de porta.

Para criar um encaminhamento de porta 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