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.
Étapes de configuration pour HTTPS les connexions AWS CodeCommit à git-remote-codecommit
Si vous souhaitez vous connecter à CodeCommit l'aide d'un compte root, d'un accès fédéré ou d'informations d'identification temporaires, vous devez configurer l'accès à l'aide git-remote-codecommit de. Cet utilitaire fournit une méthode simple pour transférer et extraire du code depuis des CodeCommit référentiels en étendant Git. Il s'agit de la méthode recommandée pour prendre en charge les connexions établies avec un accès fédéré, des fournisseurs d'identité et des informations d'identification temporaires. Pour attribuer des autorisations à une identité fédérée, vous devez créer un rôle et définir des autorisations pour ce rôle. Quand une identité externe s’authentifie, l’identité est associée au rôle et reçoit les autorisations qui sont définies par celui-ci. Pour plus d'informations sur les rôles pour la fédération, voir Créer un rôle pour un fournisseur d'identité tiers (fédération) dans le guide de IAM l'utilisateur. Si vous utilisez IAM Identity Center, vous configurez un ensemble d'autorisations. Pour contrôler les accès auxquels vos identités peuvent accéder après leur authentification, IAM Identity Center met en corrélation l'ensemble d'autorisations avec un rôle dans. IAM Pour plus d’informations sur les jeux d’autorisations, consultez Jeux d’autorisations dans le Guide de l’utilisateur AWS IAM Identity Center .
Vous pouvez également l'utiliser git-remote-codecommit avec un IAM utilisateur. Contrairement aux autres méthodes de HTTPS connexion, git-remote-codecommit il n'est pas nécessaire de configurer les informations d'identification Git pour l'utilisateur.
Note
Certains IDEs ne prennent pas en charge le URL format de clonage utilisé pargit-remote-codecommit
. Il se peut que vous deviez cloner manuellement des référentiels sur votre ordinateur local avant de pouvoir les utiliser comme vous le souhaitez. IDE Pour de plus amples informations, veuillez consulter Résolution des problèmes git-remote-codecommit et AWS CodeCommit.
Ces procédures sont rédigées en partant du principe que vous possédez un compte Amazon Web Services, que vous avez créé au moins un référentiel et que vous utilisez un IAM utilisateur doté d'une politique gérée lors de la connexion aux CodeCommit référentiels. CodeCommit Pour plus d'informations sur la configuration de l'accès pour les utilisateurs fédérés et d'autres types d'informations d'informations d'identification rotatives, consultez Connexion aux AWS CodeCommit référentiels avec des informations d'identification rotatives.
Rubriques
Étape 0 : Installation des prérequis pour git-remote-codecommit
Avant de pouvoir utiliser git-remote-codecommit, vous devez installer certaines conditions préalables sur votre ordinateur local. Il s'agit des licences suivantes :
-
Une version compatible de Python. Pour plus d'informations sur les versions prises en charge de Python, consultez git-remote-codecommit
. Pour plus d'informations sur la configuration et l'utilisation git-remote-codecommit, consultezÉtapes de configuration pour HTTPS les connexions AWS CodeCommit à git-remote-codecommit.
-
Git
Note
Lorsque vous installez Python sur Windows, assurez-vous de choisir l'option permettant d'ajouter Python au chemin d'accès.
git-remote-codecommit nécessite pip version 9.0.3 ou ultérieure. Pour vérifier votre version de pip, ouvrez un terminal ou une ligne de commande et exécutez la commande suivante :
pip --version
Vous pouvez exécuter les deux commandes suivantes pour mettre à jour votre version de pip :
curl -O https://bootstrap.pypa.io/get-pip.py python3 get-pip.py --user
Pour utiliser des fichiers, des validations et d'autres informations dans CodeCommit des référentiels, vous devez installer Git sur votre machine locale. CodeCommit prend en charge les versions 1.7.9 et ultérieures de Git. La version 2.28 de Git permet de configurer le nom de branche pour les validations initiales. Nous vous recommandons d'utiliser une version récente de Git.
Pour installer Git, nous recommandons des sites Web tels que Git Downloads
Note
Git est une plateforme évolutive et régulièrement mise à jour. Parfois, une modification de fonctionnalité peut affecter son fonctionnement CodeCommit. Si vous rencontrez des problèmes avec une version spécifique de Git CodeCommit, consultez les informations contenues dansRésolution des problèmes.
Étape 1 : Configuration initiale pour CodeCommit
Procédez comme suit pour créer un IAM utilisateur, le configurer avec les politiques appropriées, obtenir une clé d'accès et une clé secrète, puis installer et configurer le AWS CLI.
Pour créer et configurer un IAM utilisateur pour accéder CodeCommit
Créez un compte Amazon Web Services en accédant à http://aws.amazon.com
et en choisissant S'inscrire. Créez un IAM utilisateur ou utilisez-en un existant dans votre compte Amazon Web Services. Assurez-vous d'avoir un identifiant de clé d'accès et une clé d'accès secrète associés à cet IAM utilisateur. Pour plus d'informations, consultez Création d'un IAM utilisateur dans votre compte Amazon Web Services.
Note
CodeCommit nécessite AWS Key Management Service. Si vous utilisez un IAM utilisateur existant, assurez-vous qu'aucune politique attachée à cet utilisateur ne refuse expressément les AWS KMS actions requises par CodeCommit. Pour de plus amples informations, veuillez consulter AWS KMSet chiffrement.
Connectez-vous à la IAM console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/iam/
. -
Dans la IAM console, dans le volet de navigation, choisissez Utilisateurs, puis choisissez l'IAMutilisateur que vous souhaitez configurer pour CodeCommit l'accès.
Sous l'onglet Autorisations, choisissez Ajouter des autorisations.
-
Pour Accorder des autorisations, choisissez Attacher directement les stratégies existantes.
Dans la liste des politiques, sélectionnez AWSCodeCommitPowerUserou une autre politique gérée pour CodeCommit l'accès. Pour de plus amples informations, veuillez consulter AWS politiques gérées pour CodeCommit.
Après avoir sélectionné la politique que vous souhaitez joindre, choisissez Suivant : Réviser pour consulter la liste des politiques à associer à l'IAMutilisateur. Si la liste est correcte, choisissez Add permissions.
Pour plus d'informations sur les politiques CodeCommit gérées et le partage de l'accès aux référentiels avec d'autres groupes et utilisateurs, consultez Partage d'un référentiel etAuthentification et contrôle d'accès pour AWS CodeCommit.
Pour installer et configurer le AWS CLI
-
Sur votre ordinateur local, téléchargez et installez le AWS CLI. C'est une condition préalable pour interagir avec CodeCommit depuis la ligne de commande. Nous vous recommandons d'installer AWS CLI la version 2. Il s'agit de la version majeure la plus récente de AWS CLI et prend en charge toutes les dernières fonctionnalités. Il s'agit de la seule version AWS CLI qui prend en charge l'utilisation d'un compte root, d'un accès fédéré ou d'informations d'identification temporaires avecgit-remote-codecommit.
Pour plus d'informations, voir Configuration avec l'interface de ligne de AWS commande.
Note
CodeCommit fonctionne uniquement avec AWS CLI les versions 1.7.38 et ultérieures. Il est recommandé d'installer ou de mettre AWS CLI à niveau la dernière version disponible. Pour déterminer la version AWS CLI que vous avez installée, exécutez la aws --version commande.
Pour effectuer la mise à niveau d'une ancienne version du AWS CLI vers la dernière version, consultez la section Installation du AWS Command Line Interface.
-
Exécutez cette commande pour vérifier que les CodeCommit commandes correspondantes AWS CLI sont installées.
aws codecommit help
Cette commande renvoie une liste de CodeCommit commandes.
-
Configurez le AWS CLI avec un profil en utilisant la configure commande, comme suit :.
aws configure
Lorsque vous y êtes invité, spécifiez la AWS clé d'accès et la clé d'accès AWS secrète de l'IAMutilisateur à utiliser CodeCommit. Assurez-vous également de spécifier l' Région AWS endroit où se trouve le référentiel, par exemple
us-east-2
. Lorsque vous êtes invité à saisir le format de sortie par défaut, entrezjson
. Par exemple, si vous configurez un profil pour un IAM utilisateur :AWS Access Key ID [None]:
Type your IAM user AWS access key ID here, and then press Enter
AWS Secret Access Key [None]:Type your IAM user AWS secret access key here, and then press Enter
Default region name [None]:Type a supported region for CodeCommit here, and then press Enter
Default output format [None]:Type
jsonhere, and then press Enter
Pour plus d'informations sur la création et la configuration de profils à utiliser avec le AWS CLI, consultez les rubriques suivantes :
Pour vous connecter à un référentiel ou à une ressource d'un autre Région AWS, vous devez le reconfigurer AWS CLI avec le nom de région par défaut. Les noms de région par défaut pris en charge CodeCommit incluent :
-
us-east-2
-
us-east-1
-
eu-west-1
-
us-west-2
-
ap-northeast-1
-
ap-southeast-1
-
ap-southeast-2
-
ap-southeast-3
-
me-central-1
-
eu-central-1
-
ap-northeast-2
-
sa-east-1
-
us-west-1
-
eu-west-2
-
ap-south-1
-
ap-south-1
-
ca-central-1
-
us-gov-west-1
-
us-gov-east-1
-
eu-north-1
ap-east-1
me-south-1
cn-north-1
cn-northwest-1
eu-south-1
ap-northeast-3
af-south-1
il-central-1
Pour plus d'informations sur CodeCommit et Région AWS, voirRégions et points de terminaison de connexion Git. Pour plus d'informations sur IAM les clés d'accès et les clés secrètes, voir Comment obtenir des informations d'identification ? et Gestion des clés d'accès pour IAM les utilisateurs. Pour plus d'informations sur les profils AWS CLI et, consultez la section Profils nommés.
-
Étape 2 : Installation git-remote-codecommit
Suivez ces étapes pour installer git-remote-codecommit.
Pour installer git-remote-codecommit
-
Depuis le terminal ou la ligne de commande, exécutez la commande suivante :
pip install git-remote-codecommit
Note
En fonction de votre système d'exploitation et de votre configuration, vous devrez peut-être exécuter cette commande avec des autorisations élevées, telles que sudo, ou utiliser le paramètre --user pour effectuer l'installation dans un répertoire ne nécessitant pas de privilèges spéciaux, tel que votre compte utilisateur actuel. Par exemple, sur un ordinateur exécutant Linux, macOS ou Unix :
sudo pip install git-remote-codecommit
Sur un ordinateur exécutant Windows :
pip install --user git-remote-codecommit
-
Surveillez le processus d'installation jusqu'à ce qu'un message de réussite apparaisse.
Étape 3 : Connexion à la CodeCommit console et clonage du référentiel
Si un administrateur vous a déjà envoyé le clone URL à utiliser git-remote-codecommit pour le CodeCommit référentiel, vous pouvez ignorer la connexion à la console et cloner le référentiel directement.
Pour se connecter à un CodeCommit référentiel
Ouvrez la CodeCommit console sur https://console.aws.amazon.com/codesuite/codecommit/home
. -
Dans le sélecteur de région, choisissez l' Région AWS endroit où le référentiel a été créé. Les référentiels sont spécifiques à un Région AWS. Pour de plus amples informations, veuillez consulter Régions et points de terminaison de connexion Git.
-
Trouvez le référentiel auquel vous souhaitez vous connecter dans la liste et choisissez-le. Choisissez Cloner URL, puis choisissez le protocole que vous souhaitez utiliser lors du clonage ou de la connexion au référentiel. Cela copie le cloneURL.
Copiez le HTTPS URL si vous utilisez les informations d'identification Git avec votre IAM utilisateur ou l'assistant d'identification inclus dans le. AWS CLI
Copiez le HTTPS (GRC) URL si vous utilisez la git-remote-codecommit commande sur votre ordinateur local.
Copiez le SSH URL si vous utilisez une paire de clés SSH publique/privée avec votre IAM utilisateur.
Note
Si vous voyez une page de bienvenue au lieu d'une liste de référentiels, aucun référentiel n'est associé à votre AWS compte dans l' Région AWS endroit où vous êtes connecté. Pour créer un référentiel, consultez Création d'un AWS CodeCommit référentiel ou suivez les étapes du didacticiel Commencer à utiliser Git et CodeCommit.
-
À l'invite du terminal ou de la commande, clonez le référentiel avec la commande git clone. Utilisez le nom HTTPS git-remote-codecommit URL que vous avez copié et le nom du AWS CLI profil, si vous avez créé un profil nommé. Si vous ne spécifiez pas de profil, la commande utilise le profil par défaut. Le référentiel local est créé dans un sous-répertoire du répertoire dans lequel vous exécutez la commande. Par exemple, pour cloner un dépôt nommé
MyDemoRepo
vers un dépôt local nommémy-demo-repo
:git clone codecommit://MyDemoRepo my-demo-repo
Pour cloner le même dépôt à l'aide d'un profil nommé
CodeCommitProfile
:git clone codecommit://
CodeCommitProfile
@MyDemoRepo my-demo-repoPour cloner un dépôt différent Région AWS de celui configuré dans votre profil, incluez le Région AWS nom. Par exemple :
git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo
Étapes suivantes
Vous réunissez toutes les conditions prérequises. Suivez les étapes décrites Commencer avec CodeCommit pour commencer à utiliser CodeCommit.
Pour savoir comment créer et envoyer votre premier commit, consultezCréez un commit dans AWS CodeCommit. Si vous débutez avec Git, vous pouvez également consulter les informations indiquées dans Où puis-je en savoir plus sur Git ? et Commencer à utiliser Git et AWS CodeCommit.