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.
Connexion au code source
Après Création d'une tâche de modernisation .NET, sur le Plan d'emploi onglet, le volet gauche de AWS La fenêtre de transformation répertorie les phases de la tâche de transformation. La première phase est Connecter le code source. Dans 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 le même AWS La région en tant que métier 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 par code: Connectez-vous au référentiel de code source en utilisant 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 Gestionnaire de secrets.
-
S3: Fournissez un URI Amazon S3 à un fichier zip d'archive de code (par exemple,
s3://my-bucket/repos.zip). -
Téléchargement direct: faites glisser 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 Connexion par code, AWS Transformez les utilisations des agents AWS CodeConnections pour télécharger votre base de code .NET depuis Azure Repos, Bitbucket, GitHub, ou GitLab. Le code transformé est écrit dans une nouvelle branche accessible en écriture. Vous devez configurer AWS CodeConnections dans la même région que votre AWS Transformez le travail.
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 pour utiliser ce connecteur. Si vous ne souhaitez pas utiliser le connecteur existant, consultez Supprimer un connecteur existant avant Ajouter 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 :
-
Entrez le AWS numéro de compte que vous souhaitez utiliser pour AWS CodeConnections connecteur.
-
Si vous n'avez pas configuré AWS CodeConnections pour la même AWS compte, Configurer AWS CodeConnections.
-
Utilisez le AWS Console d'outils pour développeurs
pour créer une connexion avec votre Bit bucket, GitHub, GitHub Serveur d'entreprise, GitLab, ou AzureDevOps référentiel. -
Copiez l'Amazon Resource Name (ARN) de la connexion que vous avez créée.
-
Retourner à AWS Transformez et collez l'ARN de la connexion que vous avez créée.
-
Entrez un nom pour le connecteur.
NoteNe saisissez pas d'informations personnelles dans le nom du connecteur.
-
Sélectionnez Lancez la création du connecteur.
-
AWS Transform demande la création d'un connecteur pour AWS compte que vous avez saisi, dans la même région que la tâche de transformation en cours, et vous informe qu'une demande d'approbation est prête à être approuvée par votre AWS administrateur dans le AWS Console de gestion. Sélectionnez Copiez le lien de vérification.
-
Si vous êtes AWS administrateur, connectez-vous au AWS compte et accédez au lien de vérification pour approuver la demande de connexion. Si vous n'êtes pas AWS administrateur, fournissez le lien de vérification à votre AWS administrateur.
-
Après le AWS l'administrateur approuve 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
Si vous disposez d'un connecteur de référentiel de code source existant, AWS Transform vous en informera. Sélectionnez l'une des options Utiliser le connecteur existant ou Supprimer et créer un nouveau connecteur.
Si vous choisissez de supprimer un référentiel de code source existant, connectez-vous, AWS Transform vous avertira avant de supprimer le connecteur.
-
Vous pouvez supprimer un connecteur existant de plusieurs manières :
-
Si AWS Transform vous y invite, vous pouvez sélectionner Supprimer et créer un nouveau connecteur.
-
Vous pouvez également sélectionner redémarrer dans les plus brefs délais, Pour modifier ce connecteur, vous devez redémarrer.
-
-
AWS Transform vous avertit que le redémarrage supprimera le connecteur. Pour supprimer le connecteur, sélectionnez Redémarrer encore une fois.
-
AWS Transform vous avertit à nouveau que la suppression du connecteur supprimera la connexion à votre référentiel tiers, tel que Bitbucket, GitHub, et GitLab. En outre, tout AWS Les tâches de transformation qui utilisent ce connecteur échoueront si celui-ci est supprimé. Pour confirmer la suppression, tapez supprimer et sélectionnez Supprimer.
-
Pour ajouter un nouveau connecteur de référentiel de code source, voir Ajouter un nouveau connecteur.
Connectez-vous à un référentiel à l'aide d'un jeton d'accès personnel
Vous pouvez vous connecter à un référentiel à l'aide d'un jeton d'accès personnel (PAT). Procédez comme suit :
Lorsque l'agent vous invite à établir une connexion au code source, choisissez PAT dans le volet de discussion.
Lisez les instructions affichées concernant la génération d'un PAT et son stockage dans AWS Gestionnaire de secrets.
Générez un PAT à partir de votre contrôle de source.
Conservez votre PAT dans AWS Secrets Manager et enregistrez le nom de la ressource Amazon (ARN). Par exemple, un GitHub le jeton est formaté comme suit :
github_pat_XXXXXXXXXXXXXXXDans le chat, choisissez Configurer le connecteur lien pour ouvrir un formulaire de connecteur.
Dans le formulaire du connecteur, entrez un nom de connecteur, votre AWS l'ID de compte, l'ARN secret et éventuellement un ARN de clé KMS. Soumettez ensuite le formulaire.
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 vous connecter AWS Passez au code source dans Amazon S3 comme alternative à connexion d'un référentiel de code source.
Organisation des compartiments S3
Le code source d'origine 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 AWS Transformez le travail. 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 référentiel.
Au cours de la transformation, AWS 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 dont le nom de fichier diff.txt met en évidence les modifications apportées aux fichiers 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, procédez comme suit :
-
Dans le AWS console, créez un compartiment S3.
-
Téléchargez votre code source sous forme de fichier zip dans le compartiment S3.
-
Dans le AWS Transformez une application Web, lancez une tâche de transformation .NET. Dans le Connecter un référentiel de code source étape, sélectionnez Connectez votre code source dans un compartiment S3 et choisissez Enregistrer.
-
Sur la page suivante, entrez les détails de votre compartiment S3 et choisissez Soumettre.
-
Nom du connecteur
-
AWS ID de compte
-
Arme à seau S3
-
Clé de chiffrement du compartiment S3 (en option)
-
-
Approuvez le connecteur :
-
Sur la page suivante, copiez le lien de vérification.
-
Demandez à un approbateur de parcourir le lien pour accéder au AWS Transformez la page de demande de création de connecteur.
-
Choisissez de créer un nouveau rôle ou d'utiliser un rôle existant.
-
Après avoir examiné la demande, choisissez Enregistrer et Approuver pour l'approuver.
-
-
Spécifiez l'emplacement du fichier zip S3 :
-
Dans le AWS Transformez l'application Web, attendez que le statut s'affiche Approuvé.
-
Sur le Spécifier l'emplacement des actifs page, entrez une URL S3 pour le fichier zip de code au format
s3://bucket-name/zip-file-nameet choisissez Envoyer à AWS Transformez. -
Le travail passe à Découverte étape pour poursuivre la transformation.
-
Supprimer un connecteur S3
Pour supprimer un connecteur S3 existant :
-
Dans le AWS Transformer l'application Web, sélectionnez Gérer les connecteurs en haut à droite.
-
Dans le Gérer les connecteurs fenêtre, sélectionnez le connecteur.
-
Sélectionnez Supprimer.