AWS CodeCommittutoriel pour AWS Cloud9 - AWS Cloud9

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.

AWS CodeCommittutoriel pour AWS Cloud9

Vous pouvez utiliser le AWS CodeCommit didacticiel pour configurer un environnement de AWS Cloud9 développement dans lequel interagir avec un référentiel de code distant dansCodeCommit. CodeCommitest un service de contrôle du code source que vous pouvez utiliser pour stocker et gérer de manière privée Git des référentiels dans leAWS Cloud. Pour plus d'informations sur CodeCommit, consultez le AWS CodeCommitGuide de l'utilisateur .

La suite de ce didacticiel et la création de cet exemple peuvent entraîner des frais pour votreCompte AWS. Cela inclut les frais éventuels pour des services tels qu'Amazon EC2 etCodeCommit. Pour en savoir plus, consultez les sections Tarification Amazon EC2 et Tarification AWS CodeCommit.

Prérequis

Avant d'utiliser cet exemple, vérifiez que votre configuration respecte les conditions requises suivantes :

  • Vous devez disposer d'un environnement de développement AWS Cloud9 EC2 existant. Cet exemple suppose que vous disposez déjà d'un environnement EC2 connecté à une instance Amazon EC2 s'exécutant sur Amazon Linux ou Ubuntu Server. Si vous utilisez un autre type d'environnement ou de système d'exploitation, vous devrez peut-être adapter les instructions de cet exemple pour configurer les outils associés. Pour plus d'informations, veuillez consulter Création d'un environnement dans AWS Cloud9.

  • L'IDE AWS Cloud9 correspondant à l'environnement existant est déjà ouvert. Lorsque vous ouvrez un environnement, AWS Cloud9 ouvre l'IDE associé à cet environnement dans votre navigateur web. Pour plus d'informations, veuillez consulter Ouverture d'un environnement dans AWS Cloud9.

Étape 1 : Configurer votre groupe IAM avec les autorisations d'accès requises

Supposons que vos AWS informations d'identification soient associées à un utilisateur administrateur dans votre Compte AWS et que vous souhaitez utiliser cet utilisateur pour travailler avec. Passez CodeCommit ensuite à l'étape 2 : créer un référentiel dans AWS CodeCommit.

Vous pouvez effectuer cette étape à l'aide de la AWS Management Console ou de l'interface de ligne de commande AWS (AWS CLI).

Configurer votre groupe IAM avec les autorisations d'accès requises à l'aide de la console

  1. Connectez-vous à la AWS Management Console si ce n'est pas déjà fait.

    Pour cette étape, nous vous recommandons de vous connecter à l'aide des informations d'identification d'un utilisateur administrateur de votre Compte AWS. Si vous ne pouvez pas le faire, contactez l'administrateur de votre Compte AWS.

  2. Ouvrez la console IAM. Pour ce faire, choisissez Services dans la barre de navigation de la console. Choisissez ensuite IAM.

  3. Choisissez Groupes.

  4. Choisissez le nom du groupe.

  5. Dans l'onglet Autorisations, pour Stratégies gérées, choisissez Attacher la stratégie.

  6. Dans la liste des noms de stratégie, activez l'une des cases suivantes :

    • Sélectionnez AWSCodeCommitPowerUsercette option pour accéder à toutes les fonctionnalités CodeCommit et aux ressources associées au référentiel. Toutefois, cela ne vous permet pas de supprimer des CodeCommit référentiels ni de créer ou de supprimer des ressources liées aux référentiels dans d'autres sitesServices AWS, tels qu'Amazon Events. CloudWatch

    • Sélectionnez AWSCodeCommitFullAccesspour un contrôle total sur CodeCommit les référentiels et les ressources associées dans leCompte AWS. Cela inclut la possibilité de supprimer des référentiels.

    Si vous ne voyez pas l'un de ces noms de politique dans la liste, saisissez les noms des politiques dans la zone Filter (Filtre) pour les afficher.

  7. Choisissez Attach Policy (Attacher une politique).

Pour afficher la liste des autorisations d'accès que ces stratégies gérées par AWS confèrent à un groupe, consultez Politiques gérées par AWS (prédéfinies) pour AWS CodeCommit dans le Guide de l'utilisateur AWS CodeCommit.

Passez directement à Étape 2 : Créer un référentiel dans AWS CodeCommit.

Configurer votre groupe IAM avec les autorisations d'accès requises à l'aide de la AWS CLI

Exécutez la commande IAM attach-group-policy, en spécifiant le nom du groupe et l'Amazon Resource Name (ARN) de la politique gérée par AWS qui décrit les autorisations d'accès requises. La syntaxe est la suivante.

aws iam attach-group-policy --group-name MyGroup --policy-arn POLICY_ARN

Dans la commande précédente, remplacez MyGroup par le nom du groupe. Remplacez POLICY_ARN par l'ARN de la politique gérée par AWS :

  • arn:aws:iam::aws:policy/AWSCodeCommitPowerUserpour accéder à toutes les fonctionnalités CodeCommit et aux ressources associées au référentiel. Toutefois, il ne vous permet pas de supprimer des CodeCommit référentiels ni de créer ou de supprimer des ressources liées aux référentiels dans d'autres sitesServices AWS, tels qu'Amazon Events. CloudWatch

  • arn:aws:iam::aws:policy/AWSCodeCommitFullAccesspour un contrôle total des CodeCommit référentiels et des ressources associées dans leCompte AWS. Cela inclut la possibilité de supprimer des référentiels.

Pour afficher la liste des autorisations d'accès que ces stratégies gérées par AWS confèrent à un groupe, consultez Politiques gérées par AWS (prédéfinies) pour AWS CodeCommit dans le Guide de l'utilisateur AWS CodeCommit.

Étape 2 : Création d'un référentiel dans CodeCommit

Dans cette étape, vous créez un référentiel de code distant dans CodeCommit à l'aide de la console CodeCommit.

Si vous avez déjà un référentiel CodeCommit, passez directement à Étape 3 : Connecter votre environnement au référentiel distant.

Vous pouvez effectuer cette étape à l'aide de la AWS Management Console ou de l'interface de ligne de commande AWS (AWS CLI).

Créez un référentiel à CodeCommit l'aide de la console

  1. Supposons que vous soyez connecté à la AWS Management Console en tant qu'utilisateur administrateur à partir de l'étape précédente et que vous ne souhaitiez pas utiliser l'utilisateur administrateur pour créer le référentiel. Ensuite, déconnectez-vous de la AWS Management Console.

  2. Ouvrez la console CodeCommit, à l'adresse https://console.aws.amazon.com/codecommit.

  3. Dans la barre de navigation de la console, utilisez le sélecteur de région pour choisir la Région AWS dans laquelle vous souhaitez créer le référentiel (par exemple USA Est (Ohio)).

  4. Si une page de bienvenue s'affiche, choisissez Mise en route. Sinon, choisissez Créer un référentiel.

  5. Sur la page Create repository (Créer un référentiel), pour Repository name (Nom du référentiel), saisissez un nom pour votre nouveau référentiel (par exemple, MyDemoCloud9Repo). Si vous choisissez un autre nom, remplacez-le dans l'ensemble de cet exemple.

  6. (Facultatif) Pour Description, saisissez des informations relatives au référentiel. Par exemple, vous pouvez saisir : This is a demonstration repository for the AWS Cloud9 sample.

  7. Choisissez Créer un référentiel. Un volet Connectez-vous à votre référentiel s'affiche. Choisissez Fermer, car vous allez vous connecter à votre référentiel d'une autre manière, plus loin dans cette rubrique.

Passez directement à Étape 3 : Connecter votre environnement au référentiel distant.

Créez un référentiel en CodeCommit utilisant le AWS CLI

Exécutez la commande AWS CodeCommitcreate-repository. Spécifiez le nom du référentiel, une description facultative et la Région AWS dans laquelle créer le référentiel.

aws codecommit create-repository --repository-name MyDemoCloud9Repo --repository-description "This is a demonstration repository for the AWS Cloud9 sample." --region us-east-2

Dans la commande précédente, remplacez us-east-2 par l'ID de la Région AWS dans laquelle créer le référentiel. Pour obtenir la liste des régions prises AWS CodeCommiten charge, consultez le Référence générale d'Amazon Web Services.

Si vous choisissez d'utiliser un autre nom de référentiel, remplacez-le dans l'ensemble de cet exemple.

Étape 3 : Connecter votre environnement au référentiel distant

Au cours de cette étape, vous utilisez l'AWS Cloud9IDE pour vous connecter au CodeCommit référentiel que vous avez créé ou identifié à l'étape précédente.

Note

Si vous préférez utiliser Git via une interface visuelle, vous pouvez cloner le référentiel distant. Vous pouvez ensuite ajouter des fichiers à l'aide de la fonctionnalité de panneau Git disponible dans l'IDE.

Exécutez l'un des jeux de procédures suivants, selon votre type d'environnement de développement AWS Cloud9.

Type d'environnement Suivez ces procédures

Environnement EC2

  1. Depuis une session de terminal dans l'IDE, exécutez les deux commandes suivantes :

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

    Pour plus d'informations, consultez Étape 2 : Configurer l'assistance des informations d'identification AWS CLI sur votre environnement de développement AWS Cloud9 EC2 de Intégration d'AWS Cloud9 à AWS CodeCommit dans le Guide de l'utilisateur AWS CodeCommit.

  2. Passez directement à Étape 4 : Cloner le référentiel distant dans votre environnement, plus loin dans cette rubrique.

Environnement SSH

  1. Si Git n'est pas déjà installé dans l'environnement, utilisez une session de terminal dans l'IDE pour l'installer. Pour plus d'informations, consultez Étape 2 : Installez Git dans Étapes de configuration des connexions SSH aux référentiels AWS CodeCommit sur Linux, macOS ou Unix dans le Guide de l'utilisateur AWS CodeCommit.

  2. Exécutez l'Étape 3 : Configurer les informations d'identification sur Linux, macOS ou Unix de Étapes de configuration pour les connexions SSH aux référentiels AWS CodeCommit sur Linux, macOS ou Unix dans le Guide de l'utilisateur AWS CodeCommit.

    Lorsqu'il vous est demandé de vous connecter à la AWS Management Console et d'ouvrir la console IAM, nous vous recommandons d'utiliser les informations d'identification d'un utilisateur administrateur de votre compte Compte AWS. Si vous ne pouvez pas le faire, contactez l'administrateur de votre Compte AWS.

  3. Passez directement à Étape 4 : Cloner le référentiel distant dans votre environnement, plus loin dans cette rubrique.

Étape 4 : Cloner le référentiel distant dans votre environnement

Au cours de cette étape, vous utilisez l'AWS Cloud9IDE pour cloner le référentiel distant CodeCommit dans votre environnement.

Pour cloner le référentiel, exécutez la commande git clone. Remplacez CLONE_URL par l'URL du clone du référentiel.

git clone CLONE_URL

Pour un environnement EC2, vous fournissez une URL de clone HTTPS qui commence par https://. Pour un environnement SSH, vous fournissez une URL de clone SSH qui démarre par ssh://.

Pour obtenir l'URL complète du clone du référentiel, consultez Utilisation de la console AWS CodeCommit pour afficher les détails du référentiel dans le Guide de l'utilisateur AWS CodeCommit.

Si votre référentiel ne contient aucun fichier, un message d'avertissement s'affiche, tel que You appear to have cloned an empty repository., ce qui est attendu. Vous vous en occuperez plus tard.

Étape 5 : Ajouter les fichiers dans le référentiel

Dans cette étape, vous créez trois fichiers simples dans le référentiel cloné, dans votre environnement AWS Cloud9. Vous ajoutez ensuite les fichiers à la zone de stockage Git de votre référentiel cloné. Enfin, vous validez les fichiers intermédiaires et vous envoyez la validation à votre référentiel distantCodeCommit.

Si le référentiel cloné contient déjà des fichiers, vous avez terminé et vous pouvez ignorer la suite de cet exemple.

Pour ajouter des fichiers dans le référentiel
  1. Créez un nouveau fichier. Dans la barre de menus, choisissez File (Fichier), New File (Nouveau fichier).

  2. Saisissez le contenu suivant dans le fichier, puis choisissez File (Fichier), Save(Enregistrer) pour enregistrer le fichier sous le nom bird.txt dans le répertoire MyDemoCloud9Repo de votre environnement AWS Cloud9.

    bird.txt -------- Birds are a group of endothermic vertebrates, characterized by feathers, toothless beaked jaws, the laying of hard-shelled eggs, a high metabolic rate, a four-chambered heart, and a lightweight but strong skeleton.
    Note

    Pour confirmer que vous enregistrez ce fichier dans le répertoire approprié, dans la boîte de dialogue Save As (Enregistrer sous), choisissez le dossier MyDemoCloud9Repo. Assurez-vous ensuite Folder (Dossier) affiche /MyDemoCloud9Repo.

  3. Créez deux autres fichiers, nommés insect.txt et reptile.txt, avec le contenu suivant. Supprimez les fichiers dans le répertoire MyDemoCloud9Repo.

    insect.txt ---------- Insects are a class of invertebrates within the arthropod phylum that have a chitinous exoskeleton, a three-part body (head, thorax, and abdomen), three pairs of jointed legs, compound eyes, and one pair of antennae.
    reptile.txt ----------- Reptiles are tetrapod (four-limbed vertebrate) animals in the class Reptilia, comprising today's turtles, crocodilians, snakes, amphisbaenians, lizards, tuatara, and their extinct relatives.
  4. Dans le terminal, exécutez la commande cd pour passer au répertoire MyDemoCloud9Repo.

    cd MyDemoCloud9Repo
  5. Vérifiez que les fichiers ont été enregistrés correctement dans le répertoire MyDemoCloud9Repo en exécutant la commande git status. Les trois fichiers seront répertoriés en tant que fichiers non suivis.

    Untracked files: (use "git add <file>..." to include in what will be committed) bird.txt insect.txt reptile.txt
  6. Ajoutez les fichiers dans la zone intermédiaire Git en exécutant la commande git add.

    git add --all
  7. Confirmez que les fichiers ont bien été ajoutés dans la zone intermédiaire Git en réexécutant la commande git status. Les trois fichiers sont désormais répertoriés en tant que modifications à valider.

    Changes to be committed: (use "git rm --cached <file>..." to unstage) new file: bird.txt new file: insect.txt new file: reptile.txt
  8. Validez les fichiers intermédiaires en exécutant la commande git commit.

    git commit -m "Added information about birds, insects, and reptiles."
  9. Transférez le commit à votre référentiel distant en CodeCommit exécutant la git pushcommande.

    git push -u origin master
  10. Confirmez que les fichiers ont été correctement envoyés (push). Ouvrez la console CodeCommit, si elle ne l'est pas encore, à l'adresse https://console.aws.amazon.com/codecommit.

  11. Dans la barre de navigation supérieure, près du bord droit, choisissez la Région AWS dans laquelle vous avez créé le référentiel (par exemple USA Est (Ohio)).

  12. Sur la page Tableau de bord, choisissez MyDemoCloud9Repo. Les trois fichiers sont affichés.

Pour continuer à expérimenter avec votre CodeCommit référentiel, voir Parcourir le contenu de votre référentiel dans le Guide de l'AWS CodeCommitutilisateur.

Si vous êtes novice Git et que vous ne voulez pas gâcher votre CodeCommit dépôt, testez un exemple de Git référentiel sur le Git site Web de Try.

Étape 6 : Nnettoyer

Pour éviter que des frais ne vous soient facturés une Compte AWS fois que vous aurez fini d'utiliser cet exemple, supprimez le CodeCommit référentiel. Pour obtenir des instructions, consultez Suppression d'un référentiel AWS CodeCommit dans le Guide de l'utilisateur AWS CodeCommit.

Assurez-vous également de supprimer l'environnement. Pour obtenir des instructions, consultez Suppression d'un environnement.