Commencer à utiliser Git et AWS CodeCommit

Pour créer le CodeCommit référentiel

1. Ouvrez la CodeCommit console à l'adresse https://console.aws.amazon.com/codesuite/codecommit/home.

2. Utilisez le sélecteur de région pour choisir l'Région AWSendroit où vous souhaitez créer le référentiel. Pour plus d'informations, consultez 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, pour Nom du référentiel, entrez un nom pour votre référentiel (par exemple, MyDemoRepo).

   Note

   Les noms des référentiels sont sensibles à la casse et ne peuvent pas comporter plus de 100 caractères. Pour de plus amples informations, veuillez consulter Limites.

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

6. (Facultatif) Choisissez Add tag (Ajouter une balise) pour ajouter une ou plusieurs balises de référentiel (une étiquette d'attribut personnalisée qui vous aide à organiser et gérer vos ressources AWS) à votre référentiel. Pour plus d'informations, consultez 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 plus d'informations, consultez AWS Key Management Serviceet 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 doit contenir du code Java ou Python et que vous souhaitez que CodeGuru Reviewer analyse ce code. CodeGuru Reviewer utilise plusieurs modèles d'apprentissage automatique pour détecter les défauts du code et pour suggérer automatiquement des améliorations et des corrections dans les pull requests. Pour plus d'informations, consultez le guide de l'utilisateur Amazon CodeGuru Reviewer.

9. Choisissez Créer.

1. Ouvrez la CodeCommit console à l'adresse https://console.aws.amazon.com/codesuite/codecommit/home.

2. Dans le sélecteur de région, choisissez l'Région AWSendroit où le référentiel a été créé. Les référentiels sont spécifiques à unRégion AWS. Pour plus d'informations, consultez 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 le. AWS 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 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 AWSendroit 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.

4. (Facultatif) Nous vous recommandons de configurer votre client Git local pour l'utiliser main comme nom de la branche par défaut de votre dépôt. Il s'agit du nom utilisé pour la branche par défaut dans tous les exemples de ce guide. Il s'agit également du même nom de branche par défaut que celui CodeCommit utilisé si vous effectuez votre premier commit dans la console. Exécutez la commande suivante pour configurer le nom de branche par défaut de manière globale pour votre système :

   git config --global init.defaultBranch main

   Si vous préférez utiliser un nom de branche par défaut différent pour tous vos référentiels, remplacez-le par le nom main de votre choix. Ce didacticiel part du principe que votre branche par défaut est nommée main.

   Si vous souhaitez utiliser différents noms de branche par défaut pour différents référentiels, vous pouvez définir cet attribut localement (--local) plutôt que globalement (--global).

5. Sur le terminal ou à l'invite de commande, clonez le référentiel à l'aide de la git clone commande et fournissez l'URL de clonage que vous avez copiée à l'étape 3. L'URL de votre clone dépend du protocole et de la configuration que vous utilisez. Par exemple, si vous utilisez le protocole HTTPS avec des informations d'identification Git pour cloner un dépôt nommé MyDemoRepodans la région USA Est (Ohio) :

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

   Si vous utilisez HTTPS avec git-remote-codecommit :

   git clone codecommit://MyDemoRepo my-demo-repo

   Si vous utilisez SSH :

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

   Note

   Si une erreur s'affiche lorsque vous tentez de cloner un référentiel, vous n'avez peut-être pas terminé l'installation nécessaire pour votre ordinateur local. Pour plus d'informations, consultez Configuration pour AWS CodeCommit.

1. Utilisez un éditeur de texte pour créer les deux exemples de fichiers de texte suivants dans votre répertoire. Nommez les fichiers cat.txt et dog.txt :

   cat.txt
   -------
   The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.

   dog.txt
   -------
   The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.

2. Exécutez git config pour ajouter votre nom d'utilisateur et votre adresse e-mail représentés par des espaces réservés your-user-nameet your-email-addressà votre dépôt local. Cela facilite l'identification des validations que vous effectuez :

   git config --local user.name "your-user-name"
   git config --local user.email your-email-address

3. Si vous n'avez pas défini votre nom de branche par défaut globalement lorsque vous avez créé le dépôt local, exécutez la commande suivante pour définir le nom de branche par défaut comme suit : main

   git config --local init.defaultBranch main

4. Exécutez git add pour effectuer une copie intermédiaire de la modification :

   git add cat.txt dog.txt

5. Exécutez git commit pour valider la modification :

   git commit -m "Added cat.txt and dog.txt"

   Astuce

   Pour afficher les détails relatifs à la validation que vous venez d'effectuer, exécutez git log.

1. Passez au répertoire /tmp ou c:\temp.

2. Exécutez git clone pour transmettre une copie du référentiel vers le référentiel partagé :

   Pour HTTPS :

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

   Pour HTTPS avec git-remote-codecommit :

   git clone codecommit://MyDemoRepo shared-demo-repo

   Pour SSH :

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

   Note

   Lorsque vous clonez un référentiel à l'aide de SSH sur des systèmes d'exploitation Windows, vous devez ajouter l'ID de clé SSH à 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-repo

   Pour plus d'informations, consultez Pour des connexions SSH sous Windows.

   Dans cette commande, MyDemoRepo se trouve le nom de votre CodeCommit dépôt. shared-demo-repoest le nom du répertoire que Git crée dans le /tmp répertoire ou le c:\temp répertoire. Une fois que Git a créé le répertoire, il extrait une copie du référentiel dans le répertoire shared-demo-repo.

3. Passez au répertoire shared-demo-repo :

   (For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
   (For Windows) cd c:\temp\shared-demo-repo

4. Exécutez git config pour ajouter un autre nom d'utilisateur et une autre adresse e-mail représentés par des espaces réservés other-user-nameet other-email-address. Cela permet d'identifier plus facilement les validations effectuées par l'autre utilisateur :

   git config --local user.name "other-user-name"
   git config --local user.email other-email-address

5. Utilisez un éditeur de texte pour créer l'exemple de fichier texte suivant dans le répertoire shared-demo-repo. Nommez le fichier horse.txt:

   horse.txt
   -------
   The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.

6. Exécutez git add pour effectuer une copie intermédiaire de la modification dans le référentiel partagé :

   git add horse.txt

7. Exécutez git commit pour valider la modification dans le référentiel partagé :

   git commit -m "Added horse.txt"

8. Exécutez git push pour transférer votre validation initiale via le nom distant par défaut que Git utilise pour votre CodeCommit dépôt (origin), à partir de la branche par défaut de votre dépôt local (main) :

   git push -u origin main

9. Passez à votre dépôt local et exécutez git pull pour extraire dans votre dépôt local le commit que le dépôt partagé a effectué dans le référentiel. CodeCommit Puis exécutez git log pour voir la validation qui a été initiée depuis le référentiel partagé.

1. À partir de votre dépôt localgit checkout, exécutez en spécifiant le nom de la branche (par exemple,MyNewBranch) et l'ID du premier commit que vous avez effectué dans le dépôt local.

   Si vous ne connaissez pas l'ID de validation, exécutez git log pour l'obtenir. Assurez-vous que la validation comporte votre nom d'utilisateur et votre adresse e-mail, et non le nom d'utilisateur et l'adresse e-mail de l'autre utilisateur. Ceci est pour simuler qu'mainil s'agit d'une version stable du CodeCommit référentiel et que la MyNewBranch branche est destinée à une nouvelle fonctionnalité relativement instable :

   git checkout -b MyNewBranch commit-ID

2. Exécutez git push pour envoyer la nouvelle branche du dépôt local vers le CodeCommit référentiel :

   git push origin MyNewBranch

3. A présent, extrayez la branche dans le référentiel partagé et vérifiez vos résultats :

   1. Basculez vers le répertoire du référentiel partagé (shared-demo-repo).

   2. Extrayez la nouvelle branche (git fetch origin).

   3. Vérifiez que la branche a été extraite dans (git branch --all affiche une liste de toutes les branches pour le référentiel).

   4. Switch to the new branch (git checkout MyNewBranch).

   5. Vérifiez que vous avez basculé vers la branche MyNewBranch en exécutant la commande git status ou git branch. La sortie montre dans quelle branche vous vous trouvez. Dans ce cas, il doit s'agir de MyNewBranch.

   6. Affichez la liste des validations dans la branche (git log).

   Voici la liste des commandes Git à appeler :

   git fetch origin
   git branch --all
   git checkout MyNewBranch
   git branch or git status
   git log

4. Revenez dans la branche main et affichez la liste des validations. Les commandes Git devraient ressembler à ceci :

   git checkout main
   git log

5. Passez à la main branche de votre dépôt local. Vous pouvez exécuter git status ou git branch. La sortie montre dans quelle branche vous vous trouvez. Dans ce cas, il doit s'agir de main. Les commandes Git devraient ressembler à ceci :

   git checkout main
   git branch or git status

1. À partir de votre dépôt localgit tag, exécutez en spécifiant le nom de la nouvelle balise (release) et l'ID du premier commit que vous avez effectué dans le dépôt local.

   Si vous ne connaissez pas l'ID de validation, exécutez git log pour l'obtenir. Assurez-vous que la validation comporte votre nom d'utilisateur et votre adresse e-mail, et non le nom d'utilisateur et l'adresse e-mail de l'autre utilisateur. Cela permet de simuler que votre commit est une version stable du CodeCommit dépôt :

   git tag release commit-ID

   Exécutez à nouveau git tag pour baliser la validation effectuée par l'autre utilisateur avec la balise beta. Ceci vise à simuler que la validation est destinée à une nouvelle fonctionnalité relativement instable :

   git tag beta commit-ID

2. Exécutez git push --tags pour envoyer les balises au CodeCommit référentiel.

3. A présent, extrayez les balises dans le référentiel partagé et vérifiez vos résultats :

   1. Basculez vers le répertoire du référentiel partagé (shared-demo-repo).

   2. Extrayez les nouvelles balises (git fetch origin).

   3. Vérifiez que les balises ont été extraite (git tag affiche une liste des balises pour le référentiel).

   4. Consultez les informations sur chaque balise (git log release et git log beta).

   Voici la liste des commandes Git à appeler :

   git fetch origin
   git tag
   git log release
   git log beta

4. Essayez également ceci dans le dépôt local :

   git log release
   git log beta

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

   Veillez à vous connecter avec les mêmes nom d'utilisateur et mot de passe que ceux utilisés dans Configuration .

2. Dans le volet de navigation, choisissez Users, puis Create New Users.

3. Dans la première zone Enter User Names (Saisir les noms d'utilisateur), saisissez un exemple de nom d'utilisateur (par exemple, JaneDoe-CodeCommit). Cochez la case Generate an access key for each user (Générer une clé d'accès pour chaque utilisateur) et choisissez Create (Créer).

4. Sélectionnez Show User Security Credentials. Notez l'ID de clé d'accès et la clé d'accès secrète, ou choisissez Télécharger les informations d'identification.

5. Suivez les instructions Pour les utilisateurs HTTPS utilisant les informations d'identification Git pour générer et fournir les informations d'identification de l'utilisateur IAM.

   Si vous souhaitez utiliser SSH, suivez les instructions de SSH et Linux, macOS ou Unix : configurez les clés publiques et privées pour Git etCodeCommit ou Étape 3 : Configurer les clés publiques et privées pour Git et CodeCommit pour configurer l'utilisateur avec des clés publiques et privées.

6. Exécutez git pull. L'erreur suivante doit apparaître :

   Pour HTTPS :

   fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   Pour SSH :

   fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   L'erreur apparaît parce que le nouvel utilisateur n'est pas autorisé à synchroniser le dépôt partagé avec le CodeCommit référentiel.

7. Retournez à la console IAM. Dans le volet de navigation, choisissez Policies, puis Create Policy. (Si un bouton Mise en route est affiché, choisissez-le, puis choisissez Créer une stratégie.)

8. En regard de Create Your Own Policy (Créez votre politique), choisissez Select (Sélectionner).

9. Dans la zone Nom de la stratégie, saisissez un nom (par exemple, CodeCommitAccess-GettingStarted).

10. Dans le champ Document de stratégie, entrez ce qui suit, qui permet à un utilisateur IAM d'extraire des données de n'importe quel référentiel associé à l'utilisateur IAM :

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull"
          ],
          "Resource": "*"
        }
      ]
    }

    Astuce

    Si vous souhaitez que l'utilisateur IAM puisse envoyer des validations vers n'importe quel référentiel associé à l'utilisateur IAM, entrez plutôt ceci :

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull",
            "codecommit:GitPush"
          ],
          "Resource": "*"
        }
      ]
    }

    Pour plus d'informations sur les autres autorisations d' CodeCommit action et de ressources que vous pouvez accorder aux utilisateurs, consultezAuthentification et contrôle d'accès pour AWS CodeCommit.

11. Dans le panneau de navigation, choisissez utilisateurs.

12. Choisissez l'exemple de nom d'utilisateur (par exemple, JaneDoe-CodeCommit) auquel vous souhaitez attacher la stratégie.

13. Choisissez l'onglet Permissions (Autorisations).

14. Dans Managed Policies, choisissez Attach Policy.

15. Sélectionnez la stratégie CodeCommitAccess-GettingStarted que vous venez de créer, puis choisissez Attach Policy (Attacher la politique).

16. Exécutez git pull. Cette fois-ci, la commande va fonctionner et un message Already up-to-date doit apparaître.

17. Si vous utilisez HTTPS, passez à vos informations d'identification Git d'origine ou, si vous utilisez git-remote-codecommit, à votre profil habituel. Pour plus d'informations, consultez les instructions de Configuration pour les utilisateurs HTTPS à l'aide des informations d'identification Git ou Étapes de configuration pour les connexions HTTPS àAWS CodeCommitavecgit-remote-codecommit.

    Si vous utilisez SSH, basculez vers vos clés d'origine. Pour plus d’informations, consultez SSH et Linux, macOS ou Unix : configurez les clés publiques et privées pour Git etCodeCommit ou Étape 3 : Configurer les clés publiques et privées pour Git et CodeCommit.

1. Ouvrez la CodeCommit console à l'adresse https://console.aws.amazon.com/codesuite/codecommit/home.

2. Sur la page Dashboard (Tableau de bord), dans la liste des référentiels, choisissez MyDemoRepo.

3. Dans le panneau de navigation, sélectionnez Settings (Paramètres).

4. Sur la page Settings, dans Delete repository, choisissez Delete repository.

5. Dans la zone en regard de Tapez le nom du référentiel pour confirmer la suppression, saisissez MyDemoRepo, puis choisissez Supprimer.