AWS Cloud9 n'est plus disponible pour les nouveaux clients. Les clients existants d’ AWS Cloud9 peuvent continuer à l’utiliser normalement. [En savoir plus](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)
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 CodeCommit tutoriel pour AWS Cloud9
Vous pouvez utiliser le AWS CodeCommit didacticiel pour configurer un environnement de AWS Cloud9 développement dans lequel interagir avec un dépôt de code distant CodeCommit. CodeCommit est 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 le AWS Cloud. Pour plus d'informations CodeCommit, consultez le [guide de AWS CodeCommit l'utilisateur](https://docs.aws.amazon.com/codecommit/latest/userguide/).
Le fait de suivre ce didacticiel et de créer cet exemple peut entraîner des frais pour votre Compte AWS. Cela inclut les frais éventuels pour des services tels qu'Amazon EC2 et. CodeCommit Pour en savoir plus, consultez les sections [Tarification Amazon EC2](https://aws.amazon.com/ec2/pricing/) et [Tarification AWS CodeCommit](https://aws.amazon.com/codecommit/pricing/).
+ [Conditions préalables](#sample-codecommit-prereqs)
+ [Étape 1 : Configurer votre groupe IAM avec les autorisations d'accès requises](#sample-codecommit-permissions)
+ [Étape 2 : créer un dépôt dans AWS CodeCommit](#sample-codecommit-create-repo)
+ [Étape 3 : Connecter votre environnement au référentiel distant](#sample-codecommit-connect-repo)
+ [Étape 4 : Cloner le référentiel distant dans votre environnement](#sample-codecommit-clone-repo)
+ [Étape 5 : Ajouter les fichiers dans le référentiel](#sample-codecommit-add-files)
+ [Étape 6 : Nnettoyer](#sample-codecommit-clean-up)
## Conditions préalables
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 de plus amples informations, veuillez consulter [Création d'un environnement dans AWS Cloud9](create-environment.md).
+ **L' AWS Cloud9 IDE correspondant à l'environnement existant est déjà ouvert.** Lorsque vous ouvrez un environnement, AWS Cloud9 ouvre l'IDE correspondant dans votre navigateur Web. Pour de plus amples informations, veuillez consulter [Ouvrir un environnement dans AWS Cloud9](open-environment.md).
## É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 de votre Compte AWS compte et que vous souhaitiez utiliser cet utilisateur pour travailler avec. CodeCommit Ensuite, passez à l'[étape 2 : créer un référentiel dans AWS CodeCommit](#sample-codecommit-create-repo).
Vous pouvez effectuer cette étape à l'aide de la [AWS Management Console](#sample-codecommit-permissions-console) ou de [l'interface de ligne de commande AWS (AWS CLI)](#sample-codecommit-permissions-cli).
### Configurer votre groupe IAM avec les autorisations d'accès requises à l'aide de la console
1. Connectez-vous au 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 .
1. Ouvrez la console IAM. Pour ce faire, choisissez **Services** dans la barre de navigation de la console. Choisissez ensuite **IAM**.
1. Choisissez **Groupes**.
1. Choisissez le nom du groupe.
1. Dans l'onglet **Autorisations**, pour **Stratégies gérées**, choisissez **Attacher la stratégie**.
1. Dans la liste des noms de stratégie, activez l'une des cases suivantes :
+ Sélectionnez **AWSCodeCommitPowerUser**pour accéder à toutes les fonctionnalités CodeCommit et aux ressources liées au référentiel. Toutefois, cela ne vous permet pas de supprimer des CodeCommit référentiels ou de créer ou de supprimer des ressources liées aux référentiels dans d'autres sites, Services AWS tels qu'Amazon Events. CloudWatch
+ Sélectionnez **AWSCodeCommitFullAccess**pour un contrôle total sur CodeCommit les référentiels et les ressources associées dans le Compte 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.
1. Choisissez **Attach Policy** (Attacher une politique).
Pour consulter la liste des autorisations d'accès que ces politiques AWS gérées accordent à un groupe, consultez la section [Politiques AWS gérées (prédéfinies) AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#managed-policies) dans le *guide de AWS CodeCommit l'utilisateur*.
Passez à l'[étape 2 : créer un référentiel dans AWS CodeCommit](#sample-codecommit-create-repo).
### Configurez votre groupe IAM avec les autorisations d'accès requises à l'aide du AWS CLI
Exécutez la `attach-group-policy` commande IAM en spécifiant le nom du groupe et le nom de ressource Amazon (ARN) de la politique AWS gérée 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 AWS gérée :
+ `arn:aws:iam::aws:policy/AWSCodeCommitPowerUser`pour accéder à toutes les fonctionnalités CodeCommit et aux ressources liées au référentiel. Toutefois, il ne vous permet pas de supprimer des CodeCommit référentiels ou de créer ou de supprimer des ressources liées aux référentiels dans d'autres sites, Services AWS tels qu'Amazon Events. CloudWatch
+ `arn:aws:iam::aws:policy/AWSCodeCommitFullAccess`pour un contrôle total des CodeCommit référentiels et des ressources associées dans le Compte AWS. Cela inclut la possibilité de supprimer des référentiels.
Pour consulter la liste des autorisations d'accès que ces politiques AWS gérées accordent à un groupe, consultez la section [Politiques AWS gérées (prédéfinies) AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#managed-policies) dans le *guide de AWS CodeCommit l'utilisateur*.
## Étape 2 : créer un dépôt dans CodeCommit
Dans cette étape, vous créez un référentiel de code distant à CodeCommit l'aide de la CodeCommit console.
Si vous possédez déjà un CodeCommit référentiel, passez à l'[étape 3 : Connecter votre environnement au référentiel distant](#sample-codecommit-connect-repo).
Vous pouvez effectuer cette étape à l'aide de la [AWS Management Console](#sample-codecommit-create-repo-console) ou de [l'interface de ligne de commande AWS (AWS CLI)](#sample-codecommit-create-repo-cli).
### Création d'un référentiel à CodeCommit l'aide de la console
1. Supposons que vous soyez connecté au en AWS Management Console tant qu'utilisateur administrateur à 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 du AWS Management Console.
1. Ouvrez la CodeCommit console dans [https://console.aws.amazon.com/codecommit](https://console.aws.amazon.com/codecommit).
1. 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)**).
1. Si une page de bienvenue s'affiche, choisissez **Mise en route**. Sinon, choisissez **Créer un référentiel**.
1. 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.
1. (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.`
1. 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](#sample-codecommit-connect-repo).
### Créez un référentiel à CodeCommit l'aide du AWS CLI
Exécutez la commande AWS CodeCommit `create-repository`. Spécifiez le nom du référentiel, une description facultative et le nom dans lequel Région AWS 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 CodeCommit](https://docs.aws.amazon.com/general/latest/gr/rande.html#codecommit_region)en 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 Cloud9 IDE 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](source-control-gitpanel.md) 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 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/cloud9/latest/user-guide/sample-codecommit.html) |
| Environnement SSH | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/cloud9/latest/user-guide/sample-codecommit.html) |
## Étape 4 : Cloner le référentiel distant dans votre environnement
Au cours de cette étape, vous utilisez l' AWS Cloud9 IDE 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, voir [Utiliser la AWS CodeCommit console pour afficher les détails du référentiel](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-view-repository-details.html#how-to-view-repository-details-console) dans le *guide de AWS CodeCommit l'utilisateur*.
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 préparés et vous transférez le commit vers votre dépôt distant CodeCommit.
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)**.
1. Entrez le contenu suivant dans le fichier, puis choisissez **Fichier**, **Enregistrer** pour enregistrer le fichier `bird.txt` dans le `MyDemoCloud9Repo` répertoire de votre AWS Cloud9 environnement.
```
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`.
1. 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.
```
1. Dans le terminal, exécutez la commande **`cd`** pour passer au répertoire `MyDemoCloud9Repo`.
```
cd MyDemoCloud9Repo
```
1. 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 ..." to include in what will be committed)
bird.txt
insect.txt
reptile.txt
```
1. Ajoutez les fichiers dans la zone intermédiaire Git en exécutant la commande **`git add`**.
```
git add --all
```
1. 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 ..." to unstage)
new file: bird.txt
new file: insect.txt
new file: reptile.txt
```
1. Validez les fichiers intermédiaires en exécutant la commande **`git commit`**.
```
git commit -m "Added information about birds, insects, and reptiles."
```
1. Transférez le commit vers votre dépôt distant en CodeCommit exécutant la **`git push`**commande.
```
git push -u origin master
```
1. Confirmez que les fichiers ont été correctement envoyés (push). Ouvrez la CodeCommit console, si ce n'est pas déjà fait, dans [https://console.aws.amazon.com/codecommit.](https://console.aws.amazon.com/codecommit)
1. Dans la barre de navigation supérieure, près du bord droit, choisissez l' Région AWS endroit où vous avez créé le référentiel (par exemple, **USA East (Ohio)**).
1. Sur la page **Tableau de bord**, choisissez **MyDemoCloud9Repo**. Les trois fichiers sont affichés.
Pour continuer à expérimenter avec votre CodeCommit dépôt, voir [Parcourir le contenu de votre référentiel](https://docs.aws.amazon.com/codecommit/latest/userguide/getting-started-cc.html#getting-started-cc-browse) dans le *guide de l'AWS CodeCommit utilisateur*.
Si vous êtes nouveau 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 [Try](https://try.github.io/).
## Étape 6 : Nettoyer
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, voir [Supprimer un AWS CodeCommit référentiel](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html) dans le *guide de AWS CodeCommit l'utilisateur*.
Assurez-vous également de supprimer l'environnement. Pour obtenir des instructions, consultez [Suppression d'un environnement](delete-environment.md).