Intégration de AWS Cloud9 avec AWS CodeCommit

Vous pouvez utiliserAWS Cloud9pour apporter des modifications au code dans un CodeCommit repository.AWS Cloud9contient un ensemble d'outils qui servent à coder, générer, exécuter, tester, déboguer et publier des logiciels. Vous pouvez cloner des référentiels existants, créer des référentiels, valider et transférer les modifications de code à un référentiel, et bien plus encore, à partir de votre environnement de développement AWS Cloud9 EC2. LeAWS Cloud9L'environnement de développement EC2 est généralement préconfiguré avec l'AWS CLI, un rôle Amazon EC2 et Git. Ainsi, dans la plupart des cas, vous pouvez exécuter quelques commandes simples et commencer à interagir avec votre référentiel.

Pour utiliserAWS Cloud9Avec CodeCommit, vous avez besoin des éléments suivants :

• Un environnement de développement AWS Cloud9 EC2 s'exécutant sur Amazon Linux.

• L'IDE AWS Cloud9 ouvert dans un navigateur.

• Un utilisateur IAM avec l'un des CodeCommit stratégies gérées et l'une desAWS Cloud9stratégies gérées qui s'y appliquent.

  Pour plus d'informations, consultez AWS politiques gérées pour CodeCommit et Présentation et obtention de vos informations d'identification de sécurité.

  Note

  Cette rubrique décrit la configuration de l'intégration avec CodeCommit etAWS Cloud9avec un accès général à partir d'Internet. Vous pouvez configurer l'accès à CodeCommit etAWS Cloud9dans un environnement isolé, mais cela nécessite des étapes supplémentaires. Pour plus d'informations, consultez :

  • Utilisation AWS CodeCommit avec les points de VPC terminaison de l'interface

  • Accès aux instances Amazon EC2 sans entrée avecAWS Systems Manager

  • Utilisation d'environnements partagés

  • Partager votre VPC avec d'autres comptes

  • Article de blog : Isolation de l'accès réseau à votreAWS Cloud9environnements

Étape 1 : Création d'unAWS Cloud9environnement de développement

AWS Cloud9héberge votre environnement de développement sur une instance Amazon EC2. Il s'agit de la solution la plus simple pour effectuer l'intégration, car vous pouvez utiliser le moduleAWSinformations d'identification temporaires gérées pour que l'instance se connecte à votre CodeCommit repository. Si vous souhaitez utiliser votre propre serveur, consultez leAWS Cloud9Guide de l'utilisateur.

Pour créer un environnement AWS Cloud9.

1. Connectez-vous àAWSen tant qu'utilisateur IAM que vous avez configuré et ouvrez leAWS Cloud9console

2. Dans la console AWS Cloud9, choisissez Créer environnement.

3. DansÉtape 1 : Environnement de noms, entrez un nom et une description facultative pour l'environnement, puis choisissezÉtape suivante.

4. DansÉtape 2 : Configurer les paramètres, configurez votre environnement comme suit :

   • Dans Environment type, choisissez Create a new instance for environment (EC2).

   • Dans Instance type, choisissez le type d'instance approprié pour votre environnement de développement. Par exemple, si vous explorez simplement le service, vous pouvez choisir la valeur par défaut t2.micro. Si vous avez l'intention d'utiliser cet environnement pour un travail de développement, choisissez un type d'instance offrant plus de capacité.

   • Acceptez les autres paramètres par défaut, sauf si vous avez des raisons d'en choisir d'autres (par exemple, votre organisation utilise un VPC spécifique ou votre compte Amazon Web Services ne dispose pas de VPC configuré), puis choisissezÉtape suivante.

5. DansÉtape 3 : Vérification, vérifiez vos paramètres. Choisissez Previous step si vous souhaitez effectuer des modifications. Dans le cas contraire, choisissez Create environment.

   La création d'un environnement et la connexion à ce dernier pour la première fois prend quelques minutes. Si cette opération semble prendre un temps inhabituel, consultez Dépannage dans le Guide de l'utilisateur AWS Cloud9.

6. Une fois que vous êtes connecté à votre environnement, vérifiez si Git est déjà installé et si sa version est prise en charge en exécutant la commande git --version dans la fenêtre de terminal.

   Si Git n'est pas installé ou si sa version n'est pas prise en charge, installez une version prise en charge. CodeCommit prend en charge les versions Git 1.7.9 et version ultérieure. Git version 2.28 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. Pour installer Git, nous vous recommandons des sites web tels queTéléchargements Git.

   Astuce

   Selon le système d'exploitation de votre environnement, vous pouvez utiliser la commande yum avec l'option sudo pour installer les mises à jour, y compris Git. Par exemple, une séquence de commandes d'administration peut ressembler aux trois commandes suivantes :

   sudo yum -y update
   sudo yum -y install git
   git --version

7. Configurez un nom d'utilisateur et une adresse e-mail à associer à vos validations Git en exécutant la commande git config. Par exemple :

       git config --global user.name "Mary Major"
       git config --global user.email [e-mail]

Étape 2 : Configurer l'AWS CLIassistant d'informations d'identification de votreAWS Cloud9Environnement de développement EC2

Une fois que vous avez créé unAWS Cloud9, vous pouvez configurer leAWS CLIassistant d'informations d'identification pour gérer les informations d'identification pour les connexions à votre CodeCommit repository. LeAWS Cloud9environnement de développement est fourni avecAWSinformations d'identification temporaires gérées qui sont associées à votre utilisateur IAM. Vous devez utiliser ces informations d'identification avec l'assistant d'informations d'identification de l'AWS CLI.

1. Ouvrez la fenêtre de terminal et exécutez la commande suivante pour vérifier que l'AWS CLI est installée :

   aws --version

   Si la commande aboutit, elle renvoie la version actuellement installée de l'AWS CLI. 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. Sur le terminal, exécutez les commandes suivantes pour configurer l'assistant d'informations d'identification de l'AWS CLI pour les connexions HTTPS :

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

   Astuce

   L'assistant d'informations d'identification utilise le rôle d'instance Amazon EC2 par défaut pour votre environnement de développement. Si vous avez l'intention d'utiliser l'environnement de développement pour vous connecter à des référentiels qui ne sont pas hébergés dans CodeCommit, configurez des connexions SSH à ces référentiels ou configurez un local.gitconfigpour utiliser un autre système de gestion des informations d'identification lors de la connexion à ces autres référentiels. Pour plus d'informations, consultez Git Tools - Credential Storage sur le site web de Git.

Étape 3 : Cloner un CodeCommit dans votre référentielAWS Cloud9Environnement de développement EC2

Une fois que vous avez configuré l'AWS CLIassistant d'informations d'identification, vous pouvez cloner votre référentiel CodeCommit dans celui-ci. Vous pouvez ensuite commencer à travailler sur le code.

1. Dans le terminal, exécutez la commande git clone en spécifiant l'adresse URL de clone HTTPS du référentiel que vous souhaitez cloner. Par exemple, si vous souhaitez cloner un référentiel nommé MyDemoRepo Dans la région USA Est (Ohio), vous devez saisir :

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

   Astuce

   Vous pouvez trouver l'URL de clone de votre référentiel dans le CodeCommit console en choisissantURL de clone.

2. Lorsque le clonage est terminé, dans le volet de navigation latéral, développez le dossier de votre référentiel, puis choisissez le fichier que vous souhaitez ouvrir pour le modifier. Vous pouvez également choisir Fichier, puis New File (Nouveau fichier) pour créer un nouveau fichier.

3. Lorsque vous avez terminé la modification ou la création de fichiers, dans la fenêtre de terminal, basculez vers le référentiel cloné puis validez et transférez vos modifications. Par exemple, si vous avez ajouté un nouveau fichier nommé MyFile.py :

   cd MyDemoRepo
   git commit -a MyFile.py
   git commit -m "Added a new file with some code improvements"
   git push

Étapes suivantes

Pour plus d'informations, consultez le .AWS Cloud9Guide de l'utilisateuretExemple CodeCommit pourAWS Cloud9. Pour de plus amples informations sur l'utilisation de Git avec CodeCommit, consultezCommencer à utiliser Git et AWS CodeCommit.