View a markdown version of this page

Connect au code source - AWS Transformation
Connectez-vous à un référentiel avec AWS CodeConnectionsConnectez-vous à un référentiel à l'aide d'un jeton d'accès personnelConnectez-vous au code source dans Amazon S3

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.

Connect au code source

EnsuiteCréation d'une tâche de modernisation .NET, dans l'onglet Job Plan, le volet gauche de la fenêtre AWS Transform répertorie les phases du travail de transformation. La première phase est le code source Connect. Au cours de cette phase, vous vous connectez à votre code source.

Avant de commencer, assurez-vous que vous disposez d'un AWS compte autorisé à créer la connexion au code source. Selon la méthode de connexion que vous choisissez, vous devez également accéder à AWS CodeConnections un jeton d'accès personnel (PAT) stocké dans AWS Secrets Manager ou à un compartiment Amazon S3 dans la même AWS région que votre tâche de transformation. La création d'un connecteur nécessite l'approbation d'un AWS administrateur.

Vous pouvez vous connecter à un référentiel de code source ou fournir du code dans un fichier zip. Quatre options s'offrent à vous pour vous connecter au code source :

  • Connexion au code : connectez-vous au référentiel de code source à l'aide de AWS CodeConnections (GitHub GitLab,, Bitbucket, Azure DevOps).

  • PAT : Connectez-vous au référentiel de code source à l'aide d'un jeton d'accès personnel stocké dans AWS Secrets Manager.

  • S3 : Fournissez un URI Amazon S3 à un fichier zip d'archive de code (par exemple,s3://my-bucket/repos.zip).

  • Téléchargement direct : glissez et déposez un fichier zip d'archive de code dans le volet de discussion.

Sélectionnez une méthode de connexion par code et l'agent vous guidera tout au long de la configuration.

Connectez-vous à un référentiel avec AWS CodeConnections

Si vous choisissez l'option Code Connection, l'agent AWS Transform l'utilise AWS CodeConnectionspour télécharger votre base de code .NET depuis Azure Repos, Bitbucket ou GitHub. GitLab Le code transformé est écrit dans une nouvelle branche inscriptible. Vous devez effectuer l'installation AWS CodeConnections dans la même région que votre tâche de AWS transformation.

Note

Si vous disposez d'un connecteur de référentiel de code source existant, AWS Transform vous en informera. Sélectionnez Utiliser un connecteur existant pour utiliser ce connecteur. Si vous ne souhaitez pas utiliser le connecteur existant, voir Supprimer un connecteur existant ci-dessusAjouter un nouveau connecteur. Vous ne pouvez avoir qu'un seul connecteur de référentiel source par tâche.

Ajouter un nouveau connecteur

Pour créer un nouveau connecteur de référentiel de code source :

  1. Entrez le numéro de AWS compte que vous souhaitez utiliser pour le AWS CodeConnections connecteur.

  2. Si vous ne l'avez pas configuré AWS CodeConnections pour le même AWS compte, cliquez sur Configurer AWS CodeConnections.

  3. Utilisez la console AWS Developer Tools pour créer une connexion à votre Bitbucket GitHub, GitHub Enterprise Server ou à votre AzureDevOpsréférentiel. GitLab

  4. Copiez le nom de ressource Amazon (ARN) de la connexion que vous avez créée.

  5. Retournez dans AWS Transform et collez l'ARN de la connexion que vous avez créée.

  6. Entrez un nom pour le connecteur.

    Note

    Ne saisissez pas d'informations personnelles dans le nom du connecteur.

  7. Sélectionnez Lancer la création du connecteur.

  8. AWS Transform demande la création d'un connecteur pour le AWS compte que vous avez saisi, dans la même région que le travail de transformation en cours, et vous informe qu'une demande d'approbation est prête à être approuvée par votre AWS administrateur dans la console de AWS gestion. Sélectionnez Copier le lien de vérification.

  9. Si vous êtes l' AWS administrateur, connectez-vous au AWS compte et cliquez sur le lien de vérification pour approuver la demande de connexion. Si vous n'êtes pas l' AWS administrateur, fournissez le lien de vérification à votre AWS administrateur.

  10. Une fois que l' AWS administrateur a approuvé la demande de connecteur, sélectionnez Finaliser le connecteur pour terminer le processus de création du connecteur. Si vous souhaitez utiliser un autre connecteur, sélectionnez Redémarrer pour relancer le processus de création du connecteur.

L'onglet Collaboration inclut également des informations sur votre connecteur, notamment :

  • État : Approuvé ou en attente d'approbation

  • AWS ID de compte

  • AWS Région

  • ARN de connexion

Supprimer un connecteur existant

Note

Si vous disposez d'un connecteur de référentiel de code source existant, AWS Transform vous en informera. Sélectionnez Utiliser le connecteur existant ou Supprimer et créer un nouveau connecteur.

Si vous choisissez de supprimer une connexion au référentiel de code source existante, AWS Transform vous avertira avant de supprimer réellement le connecteur.

  1. Vous pouvez supprimer un connecteur existant de plusieurs manières :

    1. Si AWS Transform vous y invite, vous pouvez sélectionner Supprimer et créer un nouveau connecteur.

    2. Vous pouvez également sélectionner redémarrer dans l'invite. Pour modifier ce connecteur, vous devez le redémarrer.

  2. AWS Transform vous avertit que le redémarrage supprimera le connecteur. Pour supprimer le connecteur, sélectionnez Redémarrer à nouveau.

  3. AWS Transform vous avertit à nouveau que la suppression du connecteur supprimera la connexion à votre référentiel tiers, tel que Bitbucket GitHub, et GitLab. De plus, toutes les tâches de AWS transformation utilisant ce connecteur échoueront si le connecteur est supprimé. Pour confirmer la suppression, tapez Supprimer, puis sélectionnez Supprimer.

  4. Pour ajouter un nouveau connecteur de référentiel de code source, consultezAjouter un nouveau connecteur.

Connectez-vous à un référentiel à l'aide d'un jeton d'accès personnel

Vous pouvez vous connecter à un dépôt à l'aide d'un jeton d'accès personnel (PAT). Procédez comme suit :

  1. Lorsque l'agent vous invite à établir une connexion au code source, choisissez PAT dans le volet de discussion.

  2. Lisez les instructions affichées concernant la génération d'un PAT et son stockage dans AWS Secrets Manager.

  3. Générez un PAT à partir de votre contrôle de source.

  4. Enregistrez votre PAT dans AWS Secrets Manager et enregistrez le nom de ressource Amazon (ARN). Par exemple, un GitHub jeton est formaté comme suit :

    github_pat_XXXXXXXXXXXXXXX

  5. Dans le chat, cliquez sur le lien Configurer le connecteur pour ouvrir un formulaire de connecteur.

  6. Dans le formulaire du connecteur, entrez un nom de connecteur, votre identifiant de AWS compte, l'ARN secret et éventuellement un ARN de clé KMS. Soumettez ensuite le formulaire.

  7. L'agent fournit un lien d'approbation. Copiez le lien et envoyez-le à un administrateur pour qu'il approuve la connexion. Après approbation, continuez avec l'agent.

Connectez-vous au code source dans Amazon S3

Vous pouvez connecter AWS Transform au code source dans Amazon S3 au lieu de connecter un référentiel de code source.

Organisation du compartiment S3

Le code source original et le code transformé sont stockés dans un compartiment S3 commun, organisé comme indiqué ci-dessous. Vous devez configurer votre compartiment S3 dans la même région que votre tâche de AWS transformation. Téléchargez votre code source dans le bucket sous forme de fichier zip au niveau de la racine. Le fichier zip doit contenir un dossier de premier niveau pour chaque dépôt.

Au cours de la AWS transformation, Transform crée un dossier de sortie de transformation et stocke les résultats de transformation dans ce dossier. La transformation crée un fichier zip nommé transformed-code.zip contenant le code transformé. Cela inclut un rapport sur les différences de code nommé diff.txt qui met en évidence les modifications apportées au fichier au niveau du projet.


<customer-bucket>/
├── source-code.zip
         ├── repo 1
         ├── repo 2
         ├── ......
         ├── repo n            
└── transform-output/
      ├── transformed-code.zip

Ajouter un nouveau connecteur S3

Pour créer un nouveau connecteur de référentiel de code source S3 :

  1. Dans la AWS console, créez un compartiment S3.

  2. Téléchargez votre code source sous forme de fichier zip dans le compartiment S3.

  3. Dans l'application Web AWS Transform, lancez une tâche de transformation .NET. À l'étape Connecter un référentiel de code source, sélectionnez Connecter votre code source dans le compartiment S3 et choisissez Enregistrer.

  4. Sur la page suivante, entrez les détails de votre compartiment S3 et choisissez Soumettre.

    1. Nom du connecteur

    2. AWS ID de compte

    3. Arne à godets S3

    4. Clé de chiffrement du compartiment S3 (facultatif)

  5. Approuvez le connecteur :

    1. Sur la page suivante, copiez le lien de vérification.

    2. Demandez à un approbateur de parcourir le lien pour accéder à la page de demande de création du connecteur AWS Transform.

    3. Choisissez de créer un nouveau rôle ou d'utiliser un rôle existant.

    4. Après avoir examiné la demande, choisissez Enregistrer et approuver pour l'approuver.

  6. Spécifiez l'emplacement du fichier zip S3 :

    1. Dans l'application Web AWS Transform, attendez que le statut indique Approuvé.

    2. Sur la page Spécifier l'emplacement de la ressource, entrez une URL S3 pour le fichier de code zip au format s3://bucket-name/zip-file-name et choisissez Envoyer pour AWS transformer.

    3. La tâche passe à l'étape Découverte pour poursuivre la transformation.

Supprimer un connecteur S3

Pour supprimer un connecteur S3 existant, procédez comme suit :

  1. Dans l'application Web AWS Transform, sélectionnez Gérer les connecteurs en haut à droite.

  2. Dans la fenêtre Gérer les connecteurs, sélectionnez le connecteur.

  3. Sélectionnez Supprimer.