AWS Cloud9 n'est plus disponible pour les nouveaux clients. Les clients existants de AWS Cloud9 peuvent continuer à utiliser le service normalement. En savoir plus
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.
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 référentiels dans le. AWS Cloud Pour plus d'informations CodeCommit, consultez le guide de AWS CodeCommit l'utilisateur.
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 plus d'informations, consultez la section EC2 Tarification et AWS CodeCommit tarification
Prérequis
Avant d'utiliser cet exemple, vérifiez que votre configuration respecte les conditions requises suivantes :
-
Vous devez disposer d'un environnement AWS Cloud9 EC2 de développement existant. Cet exemple suppose que vous disposez déjà d'un EC2 environnement connecté à une EC2 instance Amazon exécutant Amazon Linux ou Ubuntu Serveur. 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.
-
L' AWS Cloud9 IDE correspondant à l'environnement existant est déjà ouvert. Lorsque vous ouvrez un environnement, AWS Cloud9 ouvre l'IDE correspondant à cet environnement dans votre navigateur Web. Pour de plus amples informations, veuillez consulter Ouvrir 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 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.
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
-
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 .
-
Ouvrez la console IAM. Pour ce faire, choisissez Services dans la barre de navigation de la console. Choisissez ensuite IAM.
-
Choisissez Groupes.
-
Choisissez le nom du groupe.
-
Dans l'onglet Autorisations, pour Stratégies gérées, choisissez Attacher la stratégie.
-
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 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 AWSCodeCommitFullAccesspour 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.
-
-
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 dans le guide de AWS CodeCommit l'utilisateur.
Passez à l'étape 2 : créer un référentiel dans AWS CodeCommit.
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 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.
Vous pouvez effectuer cette étape à l'aide de la AWS Management Console ou de l'interface de ligne de commande AWS (AWS CLI).
Création d'un référentiel à CodeCommit l'aide de la console
-
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.
-
Ouvrez la CodeCommit console, dans https://console.aws.amazon.com/codecommit
. -
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)).
-
Si une page de bienvenue s'affiche, choisissez Mise en route. Sinon, choisissez Créer un référentiel.
-
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. -
(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.
-
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 à 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 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 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 travailler avec Git via une interface visuelle, vous pouvez cloner le dépôt 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 |
---|---|
EC2 environnement |
|
Environnement SSH |
|
É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 EC2 environnement, vous devez fournir une URL de clone HTTPS commençant parhttps://
. 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 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 . Ensuite, vous ajoutez les fichiers au Git zone de transit dans votre dépôt 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
-
Créez un nouveau fichier. Dans la barre de menus, choisissez File (Fichier), New File (Nouveau fichier).
-
Entrez le contenu suivant dans le fichier, puis choisissez Fichier, Enregistrer pour enregistrer le fichier
bird.txt
dans leMyDemoCloud9Repo
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
. -
Créez deux autres fichiers, nommés
insect.txt
etreptile.txt
, avec le contenu suivant. Supprimez les fichiers dans le répertoireMyDemoCloud9Repo
.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.
-
Dans le terminal, exécutez la commande
cd
pour passer au répertoireMyDemoCloud9Repo
.cd MyDemoCloud9Repo
-
Vérifiez que les fichiers ont été enregistrés correctement dans le répertoire
MyDemoCloud9Repo
en exécutant la commandegit 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
-
Ajoutez les fichiers dans la zone intermédiaire Git en exécutant la commande
git add
.git add --all
-
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
-
Validez les fichiers intermédiaires en exécutant la commande
git commit
.git commit -m "Added information about birds, insects, and reptiles."
-
Transférez le commit vers votre dépôt distant en CodeCommit exécutant la
git push
commande.git push -u origin master
-
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.
-
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)).
-
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 dans le guide de l'AWS CodeCommit utilisateur.
Si vous êtes nouveau dans Git et vous ne voulez pas gâcher votre CodeCommit dépôt, faites des essais avec un échantillon Git dépôt sur le Try Git
É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 dans le guide de AWS CodeCommit l'utilisateur.
Assurez-vous également de supprimer l'environnement. Pour obtenir des instructions, consultez Suppression d'un environnement.