AWS Le service de modernisation du mainframe (expérience de l'environnement d'exécution géré) n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires au service de modernisation AWS du mainframe (expérience de l'environnement d'exécution géré), explorez le service de modernisation AWS du mainframe (expérience autogérée). Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section [Modification de la disponibilité de la modernisation du AWS mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Tutoriel : utilisation de AWS Transform pour les développeurs de mainframe sur des applications WorkSpaces
Ce didacticiel explique comment accéder à AWS Transform for mainframe Developer on WorkSpaces Applications et comment l'utiliser avec un exemple d'application afin de tester les fonctionnalités. Lorsque vous aurez terminé ce didacticiel, vous pourrez suivre les mêmes étapes avec vos propres applications.
**Topics**
+ [Étape 1 : Créer une base de données](#tutorial-ba-developer-create-db)
+ [Étape 2 : Accès à l'environnement](#tutorial-ba-developer-access-env)
+ [Étape 3 : configurer le moteur d'exécution](#tutorial-ba-developer-set-up-runtime)
+ [Étape 4 : démarrer l'IDE Eclipse](#tutorial-ba-developer-start-eclipse)
+ [Étape 5 : configurer un projet Maven](#tutorial-ba-developer-set-up-maven)
+ [Étape 6 : Configuration d'un serveur Tomcat](#tutorial-ba-developer-config-tomcat)
+ [Étape 7 : Déployer sur Tomcat](#tutorial-ba-developer-deploy-tomcat)
+ [Étape 8 : Création de la base de données JICS](#tutorial-ba-developer-create-jics)
+ [Étape 9 : démarrer et tester l'application](#tutorial-ba-developer-test-app)
+ [Étape 10 : Déboguer l'application](#tutorial-ba-developer-debug)
+ [nettoyer des ressources ;](#tutorial-ba-developer-clean)
## Étape 1 : Créer une base de données
Au cours de cette étape, vous utilisez Amazon RDS pour créer une base de données PostgreSQL gérée que l'application de démonstration utilise pour stocker les informations de configuration.
1. Ouvrez la console Amazon RDS.
1. Choisissez **Bases de données > Créer une base de données**.
1. **Choisissez **Standard create > PostgreSQL**, conservez la version par défaut, puis choisissez Free tier.**
1. Choisissez un identifiant d'instance de base de données.
1. Pour les **paramètres d'identification**, choisissez **Gérer les informations d'identification principales dans AWS Secrets Manager**. Pour plus informations, consultez [Gestion des mots de passe avec Amazon RDS et AWS Secrets Manager](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html) (français non garanti) dans le *Guide de l'utilisateur Amazon RDS* (français non garanti).
1. Assurez-vous que le VPC est le même que celui que vous utilisez pour l'instance WorkSpaces Applications. Vous pouvez demander cette valeur à votre administrateur.
1. Pour le **groupe de sécurité VPC**, choisissez **Create** New.
1. Réglez **l'accès public** sur **Oui**.
1. Conservez toutes les autres valeurs par défaut. Passez en revue ces valeurs.
1. Choisissez **Créer une base de données**.
Pour rendre le serveur de base de données accessible depuis votre instance, sélectionnez le serveur de base de données dans Amazon RDS. Sous **Connectivité et sécurité**, choisissez le groupe de sécurité VPC pour le serveur de base de données. Ce groupe de sécurité a déjà été créé pour vous et doit avoir une description similaire à celle décrite dans la section **Créé par la console de gestion RDS**. Choisissez **Action > Modifier les règles entrantes**, choisissez **Ajouter une règle** et créez une règle de type **PostgreSQL**. Pour la source des règles, utilisez le groupe de sécurité **par défaut**. Vous pouvez commencer à saisir le nom de la **source dans le champ Source**, puis accepter l'ID suggéré. Enfin, choisissez **Enregistrer les règles**.
## Étape 2 : Accès à l'environnement
Au cours de cette étape, vous accédez à l'environnement de développement AWS Transform for mainframe sur WorkSpaces Applications.
1. Contactez votre administrateur pour savoir comment accéder correctement à votre instance WorkSpaces Applications. Pour obtenir des informations générales sur les clients et les configurations possibles, consultez la section [Méthodes et clients d'accès aux WorkSpaces applications](https://docs.aws.amazon.com/appstream2/latest/developerguide/clients-access-methods-user.html) dans le *guide d'administration WorkSpaces des applications Amazon*. Envisagez d'utiliser le client natif pour une expérience optimale.
1. Dans WorkSpaces Applications, sélectionnez **Desktop**.
## Étape 3 : configurer le moteur d'exécution
Au cours de cette étape, vous configurez le moteur d'exécution AWS Transform for mainframe. Vous devez configurer le moteur d'exécution au premier lancement, puis à nouveau si vous êtes informé d'une mise à niveau du moteur d'exécution. Cette étape permet de remplir votre `.m2` dossier.
1. Choisissez **Applications** dans la barre de menu, puis **Terminal**.
1. Entrez la commande suivante :
```
~/_install-velocity-runtime.sh
```
## Étape 4 : démarrer l'IDE Eclipse
Au cours de cette étape, vous démarrez l'IDE Eclipse et choisissez un emplacement dans lequel vous souhaitez créer un espace de travail.
1. Dans WorkSpaces Applications, choisissez l'icône Lancer l'application dans la barre d'outils, puis choisissez **Eclipse JEE.**
![\[Lancez l'icône de l'application dans la barre d'outils WorkSpaces des applications. Eclipse JEE est sélectionné.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/aas-ba-eclipse.png)
1. Lorsque le lanceur s'ouvre, entrez l'emplacement où vous souhaitez créer votre espace de travail, puis choisissez **Launch**.
![\[AWS Transform for mainframeLanceur Eclipse IDE dans WorkSpaces Applications. L'espace de travail est sélectionné.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-launcher.png)
Vous pouvez éventuellement lancer Eclipse depuis la ligne de commande, comme suit :
```
~/eclipse &
```
## Étape 5 : configurer un projet Maven
Au cours de cette étape, vous importez un projet Maven pour l'application de démonstration Planets.
1. Téléchargez le [PlanetsDemofichier -pom.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-pom.zip) dans votre dossier d'accueil. Pour ce faire, vous pouvez utiliser la fonctionnalité « Mes fichiers » du client natif.
1. Utilisez l'outil de ligne de `unzip` commande pour extraire les fichiers.
1. Naviguez dans le dossier décompressé et ouvrez la racine `pom.xml` de votre projet dans un éditeur de texte.
1. Modifiez la `gapwalk.version` propriété afin qu'elle corresponde au moteur d'exécution AWS Transform for mainframe installé.
Si vous n'êtes pas sûr de la version installée, lancez la commande suivante dans un terminal :
```
cat ~/runtime-version.txt
```
Cette commande imprime la version d'exécution actuellement disponible, par exemple`3.1.0-b3257-dev`.
**Note**
N'incluez pas le `-dev` suffixe dans. `gapwalk.version` Par exemple, une valeur valide serait`3.1.0-b3257`.
1. Dans Eclipse, choisissez **Fichier**, puis **Importer**. Dans la fenêtre de dialogue **Importer**, développez **Maven** et choisissez **Existing Maven Projects**. Choisissez **Suivant**.
1. Dans **Import Maven Projects**, indiquez l'emplacement des fichiers extraits et choisissez **Terminer.**
Vous pouvez ignorer la fenêtre contextuelle suivante en toute sécurité. Maven télécharge une copie locale de `node.js` pour créer la partie Angular (\$1-web) du projet :
![\[Message d'avertissement concernant l'absence de node.js.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-node-warning.png)
Attendez la fin de la construction. Vous pouvez suivre la construction dans la vue **Progression**.
1. Dans Eclipse, sélectionnez le projet et choisissez **Exécuter en tant que**. Choisissez ensuite l'**installation de Maven**. Une fois l'installation de Maven réussie, le `war` fichier est créé sous. `PlanetsDemoPom/PlanetsDemo-web/target/PlanetsDemo-web-1.0.0.war`
## Étape 6 : Configuration d'un serveur Tomcat
Au cours de cette étape, vous configurez un serveur Tomcat sur lequel vous déployez et démarrez votre application compilée.
1. Dans Eclipse, choisissez **Fenêtre > Afficher la vue > Serveurs** pour afficher la vue **Serveurs** :
![\[AWS Transformez pour le mainframe Eclipse avec la vue Serveurs sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-servers.png)
1. Choisissez **Aucun serveur n'est disponible. Cliquez sur ce lien pour créer un nouveau serveur...** . L'assistant **Nouveau serveur** apparaît. Dans le champ **Sélectionnez le type de serveur** de l'assistant, entrez **tomcat v9**, puis choisissez **Tomcat** v9.0 Server. Ensuite, sélectionnez **Suivant**.
![\[La boîte de dialogue Nouveau serveur. Le serveur Tomcat v9.0 est sélectionné.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-new-server.png)
1. Choisissez **Browse**, puis choisissez le dossier **Tomcat** à la racine du dossier Home. Laissez le JRE à sa valeur par défaut et choisissez **Terminer.**
Un projet **Servers** est créé dans l'espace de travail, et un serveur Tomcat v9.0 est désormais disponible dans la vue **Serveurs**. C'est ici que l'application compilée sera déployée et démarrée :
![\[AWS Transformation pour l'onglet Mainframe Eclipse Servers avec le nouveau serveur Tomcat répertorié.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-server-added.png)
## Étape 7 : Déployer sur Tomcat
Au cours de cette étape, vous déployez l'application de démonstration Planets sur le serveur Tomcat afin de pouvoir exécuter l'application.
1. Sélectionnez le `PlanetsDemo-web` fichier et choisissez **Exécuter sous > Installation de Maven**. Sélectionnez `PlanetsDemo-web` à nouveau et choisissez **Refresh** pour vous assurer que le frontend compilé par npm est correctement compilé dans un fichier .war et remarqué par Eclipse.
1. Téléchargez le [PlanetsDemofichier -runtime.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-runtime.zip) sur l'instance, puis décompressez le fichier à un emplacement accessible. Cela garantit que l'application de démonstration peut accéder aux dossiers et fichiers de configuration dont elle a besoin.
1. Copiez le contenu de `PlanetsDemo-runtime/tomcat-config` dans le `Servers/Tomcat v9.0...` sous-dossier que vous avez créé pour votre serveur Tomcat :
![\[AWS Transformez le sous-dossier Eclipse Tomcat v9.0 du mainframe et les fichiers qu'il contient.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-tomcat-subfolder.png)
1. Ouvrez l'entrée `tomcat v9.0` du serveur dans la vue Serveurs. L'éditeur de propriétés du serveur apparaît :
![\[L'éditeur de propriétés du serveur. L'onglet Vue d'ensemble est sélectionné.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-server-properties-editor.png)
1. Dans l'onglet **Aperçu**, augmentez les valeurs **des délais** d'attente à 450 secondes pour le démarrage et à 150 secondes pour l'arrêt, comme indiqué ici :
![\[La valeur du délai de début est fixée à 450 secondes. La valeur du délai d'arrêt est définie sur 150 secondes.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-timeout-values.png)
1. Choisissez **Ouvrir la configuration de lancement**. Un magicien apparaît. Dans l'assistant, accédez au dossier **Arguments** et, dans le **répertoire de travail**, sélectionnez **Autre**. Choisissez **Système de fichiers**, puis accédez au `PlanetsDemo-runtime` dossier décompressé précédemment. Ce dossier doit contenir un sous-dossier direct appelé **config**.
![\[La boîte de dialogue Modifier les configurations avec le répertoire de travail spécifié dans le champ Autre.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-edit-configuration.png)
1. Choisissez l'onglet **Modules** de l'éditeur de propriétés du serveur et apportez les modifications suivantes :
+ Choisissez **Ajouter un module Web**, puis ajoutez`PlanetsDemo-service`.
+ Choisissez **Ajouter un module Web externe**. La fenêtre de dialogue **Ajouter un module Web** apparaît. Effectuez les modifications suivantes :
+ Dans la **base de documents**, choisissez **Parcourir** et naviguez vers `~/webapps/gapwalk-application...war`
+ Dans **Path**, entrez`/gapwalk-application`.
+ Choisissez OK.
+ Choisissez à nouveau **Ajouter un module Web externe** et apportez les modifications suivantes :
+ Pour **Document base**, entrez le chemin d'accès au frontend .war (in) `PlanetsDemo-web/target`
+ Pour **Path**, entrez `/demo`
+ Sélectionnez OK
+ Enregistrez les modifications de l'éditeur (Ctrl \$1 S).
Le contenu de l'éditeur doit maintenant être similaire à ce qui suit.
![\[L'onglet Modules Web pour les propriétés du serveur Tomcat avec les modules répertoriés.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-web-modules.png)
## Étape 8 : Création de la base de données JICS
Au cours de cette étape, vous vous connectez à la base de données que vous avez créée dans[Étape 1 : Créer une base de données](#tutorial-ba-developer-create-db).
1. À partir de l'instance WorkSpaces Applications, exécutez la commande suivante dans un terminal pour le lancer `pgAdmin` :
```
./pgadmin-start.sh
```
1. Choisissez une adresse e-mail et un mot de passe comme identifiants de connexion. Prenez note de l'URL fournie (généralement http://127.0.0.1:5050). Lancez Google Chrome dans l'instance, copiez-collez l'URL dans le navigateur et connectez-vous avec vos identifiants.
![\[La boîte de dialogue de connexion à PGadmin.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-pgadmin-login.png)
1. Une fois connecté, choisissez **Ajouter un nouveau serveur** et entrez les informations de connexion à la base de données créée précédemment comme suit.
![\[La boîte de dialogue du serveur de registre pgAdmin. L'onglet Connexion est sélectionné.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-pgadmin-register-server.png)
1. Lorsque vous vous connectez au serveur de base de données, utilisez **Objet > Créer > Base de données** et créez une nouvelle base de données nommée **jics.**
1. Modifiez les informations de connexion à la base de données utilisées par l'application de démonstration. Ces informations sont définies dans`PlanetsDemo-runtime/config/application-main.yml`. Recherchez l'`jicsDs`entrée. Pour récupérer les valeurs pour `username` et`password`, dans la console Amazon RDS, accédez à la base de données. Dans l'onglet **Configuration**, sous **Master Credentials ARN**, choisissez **Gérer dans Secrets Manager**. Ensuite, dans la console Secrets Manager, dans le secret, choisissez **Retrieve secret value**.
## Étape 9 : démarrer et tester l'application
Au cours de cette étape, vous lancez le serveur Tomcat et l'application de démonstration afin de pouvoir le tester.
1. Pour démarrer le serveur Tomcat et les applications précédemment déployées, sélectionnez l'entrée du serveur dans la vue Serveurs et choisissez **Démarrer**. Une console affiche les journaux de démarrage.
1. Vérifiez l'état du serveur dans la vue **Serveurs** ou attendez le message de **démarrage du serveur en [xxx] millisecondes** dans la console. Après le démarrage du serveur, vérifiez que l'application gapwalk est correctement déployée. Pour ce faire, accédez à l'URL **http://localhost:8080/gapwalk-application** dans un navigateur Google Chrome. Vous devriez voir ce qui suit.
![\[Message de confirmation indiquant que l'application jics est en cours d'exécution.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-jics-run-confirm.png)
1. Accédez à l'interface de l'application déployée depuis Google Chrome à l'adresse http://localhost:8080/demo. La page **Transaction Launcher** suivante devrait apparaître.
![\[La page du lanceur de transactions JICS.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-jics-launcher.png)
1. Pour démarrer la transaction de l'application, entrez `PINQ` dans le champ de saisie et choisissez **Exécuter** (ou appuyez sur Entrée).
L'écran de l'application de démonstration devrait apparaître.
![\[L'écran de l' PlanetsDemo application en mode insertion.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-demo-app-screen.png)
1. Tapez le nom d'une planète dans le champ correspondant et appuyez sur Entrée.
![\[L'écran de l' PlanetsDemo application avec la Terre saisie dans le champ Nom de la planète.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-demo-with-data.png)
## Étape 10 : Déboguer l'application
Au cours de cette étape, vous testez à l'aide des fonctionnalités de débogage standard d'Eclipse. Ces fonctionnalités sont disponibles lorsque vous travaillez sur une application modernisée.
1. Pour ouvrir la classe de service principale, appuyez sur Ctrl \$1 Shift \$1 T. Puis entrez. `PlanetsinqProcessImpl`
![\[La fenêtre de dialogue Eclipse Open Type PlanetsinqProcessImpl est entrée.\]](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ba-eclipse-open-type.png)
1. Accédez à la `searchPlanet` méthode et placez-y un point d'arrêt.
1. Sélectionnez le nom du serveur, puis sélectionnez **Redémarrer dans le débogage**.
1. Répétez les étapes précédentes. C'est-à-dire, accédez à l'application, entrez le nom d'une planète et appuyez sur Entrée.
Eclipse arrêtera l'application dans la `searchPlanet` méthode. Vous pouvez maintenant l'examiner.
## nettoyer des ressources ;
Si vous n'avez plus besoin des ressources que vous avez créées pour ce didacticiel, supprimez-les afin de ne pas avoir à payer de frais supplémentaires. Procédez comme suit :
+ Si l'application Planets est toujours en cours d'exécution, arrêtez-la.
+ Supprimez la base de données que vous avez créée dans[Étape 1 : Créer une base de données](#tutorial-ba-developer-create-db). Pour plus d'informations, consultez [Suppression d'une instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html).