A l'aide deAWS CodeCommitavec Visual Studio Team Explorer

Vous pouvez utiliserAWS Identity and Access Management(IAM) pour créer des informations d'identification Git et les utiliser pour créer et cloner des référentiels dans Team Explorer.

Types d'informations d'identification pour AWS CodeCommit

MostAWS Toolkit for Visual Studioles utilisateurs sont au courant de la configurationAWSprofils d'informations d'identification qui contiennent leurs clés d'accès et leurs clés secrètes. Ces profils d'informations d'identification sont utilisés dans Toolkit for Visual Studio pour activer les appels d'API de service, par exemple, pour répertorier les compartiments Amazon S3 dansAWSExplorer ou pour lancer une instance Amazon EC2. L'intégration d'AWS CodeCommit avec Team Explorer utilise également ces profils d'informations d'identification. Cependant, pour utiliser Git lui-même, vous avez besoin d'autres informations d'identification, plus précisément des informations d'identification Git pour les connexions HTTPS. Pour obtenir des informations sur ces informations d'identification (un nom d'utilisateur et un mot de passe), consultez l'Configuration pour les utilisateurs en HTTPS avec informations d'identification Gitdans leAWS CodeCommitGuide de l'utilisateur.

Vous pouvez créer les informations d'identification Git pourAWS CodeCommituniquement pour les comptes utilisateur IAM. Vous ne pouvez pas les créer pour un compte racine. Vous pouvez créer jusqu'à deux ensembles de ces informations d'identification pour le service et, bien que vous puissiez marquer un ensemble d'informations d'identification comme inactif, ces ensembles inactifs sont comptabilisés dans le nombre limite de deux jeux. Notez que vous pouvez supprimer et recréer ces informations d'identification à tout moment. Lorsque vous utilisezAWS CodeCommitdepuis Visual Studio, votre système traditionnelAWSLes informations d'identification sont utilisées pour travailler avec le service lui-même, par exemple lorsque vous créez et répertoriez des référentiels. Lorsque vous utilisez les référentiels Git réels hébergés dans AWS CodeCommit, vous utilisez les informations d'identification Git.

Dans le cadre de l'appui àAWS CodeCommit, Toolkit for Visual Studio crée et gère automatiquement ces informations d'identification Git pour vous et les associe à votreAWSprofil d'informations d'identification. Vous n'avez pas besoin de vous occuper de savoir si vous avez un ensemble d'informations d'identification approprié à portée de main pour effectuer les opérations Git dans Team Explorer. Une fois que vous vous êtes connecté à Team Explorer avec votreAWS, les informations d'identification Git associées sont utilisées automatiquement chaque fois que vous utilisez une télécommande Git.

Connexion à AWS CodeCommit

Lorsque vous ouvrez la fenêtre Team Explorer dans Visual Studio 2015 ou une version ultérieure, vous voyez une entrée AWS CodeCommit dans la section Hosted Service Providers de Manage Connections.

ChoixS'inscrireouvre la page d'accueil Amazon Web Services dans une fenêtre de navigateur. Ce qui se passe lorsque vous choisissezConnexiondépend si Toolkit for Visual Studio peut trouver un profil d'informations d'identification avecAWSclés d'accès et secrètes pour lui permettre de passer des appels àAWSen votre nom. Vous avez peut-être configuré un profil d'informations d'identification à l'aide de la nouvelle page de mise en route qui s'affiche dans l'IDE lorsque Toolkit for Visual Studio ne trouve pas d'informations d'identification stockées localement. Ou vous avez peut-être utilisé Toolkit for Visual Studio, leAWS Tools for Windows PowerShell, ou leAWS CLIet ont déjàAWSProfils d'informations d'identification disponibles pour Toolkit for Visual Studio à utiliser.

Lorsque vous choisissezConnexion, Toolkit for Visual Studio démarre le processus de recherche d'un profil d'informations d'identification à utiliser dans la connexion. Si Toolkit for Visual Studio ne trouve pas de profil d'informations d'identification, il ouvre une boîte de dialogue qui vous invite à saisir les clés d'accès et secrètes associées à votreCompte AWS. Nous vous recommandons vivement d'utiliser un compte d'utilisateur IAM au lieu de vos informations d'identification racine. En outre, comme indiqué précédemment, les informations d'identification Git dont vous avez inévitablement besoin ne peuvent être créées que pour les utilisateurs IAM. Lorsque les clés d'accès et les clés secrètes ont été fournies et que le profil d'informations d'identification a été créé, la connexion entre Team Explorer et AWS CodeCommit est prête à être utilisée.

Si Toolkit for Visual Studio en trouve plusieursAWSProfil d'informations d'identification, vous êtes invité à sélectionner le compte que vous souhaitez utiliser dans Team Explorer.

Si vous avez un seul profil d'informations d'identification, Toolkit for Visual Studio contourne la boîte de dialogue de sélection de profil et vous êtes connecté immédiatement :

Lorsqu'une connexion est établie entre Team Explorer et AWS CodeCommit via vos profils d'informations d'identification, la boîte de dialogue d'invitation se ferme et le panneau de connexion s'affiche.

Etant donné que vous n'avez pas de référentiels clonés localement, le panneau n'affiche que les opérations que vous pouvez effectuer : Clone,Créer, etDéconnecter. Comme les autres fournisseurs,AWS CodeCommitdans Team Explorer ne peut être lié qu'à un seulAWSprofil d'informations d'identification à un moment donné. Pour passer d'un compte à un autre, vous utilisez Déconnexion pour supprimer la connexion et démarrer une nouvelle connexion avec un autre compte.

Maintenant que vous avez établi une connexion, vous pouvez créer un référentiel en cliquant sur le lien Créer.

Création d'un référentiel

Lorsque vous cliquez sur le boutonCréer, leCréer uneAWS CodeCommitRéférentiel.s'ouvre.

Les référentiels AWS CodeCommit sont organisés par région. Ainsi, dans Région, vous pouvez sélectionner la région dans laquelle héberger le référentiel. La liste contient toutes les régions dans lesquelles AWS CodeCommit est pris en charge. Vous fournissez le nom (obligatoire) et une description (facultative) pour votre nouveau référentiel.

Le comportement par défaut de la boîte de dialogue consiste à ajouter à l'emplacement du dossier du nouveau référentiel le nom du référentiel (lorsque vous indiquez le nom, l'emplacement du dossier se met à jour). Pour utiliser un autre nom de dossier, modifiez le chemin d'accès du dossier Clone into (Cloner en) après avoir indiqué le nom du référentiel.

Vous pouvez également choisir de créer automatiquement un fichier .gitignore initial pour le référentiel. AWS Toolkit for Visual Studio fournit une valeur par défaut intégrée pour les types de fichiers Visual Studio. Vous pouvez également choisir de n'avoir aucun fichier ou d'utiliser un fichier existant personnalisé et de le réutiliser dans tous les référentiels. Il vous suffit de sélectionner Use custom (Utiliser une version personnalisée) dans la liste et d'accéder au fichier personnalisé à utiliser.

Une fois que vous avez un nom de référentiel et un emplacement, vous êtes prêt à cliquer sur OK et à commencer à créer le référentiel. Toolkit for Visual Studio demande que le service crée le référentiel, puis clone le nouveau référentiel localement et ajoute une validation initiale pour le fichier .gitignore si vous en utilisez un. C'est à ce stade que vous commencez à utiliser le git distant.Toolkit for Visual Studio a donc maintenant besoin d'accéder aux informations d'identification Git décrites précédemment.

Configuration des informations d'identification Git

À ce stade, vous avez utiliséAWSclés d'accès et secrètes pour demander que le service crée votre référentiel. Maintenant, vous devez travailler avec Git lui-même pour effectuer l'opération de clonage réelle, et Git ne comprend pas.AWSclés d'accès et secrètes. À la place, vous devez fournir les informations d'identification (nom d'utilisateur et mot de passe) que Git doit utiliser pour établir une connexion HTTPS avec le référentiel distant.

Comme indiqué dans Configuration des informations d'identification Git, les informations d'identification Git que vous allez utiliser doivent être associées à un utilisateur IAM. Vous ne pouvez pas les générer pour des informations d'identification racine. Vous devez toujours configurer votreAWSpour contenir des clés d'informations d'identification pour contenir des clés d'accès et secrètes IAM, et non des clés racine. Toolkit for Visual Studio peut tenter de configurer des informations d'identification Git pourAWS CodeCommitpour vous, et associez-les à laAWSprofil d'informations d'identification que vous avez utilisé pour vous connecter dans Team Explorer plus tôt.

Lorsque vous choisissezOK.dans leCréer uneAWS CodeCommitRéférentiel.et permet de créer le référentiel avec succès, Toolkit for Visual Studio vérifie laAWSprofil d'informations d'identification connecté dans Team Explorer pour déterminer si les informations d'identification Git pourAWS CodeCommitexistent et sont associés localement au profil. Si tel est le cas, Toolkit for Visual Studio indique à Team Explorer de lancer l'opération de clonage sur le nouveau référentiel. Si les informations d'identification Git ne sont pas disponibles localement, Toolkit for Visual Studio vérifie le type d'informations d'identification de compte qui ont été utilisées lors de la connexion dans Team Explorer. Si ces informations d'identification sont associées à un utilisateur IAM, comme nous le recommandons, le message suivant s'affiche.

Si les informations d'identification sont des informations d'identification racine, le message suivant s'affiche à la place.

Dans les deux cas, Toolkit for Visual Studio propose d'essayer d'effectuer le travail pour créer les informations d'identification Git nécessaires pour vous. Dans le premier scénario, il lui suffit de créer un ensemble d'informations d'identification Git pour l'utilisateur IAM. Lorsqu'un compte racine est utilisé, Toolkit for Visual Studio commence par créer un utilisateur IAM, puis se met à créer des informations d'identification Git pour ce nouvel utilisateur. Si Toolkit for Visual Studio doit créer un nouvel utilisateur, il applique l'optionAWS CodeCommitStratégie gérée par Power User sur ce nouveau compte utilisateur. Cette stratégie permet d'accéder uniquement à AWS CodeCommit et autorise l'exécution de toutes les opérations avec AWS CodeCommit, sauf pour la suppression du référentiel.

Lorsque vous créez des informations d'identification, vous ne pouvez les afficher qu'une seule fois. Par conséquent, Toolkit for Visual Studio vous invite à enregistrer les informations d'identification nouvellement créées sous forme d'un.csvavant de continuer.

Nous vous recommandons vivement d'enregistrer les informations d'identification AWS CodeCommit. Veillez à les enregistrer dans un emplacement sûr !

Dans certains cas, Toolkit for Visual Studio ne peut pas créer automatiquement d'informations d'identification. Par exemple, vous avez peut-être déjà créé le nombre maximal d'ensembles d'informations d'identification Git pourAWS CodeCommit(deux), ou vous n'avez peut-être pas de droits de programmation suffisants pour que Toolkit for Visual Studio effectue le travail à votre place (si vous êtes connecté en tant qu'utilisateur IAM). Dans ces cas-là, vous pouvez vous connecter à l'AWS Management Consolepour gérer les informations d'identification ou les obtenir auprès de votre administrateur. Vous pouvez ensuite les entrer dans leInformations d'identification Git pourAWS CodeCommit, que s'affiche dans Toolkit for Visual Studio.

Maintenant que les informations d'identification pour Git sont disponibles, l'opération de clonage du nouveau référentiel continue (voir l'avancement de l'opération dans Team Explorer). Si vous avez choisi d'appliquer un fichier .gitignore par défaut, celui-ci est validé dans le référentiel avec le commentaire « Initial Commit ».

C'est tout ce qu'il faut pour configurer des informations d'identification et créer un référentiel dans Team Explorer. Une fois que les informations d'identification requises sont en place, seule la seule chose que vous voyez lors de la création ultérieure de référentiels, seule laCréer uneAWS CodeCommitRéférentiel.boîte de dialogue elle-même.

Clonage d'un référentiel

Pour cloner un référentiel existant, revenez au panneau de connexion pour AWS CodeCommit dans Team Explorer. Cliquez surClonelien pour ouvrir leCloneAWS CodeCommitRéférentiel., puis sélectionnez le référentiel à cloner et l'emplacement où vous voulez le placer sur le disque.

Une fois que vous avez choisi la région, Toolkit for Visual Studio interroge le service pour connaître les référentiels qui sont disponibles dans cette région et les affiche dans la partie centrale de la boîte de dialogue. Le nom et la description facultative de chaque référentiel sont également affichés. Vous pouvez réorganiser la liste en la triant par nom de référentiel ou selon la date de la dernière modification, et par ordre croissant ou décroissant.

Après avoir sélectionné le référentiel, vous pouvez choisir l'emplacement où le cloner. Par défaut, il s'agit du même emplacement de référentiel utilisé dans d'autres modules d'extension de Team Explorer, mais vous pouvez rechercher ou saisir un autre emplacement. Par défaut, le nom du référentiel est ajouté comme suffixe au chemin sélectionné. Cependant, si vous voulez un chemin spécifique, il vous suffit de modifier la zone de texte après avoir sélectionné le dossier. Quel que soit le texte figurant dans la zone, lorsque vous cliquez sur OK, vous obtenez le dossier dans lequel se trouve le référentiel cloné.

Après avoir sélectionné le référentiel et un emplacement de dossier, vous cliquez ensuite sur OK pour continuer l'opération de clonage. Vous voyez la progression de l'opération de clonage dans Team Explorer, comme lorsque vous créez un référentiel.

Utilisation des référentiels

Lorsque vous clonerez ou créerez des référentiels, vous remarquerez que les référentiels locaux correspondant à la connexion sont répertoriés dans le panneau des connexions de Team Explorer sous les liens d'opération. Ces entrées vous permettent d'accéder commodément au référentiel pour en consulter le contenu. Pour cela, cliquez avec le bouton droit de la souris sur le référentiel et choisissez Browse in Console (Parcourir dans la console).

Vous pouvez également utiliser Update Git Credentials (Mettre à jour les informations d’identification Git) pour mettre à jour les informations d'identification Git associées au profil d'informations d'identification. Cela est très utile si vous avez modifié les informations d'identification. La commande ouvre la commandeInformations d'identification Git pourAWS CodeCommitdans laquelle vous pouvez entrer ou importer les nouvelles informations d'identification.

Les opérations Git sur les référentiels fonctionnent comme prévu. Vous pouvez effectuer des validations locales et, lorsque vous êtes prêt à partager, vous utilisez l'option Sync dans Team Explorer. Parce que les informations d'identification Git sont déjà stockées localement et associées à notre connexionAWS, nous ne serons pas invités à les fournir à nouveau pour les opérations sur le référentielAWS CodeCommitdistante.