AWS CodeCommit n'est plus disponible pour les nouveaux clients. Les clients existants de AWS CodeCommit peuvent continuer à utiliser le service normalement. En savoir plus »
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
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
Rubriques
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) ouc:\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
ouc:\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.
-
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.
-
Dans le répertoire
/tmp
ouc:\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 etmy-demo-repo
représente le nom du répertoire que Git crée dans le/tmp
répertoire ou lec:\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://
Your-SSH-Key-ID
@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repoPour 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.
-
Complétez les prérequis.
-
À 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.
-
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.