Configurer et accéder à Mainframe Assessment Tool

Cette page explique comment configurer et accéder à Mainframe Assessment Tool. Mainframe Assessment Tool peut être déployé en tant qu'instance de machine virtuelle (VM) ou sur un cluster Google Kubernetes Engine. Vous ne pouvez mettre à niveau que les instances de Mainframe Assessment Tool déployées en tant qu'instance de VM.

Une fois Mainframe Assessment Tool déployé, vous pouvez vous connecter à l'interface utilisateur graphique Web et interagir avec elle pour analyser vos applications mainframe.

Avant de commencer

Suivez les étapes pour préparer la découverte et l'évaluation.

Option 1 : Configurer une instance de VM Mainframe Assessment Tool

Pour configurer une instance de VM Mainframe Assessment Tool, procédez comme suit :

  1. Dans la Google Cloud console, cliquez sur Bouton d'activation de Cloud ShellActiver Cloud Shell.

    Accéder à la Google Cloud console

  2. Pour créer une instance de VM Mainframe Assessment Tool, exécutez la commande suivante :

    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

    Remplacez les éléments suivants :

    • MACHINE_TYPE : type de machine de la VM.
    • SERVICE_ACCOUNT_NAME : nom du compte de service dédié que vous avez créé.
    • PROJECT_ID: ID de votre Google Cloud projet.
    • DISK_SIZE : taille du disque de démarrage.
    • ZONE : zone dans laquelle vous souhaitez créer la VM. Toutes les zones des emplacements de points de terminaison du modèle Google sont compatibles.

    Utilisez le tableau suivant pour déterminer les valeurs de MACHINE_TYPE et DISK_SIZE en fonction de la taille prévue de vos données d'évaluation.

    Taille du fichier ZIP d'évaluation MACHINE_TYPE DISK_SIZE
    Moins de 5 Mo e2-standard-4 100 Go
    Entre 5 Mo et 50 Mo e2-standard-8 100 Go
    Plus de 50 Mo ou plusieurs évaluations en parallèle e2-highmem-16 300 Go

    Si vous avez configuré le pare-feu de votre projet pour n'autoriser les tunnels IAP que pour les VM avec certains tags réseau, vous pouvez également ajouter les tags réseau à l'aide de l'indicateur --tags. Par exemple, --tags=assessment-iap.

    Si votre projet dispose déjà d'une configuration Cloud NAT fonctionnelle, ajoutez l'indicateur --no-address à la commande gcloud qui crée la VM.

Accéder à la VM Mainframe Assessment Tool depuis votre ordinateur

Vous pouvez accéder à Mainframe Assessment Tool depuis votre ordinateur Linux, macOS ou Windows à l'aide de la Google Cloud CLI via un tunnel Identity-Aware Proxy.

Pour créer un tunnel chiffré vers un port de l'instance de VM Mainframe Assessment Tool, exécutez la commande suivante :

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

Remplacez les éléments suivants :

  • VM_NAME : nom de la VM.
  • ZONE : zone de la VM.
  • LOCAL_PORT : numéro de port de votre machine locale que vous souhaitez utiliser pour la connexion tunnelisée à Mainframe Assessment Tool.
  • PROJECT_ID : ID du projet de la VM.

La Google Cloud CLI effectue un test de connectivité avec l'instance de VM, puis ouvre un tunnel et affiche un numéro de port comme suit :

   Listening on port 6060.

Tout le trafic envoyé à localhost:LOCAL_PORT est transféré à l'instance de VM Mainframe Assessment Tool. Le port n'est accessible que par les applications exécutées sur votre ordinateur local.

Pour accéder à Mainframe Assessment Tool depuis votre ordinateur local, ouvrez un navigateur Web et accédez à localhost:LOCAL_PORT.

Option 2 : Déployer Mainframe Assessment Tool sur un cluster GKE

Pour déployer Mainframe Assessment Tool sur un cluster GKE, procédez comme suit :

  1. Dans la Google Cloud console, cliquez sur Bouton d'activation de Cloud ShellActiver Cloud Shell.

    Accéder à la Google Cloud console

  2. Activez l'API Google Kubernetes Engine pour votre Google Cloud projet.

  3. Si aucun cluster GKE n'existe déjà dans votre projet, créez-en un et assurez-vous que le pool d'identités de charge de travail est configuré.

    Pour créer un cluster GKE, exécutez la commande suivante :

      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

    Remplacez les éléments suivants :

    • CLUSTER_NAME : nom du nouveau cluster GKE
    • PROJECT_ID: ID de votre Google Cloud projet.
    • MACHINE_TYPE : type de machine de chaque nœud.
    • ZONE : zone dans laquelle vous souhaitez créer le cluster. Toutes les zones des emplacements de points de terminaison du modèle Google sont compatibles.

    • DISK_SIZE : taille du disque de démarrage.

      Utilisez le tableau suivant pour déterminer les valeurs de MACHINE_TYPE et DISK_SIZE en fonction de la taille prévue de vos données d'évaluation :

      Taille du fichier ZIP d'évaluation MACHINE_TYPE DISK_SIZE
      Moins de 5 Mo e2-standard-4 100 Go
      Entre 5 Mo et 50 Mo e2-standard-8 100 Go
      Plus de 50 Mo ou plusieurs évaluations en parallèle e2-highmem-16 300 Go

  4. Activez la fédération d'identité de charge de travail pour GKE sur les clusters et les pools de nœuds.

  5. Dans votre environnement, créez un répertoire pour les scripts de déploiement :

    mkdir DESTINATION_DIRECTORY

    Remplacez DESTINATION_DIRECTORY par un nom pour le répertoire.

  6. Pour télécharger les scripts de déploiement, exécutez la commande suivante :

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

    Remplacez les éléments suivants :

    • VERSION : version de Mainframe Assessment Tool que vous souhaitez installer, par exemple mainframe-assessment-2-8-0.
    • DESTINATION_DIRECTORY : répertoire de destination sur votre machine où le script est téléchargé.

  7. Pour associer votre Google Cloud compte de service (GSA) au compte de service Kubernetes (KSA), exécutez la commande suivante :

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

    Remplacez les éléments suivants :

    • PROJECT_ID: ID de votre Google Cloud projet.
    • VERSION : version de Mainframe Assessment Tool, par exemple mainframe-assessment-2-8-0.

  8. Accordez les autorisations de lecture, d'écriture et d'exécution sur le répertoire de destination :

    chmod -R u+rwx DESTINATION_DIRECTORY

  9. Extrayez les scripts téléchargés :

    cd DESTINATION_DIRECTORY && unzip kustomize_deployment.zip

    Remplacez DESTINATION_DIRECTORY par le répertoire dans lequel vous avez téléchargé les scripts de déploiement.

  10. Pour créer les conteneurs et déployer Mainframe Assessment Tool, exécutez la commande suivante :

    ./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

Les conteneurs devraient être opérationnels en quelques minutes.

Accéder à Mainframe Assessment Tool déployé sur GKE depuis votre ordinateur

Vous pouvez accéder à Mainframe Assessment Tool depuis votre ordinateur Linux, macOS ou Windows à l'aide de la commande kubectl pour configurer le transfert de port.

Pour créer un transfert de port chiffré, procédez comme suit :

  1. Pour configurer l'accès au cluster, exécutez la commande suivante :

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

  2. Pour configurer le transfert de port, exécutez la commande suivante :

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

    Remplacez les éléments suivants :

    • LOCAL_PORT : numéro de port sur votre machine locale utilisé pour la connexion tunnelisée à Mainframe Assessment Tool. Nous vous recommandons d'utiliser 8080, 8000 ou 3000. Si ces ports ne sont pas disponibles, utilisez n'importe quel numéro de port supérieur à 1024, par exemple 3001.
    • VERSION : version de Mainframe Assessment Tool déployée sur le cluster GKE.

Étape suivante