Se connecter à un AWS CodeCommit référentiel

Lorsque vous vous connectez à un CodeCommit référentiel pour la première fois, vous clonez généralement son contenu sur votre machine locale. Vous pouvez également ajouter des fichiers et modifier des fichiers dans un référentiel directement depuis la CodeCommit console. Sinon, si vous avez déjà un dépôt local, vous pouvez ajouter un CodeCommit référentiel en tant que dépôt distant. Cette rubrique fournit des instructions pour se connecter à un CodeCommit référentiel. Si vous souhaitez migrer un référentiel existant vers CodeCommit, consultezMigrer vers CodeCommit.

Note

En fonction de votre utilisation, la création ou l'accès à un référentiel peuvent vous être facturés. Pour plus d'informations, consultez la section Tarification sur la page d'informations CodeCommit du produit.

Conditions préalables à la connexion à un référentiel CodeCommit

Avant de cloner un CodeCommit dépôt ou de connecter un dépôt local à un CodeCommit dépôt :

• Vous devez avoir configuré votre ordinateur local avec le logiciel et les paramètres requis pour vous connecter à CodeCommit. Cela inclut l'installation et la configuration de Git. Pour plus d’informations, consultez Configuration et Commencer à utiliser Git et AWS CodeCommit.

• Vous devez disposer du clone URL du CodeCommit dépôt auquel vous souhaitez vous connecter. Pour plus d’informations, consultez Afficher les détails du référentiel.

  Si vous n'avez pas encore créé de CodeCommit dépôt, suivez les instructions Création d'un référentiel indiquées dans, copiez le clone URL du CodeCommit dépôt et revenez à cette page.

  Si vous possédez un CodeCommit dépôt mais que vous ne connaissez pas son nom, suivez les instructions figurant dansAfficher les détails du référentiel.

• Vous devez disposer d'un emplacement sur votre machine locale pour stocker une copie locale du CodeCommit référentiel auquel vous vous connectez. (Cette copie locale du CodeCommit dépôt est connue sous le nom de dépôt local.) Ensuite, vous basculez dans Git et exécutez des commandes Git à partir de cet emplacement. Par exemple, vous pouvez utiliser /tmp (pour Linux, macOS ou Unix) ou c:\temp (pour Windows) si vous créez un clone temporaire à des fins de test. C'est le chemin de répertoire utilisé dans ces exemples.

  Note

  Vous pouvez utiliser n'importe quel répertoire de votre choix. Si vous clonez un référentiel en vue d'une utilisation à long terme, envisagez la création du clone à partir d'un répertoire de travail et pas à partir de celui utilisé pour les fichiers temporaires. Si vous utilisez un autre répertoire que /tmp ou c:\temp, veillez à le substituer au nôtre lorsque vous suivez ces instructions.

Connectez-vous au CodeCommit référentiel en clonant le référentiel

Si vous ne possédez pas encore de dépôt local, suivez les étapes de cette procédure pour cloner le CodeCommit référentiel sur votre machine locale.

1. Remplissez les prérequis, y compris Configuration .

   Important

   Si vous n'avez pas terminé la configuration, vous ne pouvez pas vous connecter au référentiel ou le cloner.

2. Dans le répertoire /tmp ou c:\temp, utilisez Git pour exécuter la commande clone. Les exemples suivants montrent comment cloner un dépôt nommé MyDemoRepo dans la région de l'est des États-Unis (Ohio).

   Pour HTTPS utiliser les informations d'identification Git ou l'assistant d'identification inclus dans : AWS CLI

   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   Pour HTTPS l'utilisationgit-remote-codecommit, en supposant le profil par défaut et Région AWS configuré dans le AWS CLI :

   git clone codecommit://MyDemoRepo my-demo-repo

   Pour SSH :

   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   Dans cet exemple, git-codecommit.us-east-2.amazonaws.com le point de connexion Git pour la région USA Est (Ohio) où le dépôt existe, MyDemoRepo représente le nom de votre CodeCommit dépôt et my-demo-repo représente le nom du répertoire que Git crée dans le /tmp répertoire ou le c:\temp répertoire. Pour plus d'informations sur Régions AWS cette prise en charge CodeCommit et les connexions Git correspondantes Régions AWS, consultezRégions et points de terminaison de connexion Git.

   Note

   Lorsque vous utilisez SSH un système d'exploitation Windows pour cloner un référentiel, il se peut que vous deviez ajouter l'ID de SSH clé à la chaîne de connexion comme suit :

   git clone ssh://[e-mail]/v1/repos/MyDemoRepo my-demo-repo

   Pour plus d’informations, consultez Pour des connexions SSH sous Windows et Résolution des problèmes.

   Une fois que Git a créé le répertoire, il extrait une copie de votre CodeCommit dépôt dans le répertoire nouvellement créé.

   Si le CodeCommit référentiel est nouveau ou vide, un message s'affiche indiquant que vous clonez un référentiel vide. Ceci est normal.

   Note

   Si vous recevez un message d'erreur indiquant que Git ne trouve pas le CodeCommit dépôt ou que vous n'êtes pas autorisé à vous y connecter, assurez-vous d'avoir rempli les conditions requises, notamment en attribuant des autorisations à l'IAMutilisateur et en configurant vos informations IAM d'identification utilisateur pour Git et CodeCommit sur la machine locale. CodeCommit En outre, vérifiez que vous avez spécifié le nom de référentiel correct.

Une fois que vous avez connecté avec succès votre dépôt local à votre CodeCommit dépôt, vous êtes maintenant prêt à exécuter des commandes Git à partir du dépôt local pour créer des commits, des branches et des balises, puis à envoyer et extraire du CodeCommit dépôt.

Connect un dépôt local au CodeCommit référentiel

Procédez comme suit si vous possédez déjà un dépôt local et que vous souhaitez ajouter un CodeCommit référentiel en tant que référentiel distant. Si vous possédez déjà un dépôt distant et que vous souhaitez transférer vos validations vers CodeCommit cet autre référentiel distant, suivez les étapes décrites dansEnvoyer les validations vers deux référentiels.

1. Complétez les prérequis.

2. À partir de l'invite de commande ou du terminal, accédez au répertoire de votre dépôt local et exécutez la git remote add commande pour ajouter le CodeCommit référentiel en tant que référentiel distant pour votre dépôt local.

   Par exemple, la commande suivante ajoute le surnom de la télécommande origin à https://git-codecommit.us-east-2.amazonaws.com/v1/ repos/ MyDemoRepo :

   Pour HTTPS :

   git remote add origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

   Pour SSH :

   git remote add origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

   Cette commande ne donne aucun résultat.

3. Pour vérifier que vous avez ajouté le CodeCommit référentiel en tant que télécommande pour votre dépôt local, exécutez la git remote -v commande, qui devrait créer un résultat similaire à ce qui suit :

   Pour HTTPS :

   origin  https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch)      
   origin  https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)      

   Pour SSH :

   origin  ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch)       
   origin  ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)

Une fois que vous avez connecté avec succès votre dépôt local à votre CodeCommit dépôt, vous êtes prêt à exécuter des commandes Git à partir du dépôt local pour créer des validations, des branches et des balises, et pour envoyer ou extraire du CodeCommit dépôt.