Étapes de configuration pour les connexions HTTPS àAWS CodeCommitréférentiels sous Windows avecAWS CLIassistant d'identification - AWS CodeCommit

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 les connexions HTTPS àAWS CodeCommitréférentiels sous Windows avecAWS CLIassistant d'identification

Avant de pouvoir vous connecter à AWS CodeCommit pour la première fois, vous devez suivre les étapes de configuration initiale ci-dessous. Pour la plupart des utilisateurs, le plus simple est de suivre la procédure indiquée à la section Pour les utilisateurs HTTPS utilisant les informations d'identification Git. Toutefois, si vous souhaitez vous connecter à CodeCommit à l'aide d'un compte racine, d'un accès fédéré ou d'informations d'identification temporaires, vous devez faire appel à l'assistant inclus dans l'AWS CLI.

Note

Bien que l'assistant d'informations d'identification soit une méthode prise en charge pour se connecter à CodeCommit à l'aide d'un accès fédéré, d'un fournisseur d'identité ou d'informations d'identification temporaires, la méthode recommandée consiste à installer et à utiliser l'utilitaire git-remote-codecommit. Pour plus d'informations, veuillez consulter Étapes de configuration pour les connexions HTTPS àAWS CodeCommitavecgit-remote-codecommit.

Cette rubrique décrit les étapes d'installation duAWS CLI, configurez votre ordinateur etAWSprofil, connectez-vous à unCodeCommitet clonez ce référentiel sur votre ordinateur, également appelé création d'un dépôt local. Si vous débutez avec Git, vous pouvez également consulter les informations de Où puis-je en savoir plus sur Git ?.

Étape 1 : Configuration initiale pourCodeCommit

Suivez ces étapes pour configurer un compte Amazon Web Services, créer et configurer un utilisateur IAM et installer leAWS CLI. L'AWS CLI inclut un assistant d'informations d'identification que vous configurez pour les connexions HTTPS vers vos référentiels CodeCommit.

Pour créer et configurer un utilisateur IAM pour accéderCodeCommit
  1. Créez un compte Amazon Web Services en accédant àhttp://aws.amazon.comet en choisissantS'inscrire.

  2. Créez un utilisateur IAM ou utilisez-en un existant dans votre compte Amazon Web Services. Assurez-vous que vous disposez d'un identifiant de clé d'accès et d'une clé d'accès secrète associés à cet utilisateur IAM. Pour plus d'informations, voirCréation d'un utilisateur IAM dans votre compte Amazon Web Services.

    Note

    CodeCommit nécessite AWS Key Management Service. Si vous utilisez un utilisateur IAM existant, assurez-vous qu'aucune politique attachée à cet utilisateur n'interdit expressément leAWS KMSactions requises parCodeCommit. Pour plus d'informations, veuillez consulter AWS KMSet chiffrement.

  3. Connectez-vous à l’outil AWS Management Console, puis ouvrez la console IAM à l'adresse https://console.aws.amazon.com/iam/.

  4. Dans la console IAM, dans le volet de navigation, choisissezUtilisateurs, puis choisissez l'utilisateur IAM pour lequel vous souhaitez configurerCodeCommitaccès.

  5. Sous l'onglet Autorisations, choisissez Ajouter des autorisations.

  6. Pour Accorder des autorisations, choisissez Attacher directement les stratégies existantes.

  7. Dans la liste des stratégies, sélectionnez AWSCodeCommitPowerUser ou une autre stratégie gérée pour l'accès à CodeCommit. Pour plus d'informations, veuillez consulter AWS politiques gérées pour CodeCommit.

    Après avoir sélectionné la politique que vous souhaitez joindre, choisissezSuivant : Révisionpour consulter la liste des politiques à associer à l'utilisateur IAM. Si la liste est correcte, choisissez Add permissions.

    Pour plus d'informations sur les stratégies gérées CodeCommit et le partage de l'accès à des référentiels avec d'autres groupes et utilisateurs, consultez Partager un référentiel et Authentification et contrôle d'accès pour AWS CodeCommit.

Pour installer et configurer le AWS CLI
  1. Sur votre ordinateur local, téléchargez et installez l'AWS CLI. Il s'agit d'un prérequis pour l'interaction avec CodeCommit à partir de la ligne de commande. Nous vous recommandons d'installerAWS CLIversion 2. Il s'agit de la version majeure la plus récente duAWS CLIet prend en charge toutes les fonctionnalités les plus récentes. Il s'agit de la seule version duAWS CLIqui 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, consultez Préparation de l'installation de l'interface de ligne de commande AWS.

    Note

    CodeCommitfonctionne uniquement avecAWS CLIversions 1.7.38 et ultérieures. Il est recommandé d'installer ou de mettre à niveau la version de l'AWS CLI la plus récente disponible. Pour déterminer quelle version de l'AWS CLI vous avez installée, exécutez la commande aws --version.

    Pour mettre à niveau une ancienne version de l'AWS CLI vers la version la plus récente, consultez Installation de l'AWS Command Line Interface.

  2. Exécutez cette commande pour vérifier queCodeCommitcommandes pourAWS CLIsont installés.

    aws codecommit help

    Cette commande renvoie une liste deCodeCommitcommandes.

  3. Configurez leAWS CLIavec un profil en utilisant leconfigurecommande, comme suit :.

    aws configure

    Lorsque vous y êtes invité, spécifiezAWSclé d'accès etAWSclé d'accès secrète de l'utilisateur IAM à utiliser avecCodeCommit. Assurez-vous également de spécifier leRégion AWSoù le référentiel existe, tel queus-east-2. Lorsque vous êtes invité à saisir le format de sortie par défaut, entrez json. Par exemple, si vous configurez un profil pour un utilisateur IAM :

    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 json here, and then press Enter

    Pour plus d'informations sur la création et la configuration des profils à utiliser avec l'AWS CLI, consultez les rubriques suivantes :

    Pour vous connecter à un référentiel ou à une ressource d'un autreRégion AWS, vous devez reconfigurer leAWS CLIavec le nom de région par défaut. Les noms de région par défaut pris en charge pour CodeCommit sont notamment les suivants :

    • 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, consultez Régions et points de terminaison de connexion Git. Pour plus d'informations sur l'IAM, les clés d'accès et les clés secrètes, voirComment puis-je obtenir des informations d'identification ?etGestion des clés d'accès pour les utilisateurs IAM. Pour de plus amples informations sur l'AWS CLI et sur les profils, veuillez consulter Profils nommés.

Étape 2 : Installation de Git

Pour travailler avec des fichiers, des validations et d'autres informations dansCodeCommitréférentiels, vous devez installer Git sur votre machine locale. CodeCommit prend en charge les versions Git 1.7.9 et version ultérieure. 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 queGit pour Windows. Si vous utilisez ce lien pour installer Git, vous pouvez accepter tous les paramètres d'installation par défaut, à l'exception des suivants :

Note

Git est une plateforme évolutive et régulièrement mise à jour. Parfois, la modification d'une fonctionnalité peut affecter la façon dont elle fonctionne avec CodeCommit. Si vous rencontrez des problèmes avec une version spécifique de Git et CodeCommit, consultez les informations dans Résolution des problèmes.

Étape 3 : configurer l'assistant d'identification

L'AWS CLI inclut un assistant d'informations d'identification Git que vous pouvez utiliser avec CodeCommit. L'assistant d'identification Git nécessite unAWS profil d'identification, qui stocke une copie duAWSID de clé d'accès etAWSclé d'accès secrète (avec une valeur par défaut)Région AWSnom et format de sortie par défaut). L'assistant d'identification Git utilise ces informations pour s'authentifier automatiquement auprès deCodeCommitvous n'avez donc pas besoin de saisir ces informations à chaque fois que vous utilisez Git pour interagir avecCodeCommit.

  1. Ouvrez une invite de commande et utilisez Git pour exécutergit config, en spécifiant l'utilisation de l'assistant d'identification Git avecAWSprofil d'identification, qui permet à l'assistant d'identification Git d'envoyer le chemin vers les référentiels :

    git config --global credential.helper "!aws codecommit credential-helper $@" git config --global credential.UseHttpPath true

    L'assistant d'informations d'identification Git écrit ce qui suit dans le fichier .gitconfig :

    [credential] helper = !aws codecommit credential-helper $@ UseHttpPath = true
    Important
    • Si vous utilisez un émulateur Bash au lieu de la ligne de commande Windows, vous devez utiliser des apostrophes et non des guillemets.

    • L'assistant d'identification utilise la valeur par défautAWSprofil ou rôle d'instance Amazon EC2. Si vous avez créé un profil d'informations d'identification AWS à utiliser, tel que CodeCommitProfile, vous pouvez modifier la commande comme suit pour l'utiliser à la place du profil par défaut :

      git config --global credential.helper "!aws codecommit credential-helper --profile CodeCommitProfile $@"

      Ceci écrit ce qui suit dans le fichier .gitconfig :

      [credential] helper = !aws codecommit credential-helper --profile=CodeCommitProfile $@ UseHttpPath = true
    • Si votre nom de votre profil contient des espaces, vous devez modifier votre fichier .gitconfig après avoir exécuté cette commande pour le placer entre apostrophes ('). Dans le cas contraire, l'assistant d'informations d'identification ne fonctionne pas.

    • Si votre installation de Git pour Windows inclut l'utilitaire Gestionnaire d'informations d'identification Git, vous verrez des erreurs 403 ou des invites pour fournir des informations d'identification dans cet utilitaire après les premières tentatives de connexion. Le moyen le plus fiable de résoudre ce problème consiste à désinstaller, puis à réinstaller Git pour Windows sans l'option pour l'utilitaire Gestionnaire d'informations d'identification Git, car ce dernier n'est pas compatible avec CodeCommit. Si vous souhaitez conserver l'utilitaire Gestionnaire d'informations d'identification Git, vous devez effectuer des étapes de configuration supplémentaires pour également utiliser CodeCommit, notamment modifier manuellement le fichier .gitconfig afin de spécifier l'utilisation de l'assistant d'informations d'identification pour AWS CodeCommit lors de la connexion à CodeCommit. Supprimez toutes les informations d'identification stockées de l'utilitaire Gestionnaire des informations d'identification (vous pouvez trouver cet utilitaire dans le panneau de configuration). Une fois que vous avez supprimé les informations d'identification stockées, ajoutez les éléments suivants à votre fichier .gitconfig, enregistrez-le, puis réessayez de vous connecter à partir d'une nouvelle fenêtre d'invite de commande :

      [credential "https://git-codecommit.us-east-2.amazonaws.com"] helper = !aws codecommit credential-helper $@ UseHttpPath = true [credential "https://git-codecommit.us-east-1.amazonaws.com"] helper = !aws codecommit credential-helper $@ UseHttpPath = true

      En outre, vous pouvez avoir à reconfigurer vos paramètres git config en spécifiant --system au lieu de --global ou --local pour que toutes les connexions fonctionnent comme prévu.

    • Si vous souhaitez utiliser différents utilisateurs IAM sur le même ordinateur local pourCodeCommit, vous devez spécifier git config --localau lieu degit config --global, et exécutez la configuration pour chaqueAWSprofil d'identification.

  2. Exécutez git config --global --edit pour vérifier que les valeurs précédentes ont été écrites dans le fichier .gitconfig de votre profil utilisateur (par défaut, %HOME%\.gitconfig ou drive:\Users\UserName\.gitconfig). Si la commande aboutit, vous devez voir les valeurs précédentes (en plus des valeurs qui peuvent déjà exister dans le fichier de configuration globale Git). Pour quitter, vous devez généralement saisir :q et appuyer sur Entrée.

Étape 4 : Connectez-vous auCodeCommitconsole et clonage du référentiel

Si un administrateur vous a déjà envoyé le nom et les détails de connexion pour le référentiel CodeCommit, vous pouvez ignorer cette étape et cloner directement le référentiel.

Pour vous connecter à un référentiel CodeCommit
  1. Ouvrez leCodeCommitconsole àhttps://console.aws.amazon.com/codesuite/codecommit/home.

  2. Dans le sélecteur de région, sélectionnezRégion AWSoù le référentiel a été créé. Les référentiels sont spécifiques à unRégion AWS. Pour plus d'informations, veuillez consulter Régions et points de terminaison de connexion Git.

  3. Trouvez le référentiel auquel vous souhaitez vous connecter dans la liste et choisissez-le. Choisissez Clone URL (Cloner URL), puis choisissez le protocole que vous souhaitez utiliser lors du clonage ou de la connexion au référentiel. Cette opération copie l'URL de clonage.

    • Copiez l'URL HTTPS si vous utilisez les informations d'identification Git avec votre utilisateur IAM ou l'assistant d'identification inclus dans leAWS CLI.

    • Copiez l'URL HTTPS (GRC) si vous utilisez la commande git-remote-codecommit sur votre ordinateur local.

    • Copiez l'URL SSH si vous utilisez une paire de clés publique/privée SSH avec votre utilisateur IAM.

    Note

    Si vous voyez unBienvenuepage au lieu d'une liste de référentiels, aucun référentiel n'est associé à votreAWScompte dans leRégion AWSoù 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.

  4. Ouvrez une invite de commande et exécutez legit clonecommande avec l'URL HTTPS que vous avez copiée. 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éMyDemoRepovers un dépôt local nommémy-demo-repodans la région USA Est (Ohio) :

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

    Sur certaines versions de Windows, un message contextuel s'affiche et vous demande vos nom d'utilisateur et mot de passe. Il s'agit du système de gestion des informations d'identification intégré pour Windows, mais il n'est pas compatible avec l'assistant des informations d'identification pour AWS CodeCommit. Choisissez Cancel (Annuler).

Étapes suivantes

Vous réunissez toutes les conditions prérequises. Suivez les étapes décrites dansCommencer avec CodeCommit pour commencer à utiliserCodeCommit.