Migrer un dépôt Git vers AWS CodeCommit

Pour créer et configurer un utilisateur IAM pour accéder CodeCommit

1. Créez un compte Amazon Web Services en accédant à http://aws.amazon.com et en choisissant S'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, consultez Cré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 ne refuse expressément les AWS KMS actions requises par CodeCommit. Pour de plus amples informations, veuillez consulter AWS KMS et chiffrement.

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

4. Dans la console IAM, dans le volet de navigation, choisissez Utilisateurs, puis choisissez l'utilisateur IAM que vous souhaitez configurer pour CodeCommit l'accè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 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 Next : Review pour consulter la liste des politiques à associer à l'utilisateur IAM. 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 AWS CLI

1. 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 mettre à niveau une ancienne version du AWS CLI vers la dernière version, voir Installation du AWS Command Line Interface.

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

3. 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'utilisateur IAM à CodeCommit utiliser. Assurez-vous également de spécifier l' Région AWS endroit où se trouve le référentiel, par exempleus-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 de profils à utiliser avec le AWS CLI, consultez les rubriques suivantes :

   • Profils nommés

   • Utilisation d'un rôle IAM dans AWS CLI

   • Définition de la commande

   • Connexion aux AWS CodeCommit référentiels avec des informations d'identification rotatives

   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 l'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 les utilisateurs IAM. Pour plus d'informations sur les profils AWS CLI et, consultez la section Profils nommés.

1. Ouvrez la CodeCommit console sur https://console.aws.amazon.com/codesuite/codecommit/home.

2. Dans le sélecteur de région, choisissez l' Région AWS endroit où vous souhaitez créer le référentiel. Pour de plus amples informations, veuillez consulter Régions et points de terminaison de connexion Git.

3. Dans la page Référentiels, choisissez Créer un référentiel.

4. Sur la page Créer un référentiel, dans Nom de référentiel, saisissez un nom pour le référentiel.

   Note

   Les noms de référentiel sont sensibles à la casse. Le nom doit être unique dans le nom Région AWS de votre compte Amazon Web Services.

5. (Facultatif) Dans la zone Description, saisissez une description pour le référentiel. Cela peut aider d'autres utilisateurs et vous-même à identifier la fonction du référentiel.

   Note

   Le champ de description affiche Markdown dans la console et accepte tous les caractères HTML et les caractères Unicode valides. Si vous êtes un développeur d'applications qui utilise le GetRepository ou BatchGetRepositories APIs et que vous envisagez d'afficher le champ de description du référentiel dans un navigateur Web, consultez la référence des CodeCommit API.

6. (Facultatif) Choisissez Ajouter une balise pour ajouter une ou plusieurs balises de référentiel (étiquette d'attribut personnalisée qui vous aide à organiser et à gérer vos AWS ressources) à votre référentiel. Pour de plus amples informations, veuillez consulter Marquage des référentiels dans AWS CodeCommit.

7. (Facultatif) Développez la configuration supplémentaire pour indiquer si vous souhaitez utiliser la clé par défaut Clé gérée par AWS ou la clé gérée par le client pour chiffrer et déchiffrer les données de ce référentiel. Si vous choisissez d'utiliser votre propre clé gérée par le client, vous devez vous assurer qu'elle est disponible Région AWS là où vous créez le référentiel et que la clé est active. Pour de plus amples informations, veuillez consulter AWS Key Management Service et chiffrement pour les AWS CodeCommit référentiels.

8. (Facultatif) Sélectionnez Activer Amazon CodeGuru Reviewer pour Java et Python si ce référentiel contient du code Java ou Python et que vous souhaitez que CodeGuru Reviewer l'analyse. CodeGuru Reviewer utilise plusieurs modèles d'apprentissage automatique pour détecter les défauts du code et suggérer des améliorations et des corrections dans les pull requests. Pour plus d'informations, consultez le guide de l'utilisateur Amazon CodeGuru Reviewer.

9. Sélectionnez Create (Créer).

1. À partir du terminal ou de l'invite de commande de votre ordinateur local, exécutez la git clone commande avec l'--mirroroption de cloner une copie vierge du référentiel distant dans un nouveau dossier nomméaws-codecommit-demo. Cette copie est uniquement destinée à la migration. Il ne s'agit pas du dépôt local dans lequel interagir avec le référentiel migré. CodeCommit Vous pourrez le créer ultérieurement, une fois la migration CodeCommit terminée.

   L'exemple suivant clone une application de démonstration hébergée sur GitHub (https://github.com/awslabs/aws-demo-php-simple-app.git) vers un dépôt local dans un répertoire nommé. aws-codecommit-demo

   git clone --mirror https://github.com/awslabs/aws-demo-php-simple-app.git aws-codecommit-demo

2. Placez-vous dans le répertoire où vous avez créé le clone.

   cd aws-codecommit-demo

3. Exécutez la git push commande en spécifiant l'URL et le nom du CodeCommit référentiel de destination ainsi que l'--alloption. (Il s'agit de l'URL que vous avez copiée dans Étape 1 : Création d'un CodeCommit référentiel.)

   Par exemple, si vous avez nommé votre dépôt MyClonedRepository et que vous êtes configuré pour utiliser le protocole HTTPS, vous devez exécuter la commande suivante :

   git push https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyClonedRepository --all

   Note

   L'option --all transfère uniquement l'ensemble des branches du référentiel. Elle ne transfère aucune autre référence, comme les balises. Si vous souhaitez transférer les balises, attendez que le transfert initial soit terminé, puis relancez un transfert en utilisant cette fois l'option --tags :

   git push ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyClonedRepository --tags

   Pour plus d'informations, consultez Git push sur le site web de Git. Pour en savoir plus sur le transfert de référentiels volumineux, en particulier si vous transférez toutes les références à la fois (par exemple, avec l'option --mirror), consultez la section Migrer un référentiel par incréments.

1. Ouvrez la CodeCommit console sur https://console.aws.amazon.com/codesuite/codecommit/home.

2. Dans Référentiels, choisissez le nom du référentiel (par exemple,MyClonedRepository).

3. Affichez les fichiers du référentiel pour les branches, le clone URLs, les paramètres, etc.

   

Création d'une stratégie gérée par le client pour votre référentiel

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

2. Dans la zone de navigation de Dashboard, choisissez Stratégies, puis Créer une stratégie.

3. Sur la page Créer une politique, choisissez Importer une stratégie gérée.

4. Sur la page Importer des politiques gérées, dans Politiques de filtrage, entrezAWSCodeCommitPowerUser. Cliquez sur le bouton à côté du nom de la politique, puis choisissez Importer.

5. Sur la page Créer une politique, choisissez JSON. Remplacez la partie « * » de la Resource ligne pour CodeCommit les actions par le Amazon Resource Name (ARN) du CodeCommit référentiel, comme indiqué ici :

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo"
    ]

   Astuce

   Pour trouver l'ARN du CodeCommit référentiel, accédez à la CodeCommit console, choisissez le nom du référentiel dans la liste, puis sélectionnez Paramètres. Pour de plus amples informations, veuillez consulter Afficher les détails du référentiel.

   Si vous souhaitez que cette stratégie s'applique à plusieurs référentiels, ajoutez chaque référentiel en tant que ressource en spécifiant son ARN. Incluez une virgule entre chaque instruction de ressource, comme illustré ici :

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo",
    "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo"
    ]

   Lorsque vous avez terminé de modifier, choisissez la politique de révision.

6. Sur la page Révision de la politique, dans Nom, entrez un nouveau nom pour la politique (par exemple,AWSCodeCommitPowerUser-MyDemoRepo). Fournissez éventuellement une description de cette politique.

7. Choisissez Create Policy (Créer une politique).

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

2. Dans la zone de navigation de Dashboard, sélectionnez Groupes, puis Créer un groupe.

3. Sur la page Définir un nom de groupe, dans la zone Nom du groupe, saisissez un nom pour le groupe (par exemple, MyDemoRepoGroup), puis sélectionnez Étape suivante. Vous pouvez inclure le nom du référentiel comme partie du nom du groupe.

   Note

   Ce nom doit être unique sur un compte Amazon Web Services.

4. Cochez la case à côté de la politique gérée par le client que vous avez créée dans la section précédente (par exemple, AWSCodeCommitPowerUser-MyDemoRepo).

5. Sur la page Vérifier, choisissez Créer un groupe. IAM crée ce groupe avec les politiques spécifiées déjà attachées. Le groupe apparaît dans la liste des groupes associés à votre compte Amazon Web Services.

6. Choisissez votre groupe dans la liste.

7. Sur la page récapitulative du groupe, sélectionnez l'onglet Utilisateurs, puis Ajouter des utilisateurs au groupe. Dans la liste qui répertorie tous les utilisateurs associés à votre compte Amazon Web Services, cochez les cases à côté des utilisateurs auxquels vous souhaitez autoriser l'accès au CodeCommit référentiel, puis choisissez Ajouter des utilisateurs.

   Astuce

   Vous pouvez utiliser la zone de recherche pour trouver rapidement des utilisateurs par leur nom.

8. Lorsque vous avez ajouté vos utilisateurs, fermez la console IAM.

1. Ouvrez la CodeCommit console sur https://console.aws.amazon.com/codesuite/codecommit/home.

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

3. Sur la page Repositories (Référentiels), choisissez le référentiel à partager.

4. Dans Clone URL (URL de clone), choisissez le protocole que vos utilisateurs doivent employer. Cette fonction copie l'URL de clone pour le protocole de connexion.

5. Envoyez à vos utilisateurs l'URL du clone ainsi que toute autre instruction, telle que l'installation AWS CLI, la configuration d'un profil ou l'installation de Git. Assurez-vous d'inclure les informations de configuration pour le protocole de connexion (par exemple, HTTPS).