Configurer et accéder à Mainframe Assessment Tool

Cette page explique comment configurer et accéder à l'outil Mainframe Assessment. L'outil Mainframe Assessment 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 l'outil Mainframe Assessment Tool déployées en tant qu'instance de VM.

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

Avant de commencer

Suivez la procédure pour préparer la découverte et l'évaluation.

Option 1 : Configurer l'instance de VM Mainframe Assessment Tool

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

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

    Accéder à la console Google Cloud

  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 projet Google Cloud .
    • DISK_SIZE : taille du disque de démarrage.
    • ZONE : zone dans laquelle vous souhaitez créer la VM. Toutes les zones des emplacements des points de terminaison des modèles Google sont acceptées.

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

    Taille du fichier ZIP de l'é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. 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 à l'outil 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 : n'importe quel numéro de port sur votre ordinateur local que vous souhaitez utiliser pour la connexion tunnelisée à l'outil Mainframe Assessment.
  • PROJECT_ID : ID du projet de la VM.

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 à l'outil d'évaluation Mainframe 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 l'outil Mainframe Assessment Tool sur un cluster GKE, procédez comme suit :

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

    Accéder à la console Google Cloud

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

  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 projet Google Cloud .
    • MACHINE_TYPE : type de machine de chaque nœud.
    • ZONE : zone dans laquelle vous souhaitez créer le cluster Toutes les zones des emplacements des points de terminaison des modèles Google sont acceptées.

    • 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 attendue de vos données d'évaluation :

      Taille du fichier ZIP de l'é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 le nom du 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 ordinateur où le script est téléchargé.

  7. Pour associer votre compte de service Google Cloud (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 projet Google Cloud .
    • 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 l'outil Mainframe Assessment, 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 à l'outil d'évaluation du mainframe depuis votre ordinateur Linux, macOS ou Windows en utilisant 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 ordinateur local 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 un numéro de port supérieur à 1024, par exemple 3001.
    • VERSION : version de Mainframe Assessment Tool déployée sur le cluster GKE.

Étapes suivantes