

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.

# Se connecter à un AWS CodeCommit référentiel
<a name="how-to-connect"></a>

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](how-to-create-file.md#how-to-create-file-console) et [modifier des fichiers](how-to-edit-file.md#how-to-edit-file-console) dans un référentiel directement depuis la CodeCommit console. Sinon, si vous disposez déjà d'un référentiel local, vous pouvez ajouter un référentiel CodeCommit en tant que référentiel 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, consultez[Migrer vers CodeCommit](how-to-migrate-repository.md).

**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](https://aws.amazon.com/codecommit/pricing) sur la page d'informations CodeCommit du produit.

**Topics**
+ [Conditions préalables à la connexion à un référentiel CodeCommit](#how-to-connect-prerequisites)
+ [Connectez-vous au CodeCommit référentiel en clonant le référentiel](#how-to-connect-http)
+ [Connect un dépôt local au CodeCommit référentiel](#how-to-connect-local)

## Conditions préalables à la connexion à un référentiel CodeCommit
<a name="how-to-connect-prerequisites"></a>

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 les logiciels et les paramètres nécessaires pour la connexion à CodeCommit. Cela inclut l'installation et la configuration de Git. Pour plus d’informations, consultez [Configuration ](setting-up.md) et [Commencer à utiliser Git et AWS CodeCommit](getting-started.md).
+ Vous devez disposer de l'URL du clone du CodeCommit référentiel auquel vous souhaitez vous connecter. Pour de plus amples informations, veuillez consulter [Afficher les détails du référentiel](how-to-view-repository-details.md).

  Si vous n'avez pas encore créé de CodeCommit référentiel, suivez les instructions indiquées dans[Création d'un référentiel ](how-to-create-repository.md), copiez l'URL du clone du CodeCommit référentiel 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 dans[Afficher les détails du référentiel](how-to-view-repository-details.md).
+ 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
<a name="how-to-connect-http"></a>

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 ](setting-up.md).
**Important**  
Si vous n'avez pas terminé la configuration, vous ne pouvez pas vous connecter au référentiel ou le cloner.

1. Dans le répertoire `/tmp` ou `c:\temp`, utilisez Git pour exécuter la commande **clone**. Les exemples suivants montrent comment cloner un référentiel nommé {{MyDemoRepo}} dans la région USA Est (Ohio).

   Pour HTTPS à l'aide des [informations d'identification Git](setting-up-gc.md) ou de l'assistant d'informations d'identification inclus avec l' AWS CLI :

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

   Pour l'utilisation du protocole HTTPS**[git-remote-codecommit](setting-up-git-remote-codecommit.md)**, en supposant le profil par défaut et en le Région AWS configurant dans 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, consultez[Régions et points de terminaison de connexion Git](regions.md).
**Note**  
Lorsque vous utilisez SSH sur des systèmes d'exploitation Windows pour cloner un référentiel, vous devrez parfois ajouter l'ID de clé SSH à la chaîne de connexion comme suit :  

   ```
   git clone ssh://{{Your-SSH-Key-ID}}@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
   ```
Pour plus d’informations, consultez [Pour les connexions SSH sous Windows](setting-up-ssh-windows.md) et [Résolution des problèmes](troubleshooting.md).

   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 référentiel ou que vous n'êtes pas autorisé à vous y connecter, assurez-vous d'avoir rempli les [conditions requises](setting-up.md), notamment d'attribuer des autorisations à l'utilisateur IAM et de configurer vos informations d'identification d'utilisateur IAM 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 depuis le dépôt local pour créer des commits, des branches et des tags, puis à envoyer et extraire du CodeCommit dépôt.

## Connect un dépôt local au CodeCommit référentiel
<a name="how-to-connect-local"></a>

Complétez les étapes suivantes si vous disposez déjà d'un référentiel local et que vous souhaitez ajouter un référentiel CodeCommit comme 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 dans[Envoyer les validations vers deux référentiels](how-to-mirror-repo-pushes.md).

1. Complétez les [prérequis](#how-to-connect-prerequisites).

1. À 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 à la télécommande le surnom **origin** https://git-codecom mit.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.

1. 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.