View a markdown version of this page

Configuration pour AWS CodeCommit - AWS CodeCommit

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.

Configuration pour AWS CodeCommit

Vous pouvez vous connecter à un référentiel Console de gestion AWS et y charger, ajouter ou modifier un fichier directement depuis la AWS CodeCommit console. Il s'agit d'une façon rapide d'apporter une modification. Toutefois, si vous souhaitez utiliser plusieurs fichiers, des fichiers entre différentes branches, etc., envisagez de configurer votre ordinateur local pour utiliser les référentiels. Le moyen le plus simple de configurer CodeCommit est de configurer les informations d'identification HTTPS Git pour AWS CodeCommit. Cette méthode d'authentification HTTPS :

  • Utilise un nom d'utilisateur et un mot de passe statiques.

  • Fonctionne avec tous les systèmes d'exploitation pris en charge par CodeCommit.

  • Est également compatible avec les environnements de développement intégrés (IDE) et autres outils de développement prenant en charge les informations d'identification Git.

Vous pouvez utiliser d'autres méthodes si vous ne souhaitez pas ou ne pouvez pas utiliser des informations d'identification Git pour des raisons opérationnelles. Par exemple, si vous accédez à CodeCommit des référentiels à l'aide d'un accès fédéré, d'informations d'identification temporaires ou d'un fournisseur d'identité Web, vous ne pouvez pas utiliser les informations d'identification Git. Nous vous recommandons de configurer votre ordinateur local à l'aide de la commande git-remote-codecommit. Lisez attentivement la description de ces options afin de déterminer la méthode qui vous convient le mieux.

Pour plus d'informations sur CodeCommit l'utilisation d'Amazon Virtual Private Cloud, consultezUtilisation AWS CodeCommit avec interface VPC endpoints.

Afficher et gérer vos informations d'identification

Vous pouvez consulter et gérer vos CodeCommit informations d'identification depuis la AWS console via Mes informations d'identification de sécurité.

Note

Cette option n'est pas disponible pour les utilisateurs utilisant un accès fédéré, des informations d'identification temporaires ou un fournisseur d'identité Web.

  1. Connectez-vous au Console de gestion AWS et ouvrez la console IAM à https://console.aws.amazon.com/iam/ l'adresse.

  2. Dans la barre de navigation, en haut à droite, choisissez votre nom d'utilisateur, puis Informations d'identification de sécurité.

  3. Cliquez sur l'onglet Informations d'identification AWS CodeCommit .

Configuration à l'aide des informations d'identification Git

Avec les connexions HTTPS et les informations d'identification Git, vous générez un nom d'utilisateur et un mot de passe statiques dans IAM. Ensuite, vous utilisez ces informations d'identification Git et n'importe quel outil tiers prenant en charge l'authentification par nom d'utilisateur et mot de passe Git. Cette méthode est prise en charge par la plupart des environnements IDE et outils de développement. C'est la méthode de connexion la plus simple et la plus facile à utiliser CodeCommit.

Configuration à l'aide d'autres méthodes

Vous pouvez utiliser le protocole SSH au lieu du protocole HTTPS pour vous connecter à votre CodeCommit référentiel. Avec les connexions SSH, vous créez des fichiers de clés publiques et privées sur votre machine locale que Git CodeCommit utilise pour l'authentification SSH. Vous associez la clé publique à votre utilisateur IAM. Vous stockez la clé privée sur votre ordinateur local. Dans la mesure où SSH nécessite que les fichiers de clé publique et privée soient créés et gérés manuellement, la méthode basée sur les informations d'identification Git vous semblera peut-être plus simple à utiliser avec CodeCommit.

Contrairement aux informations d'identification Git, la configuration de la connexion SSH varie en fonction du système d'exploitation installé sur l'ordinateur local.

Si vous vous connectez CodeCommit et AWS utilisez un accès fédéré, un fournisseur d'identité ou des informations d'identification temporaires, ou si vous ne souhaitez pas configurer les utilisateurs IAM ou les informations d'identification Git pour les utilisateurs IAM, vous pouvez configurer des connexions aux CodeCommit référentiels de deux manières :

  • Installez et utilisez git-remote-codecommit (recommandé).

  • Installez et utilisez l'assistant d'informations d'identification inclus dans l' AWS CLI.

Les deux méthodes permettent d'accéder aux CodeCommit référentiels sans avoir besoin d'un utilisateur IAM, ce qui signifie que vous pouvez vous connecter aux référentiels à l'aide d'un accès fédéré et d'informations d'identification temporaires. L'utilitaire git-remote-codecommit est l'approche recommandée. Il étend Git et est compatible avec une variété de versions de Git et d'assistants d'informations d'identification. Cependant, tous les IDE ne prennent pas en charge le format d'URL de clone utilisé par git-remote-codecommit. Vous devrez peut-être cloner manuellement des référentiels sur votre ordinateur local avant de pouvoir les utiliser dans votre IDE.

L'assistant d'identification inclus dans le AWS CLI permet à Git d'utiliser le protocole HTTPS et une version signée cryptographiquement de vos informations d'identification utilisateur IAM ou de votre rôle d'instance Amazon EC2 chaque fois que Git doit s'authentifier pour interagir avec des référentiels. AWS CodeCommit Certains systèmes d'exploitation et certaines versions de Git ont leur propre assistant d'informations d'identification, ce qui entraîne un conflit avec l'assistant inclus dans l' AWS CLI. Ils peuvent entraîner des problèmes de connectivité pour CodeCommit.

Si vous vous connectez à un CodeCommit référentiel hébergé dans un autre compte Amazon Web Services, vous pouvez configurer l'accès et configurer les connexions à l'aide des rôles, des politiques et de l'assistant d'identification inclus dans le. AWS CLI

Compatibilité avec CodeCommit Git et d'autres composants

Lorsque vous travaillez avec CodeCommit, vous utilisez Git. Vous pouvez utiliser également d'autres programmes. Le tableau suivant fournit les dernières recommandations pour la compatibilité de version. En tant que bonne pratique, nous vous recommandons d'utiliser les dernières versions de Git et des autres logiciels.

Informations sur la compatibilité des versions pour AWS CodeCommit
Composant Version
Git CodeCommit prend en charge les versions 1.7.9 et ultérieures de Git. La version 2.28 de Git prend en charge la configuration du nom de la branche pour les validations initiales. Nous vous recommandons d'utiliser une version récente de Git.
Curl CodeCommit nécessite curl 7.33 et versions ultérieures. Cependant, il existe un problème connu avec HTTPS et la mise à jour 7.41.0 de curl. Pour plus d’informations, consultez Résolution des problèmes.
Python (git-remote-codecommit seulement) git-remote-codecommit nécessite la version 3 ou ultérieure.
Pip (git-remote-codecommit seulement) git-remote-codecommit nécessite la version 9.0.3 ou ultérieure.
AWS CLI (git-remote-codecommituniquement) Nous recommandons une version récente de la AWS CLI version 2 à tous les CodeCommit utilisateurs. git-remote-codecommitnécessite AWS CLI la version 2 pour prendre en charge le AWS SSO et les connexions nécessitant des informations d'identification temporaires, telles que les utilisateurs fédérés.