Tutoriel : Configuration de Micro Focus Enterprise Developer sur AppStream 2.0

Ce didacticiel explique comment configurer Micro Focus Enterprise Developer pour une ou plusieurs applications mainframe afin de les maintenir, de les compiler et de les tester à l'aide des fonctionnalités d'Enterprise Developer. La configuration est basée sur les images Windows AppStream 2.0 que AWS Mainframe Modernization partage avec le client et sur la création de flottes et de piles AppStream 2.0, comme décrit dans. Tutoriel : Configuration de la AppStream version 2.0 pour une utilisation avec Micro Focus Enterprise Analyzer et Micro Focus Enterprise Developer

Important

Les étapes de ce didacticiel supposent que vous configurez la AppStream version 2.0 à l'aide du AWS CloudFormation modèle téléchargeable cfn-m2- appstream-fleet-ea-ed .yaml. Pour plus d'informations, consultez Tutoriel : Configuration de la AppStream version 2.0 pour une utilisation avec Micro Focus Enterprise Analyzer et Micro Focus Enterprise Developer.

Vous devez effectuer les étapes de cette configuration lorsque le parc et le stack d'Enterprise Developer sont opérationnels.

Pour une description complète des fonctionnalités et des livrables d'Enterprise Developer v7, consultez sa documentation up-to-date en ligne (v7.0) sur le site Micro Focus.

Contenu de l'image

Outre Enterprise Developer lui-même, l'image contient l'image contenant Rumba (un émulateur TN3270). Il contient également les outils et bibliothèques suivants.

Outils tiers

• Python

• Recloner

• pgAdmin

• git-scm

• pilote ODBC pour PostgreSQL

Bibliothèques de C:\Users\Public

• BankDemo code source et définition du projet pour Enterprise Developer :m2-bankdemo-template.zip.

• Package d'installation MFA pour le mainframe :. mfa.zip Pour plus d'informations, consultez la section Présentation de l'accès au mainframe dans la documentation Micro Focus Enterprise Developer.

• Fichiers de commande et de configuration pour Rclone (instructions pour leur utilisation dans les didacticiels) : m2-rclone.cmd etm2-rclone.conf.

Si vous devez accéder à du code source qui n'est pas encore chargé dans CodeCommit les référentiels, mais qui est disponible dans un compartiment Amazon S3, par exemple pour effectuer le chargement initial du code source dans git, suivez la procédure de création d'un disque Windows virtuel comme décrit dansTutoriel : Configuration d'Enterprise Analyzer sur la version 2.0 AppStream .

Prérequis

• Un ou plusieurs CodeCommit référentiels chargés avec le code source de l'application à maintenir. La configuration du référentiel doit correspondre aux exigences du pipeline CI/CD ci-dessus afin de créer des synergies en combinant les deux outils.

• Chaque utilisateur doit disposer d'informations d'identification pour le CodeCommit ou les référentiels définis par l'administrateur du compte conformément aux informations de la section Authentification et contrôle d'accès pour AWS CodeCommit. La structure de ces informations d'identification est examinée dans Authentification et contrôle d'accès pour AWS CodeCommit et la référence complète pour les autorisations IAM CodeCommit se trouve dans la référence des CodeCommit autorisations : l'administrateur peut définir des politiques IAM distinctes pour des rôles distincts en ayant des informations d'identification spécifiques au rôle de chaque référentiel et en limitant les autorisations de l'utilisateur à l'ensemble de tâches spécifiques qu'il doit accomplir sur un référentiel donné. Ainsi, pour chaque responsable du CodeCommit référentiel, l'administrateur du compte créera un utilisateur principal et accordera à cet utilisateur l'autorisation d'accéder au ou aux référentiels requis en sélectionnant la ou les politiques IAM appropriées pour l'accès. CodeCommit

Étape 1 : Configuration par les utilisateurs individuels d'Enterprise Developer

1. Obtenez vos informations d'identification IAM :

   1. Connectez-vous à la AWS console à l'adresse https://console.aws.amazon.com/iam/.

   2. Suivez la procédure décrite à l'étape 3 de Configuration pour les utilisateurs HTTPS à l'aide des informations d'identification Git dans le guide de AWS CodeCommit l'utilisateur.

   3. Copiez les informations de CodeCommit connexion spécifiques qu'IAM a générées pour vous, soit en affichant, copiant puis collant ces informations dans un fichier sécurisé sur votre ordinateur local, soit en choisissant Télécharger les informations d'identification pour télécharger ces informations sous forme de fichier .CSV. Vous avez besoin de ces informations pour vous connecter à CodeCommit.

2. Démarrez une session avec AppStream 2.0 en fonction de l'URL reçue dans l'e-mail de bienvenue. Utilisez votre adresse e-mail comme nom d'utilisateur et créez votre mot de passe.

3. Sélectionnez votre stack de développeurs d'entreprise.

4. Sur la page de menu, choisissez Desktop pour accéder au bureau Windows diffusé par le parc.

Étape 2 : créer le dossier virtuel basé sur Amazon S3 sous Windows (facultatif)

Si Rclone est nécessaire (voir ci-dessus), créez le dossier virtuel basé sur Amazon S3 sous Windows : (facultatif si tous les artefacts de l'application proviennent CodeCommit exclusivement de l'accès).

Note

Si vous avez déjà utilisé Rclone lors de la version préliminaire de AWS Mainframe Modernization, vous devez passer m2-rclone.cmd à la version la plus récente située dans. C:\Users\Public

1. Copiez les m2-rclone.cmd fichiers m2-rclone.conf et fournis dans votre dossier C:\Users\Public de base à C:\Users\PhotonUser\My Files\Home Folder l'aide de l'explorateur de fichiers.

2. Mettez à jour les paramètres de m2-rclone.conf configuration avec votre clé AWS d'accès et le secret correspondant, ainsi que votreRégion AWS.

   [m2-s3]
   type = s3
   provider = AWS
   access_key_id = YOUR-ACCESS-KEY
   secret_access_key = YOUR-SECRET-KEY
   region = YOUR-REGION
   acl = private
   server_side_encryption = AES256

3. Dans m2-rclone.cmd, effectuez les modifications suivantes :

   • your-s3-bucketChangez le nom de votre compartiment Amazon S3. Par exemple, m2-s3-mybucket.

   • Passez your-s3-folder-key à la clé de votre compartiment Amazon S3. Par exemple, myProject.

   • Accédez your-local-folder-path au chemin du répertoire dans lequel vous souhaitez que les fichiers d'application soient synchronisés à partir du compartiment Amazon S3 qui les contient. Par exemple, D:\PhotonUser\My Files\Home Folder\m2-new. Ce répertoire synchronisé doit être un sous-répertoire du dossier d'accueil pour que la AppStream version 2.0 puisse le sauvegarder et le restaurer correctement au début et à la fin de la session.

   :loop
   timeout /T 10
   "C:\Program Files\rclone\rclone.exe" sync m2-s3:your-s3-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
   goto :loop 

4. Ouvrez une invite de commande Windows, envoyez-la C:\Users\PhotonUser\My Files\Home Folder si nécessaire et lancez-lam2-rclone.cmd. Ce script de commande exécute une boucle continue, synchronisant votre compartiment et votre clé Amazon S3 avec le dossier local toutes les 10 secondes. Vous pouvez ajuster le délai d'attente selon vos besoins. Vous devriez voir le code source de l'application situé dans le compartiment Amazon S3 de l'Explorateur de fichiers Windows.

Pour ajouter de nouveaux fichiers à l'ensemble sur lequel vous travaillez ou pour mettre à jour les fichiers existants, téléchargez les fichiers dans le compartiment Amazon S3 et ils seront synchronisés avec votre répertoire lors de la prochaine itération définie dans. m2-rclone.cmd De même, si vous souhaitez supprimer certains fichiers, supprimez-les du compartiment Amazon S3. La prochaine opération de synchronisation les supprimera de votre répertoire local.

Étape 3 : cloner le dépôt

1. Accédez au menu de sélection d'applications dans le coin supérieur gauche de la fenêtre du navigateur et sélectionnez Enterprise Developer.

2. Terminez la création de l'espace de travail requise par Enterprise Developer dans votre dossier principal en choisissant C:\Users\PhotonUser\My Files\Home Folder (aliasD: \PhotonUser\My Files\Home Folder) comme emplacement pour l'espace de travail.

3. Dans Enterprise Developer, clonez votre CodeCommit dépôt en accédant à l'explorateur de projets, en cliquant avec le bouton droit de la souris et en choisissant Importer, Importer..., Git, Projects from Git Clone URI. Entrez ensuite vos informations de CodeCommit connexion spécifiques et complétez la boîte de dialogue Eclipse pour importer le code.

Le dépôt CodeCommit git est désormais cloné dans votre espace de travail local.

Votre espace de travail Enterprise Developer est maintenant prêt à démarrer les travaux de maintenance de votre application. Vous pouvez notamment utiliser l'instance locale de Microfocus Enterprise Server (ES) intégrée à Enterprise Developer pour déboguer et exécuter votre application de manière interactive afin de valider vos modifications localement.

Note

L'environnement de développement d'entreprise local, y compris l'instance locale de serveur d'entreprise, s'exécute sous Windows tandis que AWS Mainframe Modernization s'exécute sous Linux. Nous vous recommandons d'exécuter des tests complémentaires dans l'environnement Linux fourni par AWS Mainframe Modernization après avoir validé CodeCommit et reconstruit la nouvelle application pour cette cible et avant de déployer la nouvelle application en production.

Sessions suivantes

Lorsque vous sélectionnez un dossier géré par la AppStream version 2.0, tel que le dossier de base pour le clonage de votre CodeCommit dépôt, il sera enregistré et restauré de manière transparente d'une session à l'autre. Procédez comme suit la prochaine fois que vous aurez besoin de travailler avec l'application :

1. Démarrez une session avec AppStream 2.0 en fonction de l'URL reçue dans l'e-mail de bienvenue.

2. Connectez-vous avec votre e-mail et votre mot de passe permanent.

3. Sélectionnez la pile Enterprise Developer.

4. Lancez Rclone pour vous connecter (voir ci-dessus) au disque sauvegardé par Amazon S3 lorsque cette option est utilisée pour partager les fichiers de l'espace de travail.

5. Lancez Enterprise Developer pour faire votre travail.

Nettoyage des ressources

Si vous n'avez plus besoin des ressources que vous avez créées pour ce didacticiel, supprimez-les afin qu'elles ne continuent pas à vous être facturées. Procédez comme suit :

• Supprimez le CodeCommit référentiel que vous avez créé pour ce didacticiel. Pour plus d'informations, voir Supprimer un CodeCommit référentiel dans le Guide de AWS CodeCommit l'utilisateur.

• Supprimez la base de données que vous avez créée pour ce didacticiel. Pour plus d'informations, consultez Suppression d'une instance de base de données.