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.
# Tutoriel : CodeDeploy À utiliser pour déployer une application à partir de GitHub
Dans ce didacticiel, vous pouvez CodeDeploy déployer un exemple de révision GitHub d'application depuis une seule instance Amazon EC2 exécutant Amazon Linux, une seule instance Red Hat Enterprise Linux (RHEL) ou une seule instance Windows Server. Pour plus d'informations sur GitHub l'intégration avec CodeDeploy, consultez[Intégration CodeDeploy avec GitHub](integrations-partners-github.md).
**Note**
Vous pouvez également l'utiliser CodeDeploy pour déployer une révision d'application depuis GitHub une instance de serveur Ubuntu. Vous pouvez utiliser l'exemple de révision décrit [Étape 2 : Création d'un exemple de révision d'application](tutorials-on-premises-instance-2-create-sample-revision.md) dans[Tutoriel : Déployer une application sur une instance locale avec CodeDeploy (Windows Server, Ubuntu Server ou Red Hat Enterprise Linux)](tutorials-on-premises-instance.md), ou vous pouvez créer une révision compatible avec une instance de serveur Ubuntu et CodeDeploy. Pour créer votre propre révision, consultez les pages [Planifier une révision pour CodeDeploy](application-revisions-plan.md) et [Ajouter un fichier de spécification d'application à une révision pour CodeDeploy](application-revisions-appspec-file.md).
**Topics**
+ [Conditions préalables](tutorials-github-prerequisites.md)
+ [Étape 1 : créer un GitHub compte](tutorials-github-create-github-account.md)
+ [Étape 2 : Création d'un GitHub référentiel](tutorials-github-create-github-repository.md)
+ [Étape 3 : télécharger un exemple d'application dans votre GitHub référentiel](tutorials-github-upload-sample-revision.md)
+ [Étape 4 : provisionner une instance](tutorials-github-provision-instance.md)
+ [Étape 5 : Création d'une application et d'un groupe de déploiement](tutorials-github-create-application.md)
+ [Étape 6 : Déployer l'application sur l'instance](tutorials-github-deploy-application.md)
+ [Étape 7 : Surveiller et vérifier le déploiement](tutorials-github-verify.md)
+ [Étape 8 : nettoyer](tutorials-github-clean-up.md)
# Conditions préalables
Avant de commencer ce didacticiel, procédez comme suit :
+ Installez Git sur votre machine locale. Pour installer Git, consultez la section [Téléchargements de Git](http://git-scm.com/downloads).
+ Suivez les étapes de la rubrique [Commencer avec CodeDeploy](getting-started-codedeploy.md), y compris l'installation et la configuration de l' AWS CLI. Cela est particulièrement important si vous souhaitez utiliser le AWS CLI pour déployer une révision depuis GitHub l'instance.
# Étape 1 : créer un GitHub compte
Vous aurez besoin d'un GitHub compte pour créer un GitHub dépôt dans lequel la révision sera stockée. Si vous avez déjà un GitHub compte, passez directement à[Étape 2 : Création d'un GitHub référentiel](tutorials-github-create-github-repository.md).
1. Accédez à [https://github.com/join](https://github.com).
1. Tapez un nom d'utilisateur, votre adresse e-mail et un mot de passe.
1. Choisissez **S'inscrire pour GitHub**, puis suivez les instructions.
# Étape 2 : Création d'un GitHub référentiel
Vous aurez besoin d'un GitHub dépôt pour stocker la révision.
Si vous possédez déjà un GitHub dépôt, veillez à le remplacer par son nom **CodeDeployGitHubDemo** tout au long de ce didacticiel, puis passez à[Étape 3 : télécharger un exemple d'application dans votre GitHub référentiel](tutorials-github-upload-sample-revision.md).
1. Sur la [page d'GitHub accueil](https://github.com/dashboard), effectuez l'une des opérations suivantes :
+ Dans **Your repositories**, choisissez **New repository**.
+ Dans la barre de navigation, choisissez **Create new** (**\$1**), puis **New repository**.
1. Sur la page **Create a new repository**, procédez comme suit :
+ Dans la zone de texte **Nom du référentiel**, entrez **CodeDeployGitHubDemo**.
+ Sélectionnez **Public**.
**Note**
La sélection de l'option par défaut **Public** signifie que tout le monde peut voir ce référentiel. Vous pouvez sélectionner l'option **Private** pour limiter les personnes autorisées à voir et à valider le référentiel.
+ Décochez la case **Initialize this repository with a README**. Vous allez créer un fichier `README.md` manuellement à la place, à l'étape suivante.
+ Choisissez **Créer un référentiel**.
1. Suivez les instructions pour que votre type d'ordinateur local puisse utiliser la ligne de commande pour créer le référentiel.
**Note**
Si vous avez activé l'authentification à deux facteurs GitHub, assurez-vous de saisir votre jeton d'accès personnel au lieu de votre mot de passe de GitHub connexion si vous y êtes invité. Pour plus d'informations, consultez la section [Fourniture de votre code d'authentification 2FA](https://help.github.com/articles/providing-your-2fa-authentication-code/).
**Sur les machines Linux, macOS ou Unix locales :**
1. Depuis le terminal, exécutez les commandes suivantes, une par une, où se *user-name* trouve votre nom GitHub d'utilisateur :
```
mkdir /tmp/CodeDeployGitHubDemo
```
```
cd /tmp/CodeDeployGitHubDemo
```
```
touch README.md
```
```
git init
```
```
git add README.md
```
```
git commit -m "My first commit"
```
```
git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git
```
```
git push -u origin master
```
1. Laissez le terminal ouvert à l'emplacement `/tmp/CodeDeployGitHubDemo`.
**Sur les machines Windows locales :**
1. A partir d'une invite de commandes exécutée avec des autorisations d'administrateur, exécutez les commandes suivantes, l'une après l'autre :
```
mkdir c:\temp\CodeDeployGitHubDemo
```
```
cd c:\temp\CodeDeployGitHubDemo
```
```
notepad README.md
```
1. Dans le Bloc-notes, enregistrez le fichier `README.md`. Fermez le Bloc-notes. Exécutez les commandes suivantes, une par une, en indiquant *user-name* votre nom GitHub d'utilisateur :
```
git init
```
```
git add README.md
```
```
git commit -m "My first commit"
```
```
git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git
```
```
git push -u origin master
```
1. Laissez l'invite de commandes ouverte à l'emplacement `c:\temp\CodeDeployGitHubDemo`.
# Étape 3 : télécharger un exemple d'application dans votre GitHub référentiel
Au cours de cette étape, vous allez copier un exemple de révision depuis un compartiment Amazon S3 public vers votre GitHub référentiel. (Pour plus de simplicité, les exemples de révisions fournis pour ce didacticiel sont des pages web uniques.)
**Note**
Si vous utilisez l'une de vos révisions à la place de notre exemple de révision, votre révision doit :
suivre les instructions des rubriques [Planifier une révision pour CodeDeploy](application-revisions-plan.md) et [Ajouter un fichier de spécification d'application à une révision pour CodeDeploy](application-revisions-appspec-file.md) ;
utiliser le type d'instance correspondant ;
Soyez accessible depuis votre GitHub tableau de bord.
Si votre révision répond à ces exigences, passez à l'[Étape 5 : Création d'une application et d'un groupe de déploiement](tutorials-github-create-application.md).
Si vous déployez sur une instance Ubuntu Server, vous devrez télécharger dans votre GitHub référentiel une révision compatible avec une instance Ubuntu Server et CodeDeploy. Pour plus d’informations, consultez [Planifier une révision pour CodeDeploy](application-revisions-plan.md) et [Ajouter un fichier de spécification d'application à une révision pour CodeDeploy](application-revisions-appspec-file.md).
**Topics**
+ [Envoyer un exemple de révision depuis une machine Linux, macOS ou Unix locale](#tutorials-github-upload-sample-revision-unixes)
+ [Transmission de type push d'un exemple de révision à partir d'une machine Windows locale](#tutorials-github-upload-sample-revision-windows)
## Envoyer un exemple de révision depuis une machine Linux, macOS ou Unix locale
Le terminal étant toujours ouvert, par exemple à l'emplacement `/tmp/CodeDeployGitHubDemo`, exécutez les commandes suivantes l'une après l'autre :
**Note**
Si vous prévoyez de le déployer sur une instance Windows Server, `SampleApp_Windows.zip` remplacez-le par `SampleApp_Linux.zip` dans les commandes.
```
(Amazon S3 copy command)
```
```
unzip SampleApp_Linux.zip
```
```
rm SampleApp_Linux.zip
```
```
git add .
```
```
git commit -m "Added sample app"
```
```
git push
```
Où se *(Amazon S3 copy command)* trouve l'un des éléments suivants :
+ `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Linux.zip . --region us-east-2`pour la région de l'est des États-Unis (Ohio)
+ `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Linux.zip . --region us-east-1`pour la région de l'est des États-Unis (Virginie du Nord)
+ `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Linux.zip . --region us-west-1` pour la région USA Ouest (Californie du Nord)
+ `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Linux.zip . --region us-west-2`pour la région de l'ouest des États-Unis (Oregon)
+ `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Linux.zip . --region ca-central-1`pour la région du Canada (Centre)
+ `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Linux.zip . --region eu-west-1`pour la région Europe (Irlande)
+ `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Linux.zip . --region eu-west-2`pour la région Europe (Londres)
+ `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Linux.zip . --region eu-west-3`pour la région Europe (Paris)
+ `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Linux.zip . --region eu-central-1`pour la région Europe (Francfort)
+ `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Linux.zip . --region il-central-1`pour la région d'Israël (Tel Aviv)
+ `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Linux.zip . --region ap-east-1`pour la région Asie-Pacifique (Hong Kong)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Linux.zip . --region ap-northeast-1`pour la région Asie-Pacifique (Tokyo)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Linux.zip . --region ap-northeast-2`pour la région Asie-Pacifique (Séoul)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Linux.zip . --region ap-southeast-1`pour la région Asie-Pacifique (Singapour)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Linux.zip . --region ap-southeast-2`pour la région Asie-Pacifique (Sydney)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Linux.zip . --region ap-southeast-4`pour la région Asie-Pacifique (Melbourne)
+ `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Linux.zip . --region ap-south-1`pour la région Asie-Pacifique (Mumbai)
+ `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Linux.zip . --region sa-east-1`pour la région Amérique du Sud (São Paulo)
## Transmission de type push d'un exemple de révision à partir d'une machine Windows locale
L'invite de commande étant toujours ouvert, par exemple à l'emplacement `c:\temp\CodeDeployGitHubDemo`, exécutez les commandes suivantes l'une après l'autre :
**Note**
Si vous prévoyez de déployer sur une instance Amazon Linux ou RHEL, remplacez-la par `SampleApp_Windows.zip` in dans `SampleApp_Linux.zip` les commandes.
```
(Amazon S3 copy command)
```
Décompressez le contenu du fichier zip `the` directement dans le répertoire local (par exemple `c:\temp\CodeDeployGitHubDemo`), et non dans un nouveau sous-répertoire.
```
git add .
```
```
git commit -m "Added sample app"
```
```
git push
```
Où se *(Amazon S3 copy command)* trouve l'un des éléments suivants :
+ `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Windows.zip . --region us-east-2`pour la région de l'est des États-Unis (Ohio)
+ `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Windows.zip . --region us-east-1`pour la région de l'est des États-Unis (Virginie du Nord)
+ `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Windows.zip . --region us-west-1` pour la région USA Ouest (Californie du Nord)
+ `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Windows.zip . --region us-west-2`pour la région de l'ouest des États-Unis (Oregon)
+ `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Windows.zip . --region ca-central-1`pour la région du Canada (Centre)
+ `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Windows.zip . --region eu-west-1`pour la région Europe (Irlande)
+ `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Windows.zip . --region eu-west-2`pour la région Europe (Londres)
+ `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Windows.zip . --region eu-west-3`pour la région Europe (Paris)
+ `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Windows.zip . --region eu-central-1`pour la région Europe (Francfort)
+ `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Windows.zip . --region il-central-1`pour la région d'Israël (Tel Aviv)
+ `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Windows.zip . --region ap-east-1`pour la région Asie-Pacifique (Hong Kong)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Windows.zip . --region ap-northeast-1`pour la région Asie-Pacifique (Tokyo)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Windows.zip . --region ap-northeast-2`pour la région Asie-Pacifique (Séoul)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Windows.zip . --region ap-southeast-1`pour la région Asie-Pacifique (Singapour)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Windows.zip . --region ap-southeast-2`pour la région Asie-Pacifique (Sydney)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Windows.zip . --region ap-southeast-4`pour la région Asie-Pacifique (Melbourne)
+ `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Windows.zip . --region ap-south-1`pour la région Asie-Pacifique (Mumbai)
+ `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Windows.zip . --region sa-east-1`pour la région Amérique du Sud (São Paulo)
Pour transférer votre propre révision vers une instance du serveur Ubuntu, copiez-la dans votre dépôt local, puis appelez le système suivant :
```
git add .
git commit -m "Added Ubuntu app"
git push
```
# Étape 4 : provisionner une instance
Au cours de cette étape, vous allez créer ou configurer l'instance sur laquelle vous allez déployer l'exemple d'application. Vous pouvez effectuer un déploiement sur une instance Amazon EC2 ou une instance sur site qui exécute l'un des systèmes d'exploitation pris en charge par. CodeDeploy Pour plus d'informations, consultez [Systèmes d'exploitation pris en charge par l' CodeDeploy agent](codedeploy-agent.md#codedeploy-agent-supported-operating-systems). (Si une instance est déjà configurée pour être utilisée dans CodeDeploy des déploiements, passez à l'étape suivante.)
**Pour provisionner une instance**
1. Suivez les instructions [Lancer une instance Amazon EC2 (console)](instances-ec2-create.md#instances-ec2-create-console) pour provisionner une instance.
1. Lorsque vous lancez l'instance, n'oubliez pas de spécifier une balise sur la page **Ajouter des balises**. Pour plus de détails sur la façon de spécifier la balise, consultez[Lancer une instance Amazon EC2 (console)](instances-ec2-create.md#instances-ec2-create-console).
**Pour vérifier que l' CodeDeploy agent est en cours d'exécution sur l'instance**
+ Suivez les instructions [Vérifiez que l' CodeDeploy agent est en cours d'exécution](codedeploy-agent-operations-verify.md) pour vérifier que l'agent est en cours d'exécution.
Après avoir correctement provisionné l'instance et vérifié que l' CodeDeploy agent est en cours d'exécution, passez à l'étape suivante.
# Étape 5 : Création d'une application et d'un groupe de déploiement
Au cours de cette étape, vous allez utiliser la CodeDeploy console ou le AWS CLI pour créer une application et un groupe de déploiement à utiliser pour déployer l'exemple de révision depuis votre GitHub référentiel.
## Création d'une application et d'un groupe de déploiement (console)
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Dans le volet de navigation, développez **Deploy**, puis choisissez **Applications**.
1. Choisissez **Créer une application**, puis sélectionnez **Application personnalisée**.
1. Dans **Nom de l'application**, saisissez **CodeDeployGitHubDemo-App**.
1. Dans **Plateforme informatique**, choisissez **EC2/Sur site**.
1. Choisissez **Créer une application**.
1. Dans l'onglet **Groupes de déploiement**, choisissez **Créer un groupe de déploiement**.
1. Dans **Nom du groupe de déploiement**, saisissez **CodeDeployGitHubDemo-DepGrp**.
1. Dans **Rôle de service**, choisissez le nom du rôle de CodeDeploy service que vous avez créé dans [Créer un rôle de service pour CodeDeploy](getting-started-create-service-role.md).
1. Dans **Type de déploiement**, choisissez **Sur place**.
1. Dans **Configuration de l'environnement**, en fonction du type d'instance que vous utilisez, choisissez les instances **Amazon EC2 ou les instances** **sur** site. Dans les zones **Clé** et **Valeur**, entrez la clé et la valeur de la balise d'instance qui a été appliquée à votre instance à l'[Étape 4 : provisionner une instance](tutorials-github-provision-instance.md).
1. Dans **Configuration du déploiement**, choisissez **CodeDeployDefault. AllatOnce**.
1. Dans **Équilibreur de charge**, désactivez **Activer l'équilibrage de charge**.
1. Développez **Avancé**.
1. Dans **Alarmes**, sélectionnez **Ignorer les alarmes**.
1. Choisissez **Créer un groupe de déploiement** et passez à l'étape suivante.
## Création d'une application et d'un groupe de déploiement (interface de ligne de commande)
1. Appelez la commande **create-application** pour créer une application dans CodeDeploy nommée `CodeDeployGitHubDemo-App` :
```
aws deploy create-application --application-name CodeDeployGitHubDemo-App
```
1. Appelez la commande **create-deployment-group** pour créer un groupe de déploiement nommé `CodeDeployGitHubDemo-DepGrp` :
+ Si vous effectuez un déploiement sur une instance Amazon EC2, *ec2-tag-key* la clé de balise d'instance Amazon EC2 qui a été appliquée à votre instance Amazon EC2 dans le cadre de. [Étape 4 : provisionner une instance](tutorials-github-provision-instance.md)
+ Si vous effectuez un déploiement sur une instance Amazon EC2, *ec2-tag-value* la valeur de balise d'instance Amazon EC2 qui a été appliquée à votre instance Amazon EC2 dans le cadre de. [Étape 4 : provisionner une instance](tutorials-github-provision-instance.md)
+ Si vous effectuez un déploiement sur une instance locale, *on-premises-tag-key* la clé de balise d'instance locale qui a été appliquée à votre instance sur site fait-elle partie de. [Étape 4 : provisionner une instance](tutorials-github-provision-instance.md)
+ Si vous effectuez un déploiement sur une instance locale, *on-premises-tag-value* la valeur de balise d'instance locale qui a été appliquée à votre instance sur site fait-elle partie de. [Étape 4 : provisionner une instance](tutorials-github-provision-instance.md)
+ *service-role-arn*est l'ARN du rôle de service que vous avez créé dans [Créer un rôle de service pour CodeDeploy](getting-started-create-service-role.md). (Suivez les instructions de [Obtenez l'ARN du rôle de service (CLI)](getting-started-create-service-role.md#getting-started-get-service-role-cli) pour trouver le nom ARN du rôle de service.)
```
aws deploy create-deployment-group --application-name CodeDeployGitHubDemo-App --ec2-tag-filters Key=ec2-tag-key,Type=KEY_AND_VALUE,Value=ec2-tag-value --on-premises-tag-filters Key=on-premises-tag-key,Type=KEY_AND_VALUE,Value=on-premises-tag-value --deployment-group-name CodeDeployGitHubDemo-DepGrp --service-role-arn service-role-arn
```
**Note**
La [create-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-group.html)commande permet de créer des déclencheurs qui entraînent l'envoi de notifications Amazon SNS aux abonnés du topic concernant des événements spécifiques liés aux déploiements et aux instances. La commande prend également en charge des options permettant d'annuler automatiquement les déploiements et de configurer des alarmes pour arrêter les déploiements lorsque les seuils de surveillance des CloudWatch alarmes d'Amazon sont atteints. Les commandes associées à ces actions ne sont pas incluses dans ce didacticiel.
# Étape 6 : Déployer l'application sur l'instance
Au cours de cette étape, vous devez utiliser la CodeDeploy console ou le AWS CLI pour déployer l'exemple de révision de votre GitHub référentiel vers votre instance.
## Pour déployer la révision (console)
1. Sur la page **Détails du groupe de déploiement**, choisissez **Créer un déploiement**.
1. Dans **Groupe de déploiement**, choisissez **`CodeDeployGitHubDemo-DepGrp`**.
1. Dans **Type de révision**, sélectionnez **GitHub**.
1. Dans **Connect to GitHub**, effectuez l'une des opérations suivantes :
+ Pour créer une connexion entre CodeDeploy les applications et un GitHub compte, déconnectez-vous GitHub dans un onglet de navigateur Web distinct. Dans le **GitHub compte**, entrez un nom pour identifier cette connexion, puis choisissez **Connect to GitHub**. La page Web vous invite CodeDeploy à autoriser l'interaction avec GitHub l'application nommée`CodeDeployGitHubDemo-App`. Passez à l'étape 5.
+ Pour utiliser une connexion que vous avez déjà créée, dans le **GitHubcompte**, sélectionnez son nom, puis choisissez **Connect to GitHub**. Passez à l'étape 7.
+ Pour créer une connexion à un autre GitHub compte, déconnectez-vous GitHub dans un onglet de navigateur Web distinct. Choisissez **Se connecter à un autre GitHub compte**, puis sélectionnez **Connect to GitHub**. Passez à l'étape 5.
1. Suivez les instructions de la page **de connexion** pour vous connecter avec votre GitHub compte.
1. Sur la page **Authorize application**, choisissez **Authorize application**.
1. Sur la page CodeDeploy **Créer un déploiement**, dans **Nom du référentiel**, entrez le nom GitHub d'utilisateur que vous avez utilisé pour vous connecter, suivi d'une barre oblique (`/`), suivi du nom du référentiel dans lequel vous avez envoyé la révision de votre application (par exemple,***my-github-user-name*/CodeDeployGitHubDemo**).
Si vous n'êtes pas sûr de la valeur à entrer ou si vous souhaitez spécifier un autre référentiel :
1. Dans un onglet de navigateur Web distinct, accédez à votre [GitHub tableau de bord](https://github.com/dashboard).
1. Dans **Your repositories**, placez le pointeur de la souris sur le nom du référentiel cible. Une infobulle apparaît, affichant le nom de l' GitHub utilisateur ou de l'organisation, suivi d'une barre oblique (`/`), puis du nom du référentiel. Entrez cette valeur dans la zone **Nom du référentiel**.
**Note**
Si le nom du référentiel cible n'apparaît pas dans **Vos référentiels**, utilisez la GitHub zone de **recherche** pour trouver le référentiel cible et le nom de GitHub l'utilisateur ou de l'organisation.
1. Dans le champ **ID de validation**, entrez l'ID du commit associé au transfert de la révision de votre application vers GitHub.
Si vous n'êtes pas sûr de la valeur à entrer :
1. Dans un onglet de navigateur Web distinct, accédez à votre [GitHub tableau de bord](https://github.com/dashboard).
1. Dans **Your repositories**, choisissez **CodeDeployGitHubDemo**.
1. Dans la liste des validations, recherchez et copiez l'ID de validation associé au push de la révision de votre application vers GitHub. Cet ID contient généralement 40 caractères et se compose de lettres et de chiffres. (N'utilisez pas la version courte de l'ID de validation, qui correspond généralement aux 10 premiers caractères de la version longue.)
1. Collez l'ID de validation dans la zone **ID de validation**.
1. Choisissez **Déployer** et passez à l'étape suivante.
## Pour déployer la révision (interface de ligne de commande)
Avant de pouvoir appeler une AWS CLI commande qui interagit GitHub (telle que la **create-deployment** commande que vous appellerez ensuite), vous devez CodeDeploy autoriser l'utilisation de votre compte GitHub utilisateur GitHub pour interagir avec l'`CodeDeployGitHubDemo-App`application. Actuellement, vous devez utiliser la console CodeDeploy pour ce faire.
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Dans le volet de navigation, développez **Deploy**, puis choisissez **Applications**.
1. Choisissez **CodeDeployGitHubDemo-App**.
1. Sur l'onglet **Déploiements**, choisissez **Créer un déploiement**.
**Note**
Vous n'allez pas créer un nouveau déploiement. C'est actuellement le seul moyen de donner CodeDeploy l'autorisation d'interagir avec vous GitHub au nom de votre compte GitHub utilisateur.
1. Dans **le groupe de déploiement**, choisissez **CodeDeployGitHubDemo- DepGrp**.
1. Dans **Type de révision**, sélectionnez **GitHub**.
1. Dans **Connect to GitHub**, effectuez l'une des opérations suivantes :
+ Pour créer une connexion entre CodeDeploy les applications et un GitHub compte, déconnectez-vous GitHub dans un onglet de navigateur Web distinct. Dans le **GitHub compte**, tapez un nom pour identifier cette connexion, puis choisissez **Connect to GitHub**. La page Web vous invite CodeDeploy à autoriser l'interaction avec GitHub l'application nommée`CodeDeployGitHubDemo-App`. Passez à l'étape 8.
+ Pour utiliser une connexion que vous avez déjà créée, dans le **GitHubcompte**, sélectionnez son nom, puis choisissez **Connect to GitHub**. Passez à l'étape 10.
+ Pour créer une connexion à un autre GitHub compte, déconnectez-vous GitHub dans un onglet de navigateur Web distinct. Choisissez **Se connecter à un autre GitHub compte**, puis sélectionnez **Connect to GitHub**. Passez à l'étape 8.
1. Suivez les instructions de la page de connexion pour **vous connecter à** l'aide de votre nom GitHub d'utilisateur ou de votre adresse e-mail et de votre mot de passe.
1. Sur la page **Authorize application**, choisissez **Authorize application**.
1. Sur la page CodeDeploy **Créer un déploiement**, choisissez **Annuler**.
1. Appelez la **create-deployment** commande pour déployer la révision de votre GitHub référentiel vers l'instance, où :
+ *repository*est le nom de votre GitHub compte, suivi d'une barre oblique (`/`), suivi du nom de votre dépôt (`CodeDeployGitHubDemo`), par exemple,. `MyGitHubUserName/CodeDeployGitHubDemo`
Si vous n'êtes pas sûr de la valeur à utiliser ou si vous souhaitez spécifier un autre référentiel :
1. Dans un onglet de navigateur Web distinct, accédez à votre [GitHub tableau de bord](https://github.com/dashboard).
1. Dans **Your repositories**, placez le pointeur de la souris sur le nom du référentiel cible. Une infobulle apparaît, affichant le nom de l' GitHub utilisateur ou de l'organisation, suivi d'une barre oblique (`/`), puis du nom du référentiel. Il s'agit de la valeur à utiliser.
**Note**
Si le nom du référentiel cible n'apparaît pas dans **Vos référentiels**, utilisez la GitHub zone de **recherche** pour trouver le référentiel cible et le nom de GitHub l'utilisateur ou de l'organisation correspondant.
+ *commit-id*est le commit associé à la version de la révision de l'application que vous avez envoyée à votre dépôt (par exemple,`f835159a...528eb76f`).
Si vous n'êtes pas sûr de la valeur à utiliser :
1. Dans un onglet de navigateur Web distinct, accédez à votre [GitHub tableau de bord](https://github.com/dashboard).
1. Dans **Your repositories**, choisissez **CodeDeployGitHubDemo**.
1. Dans la liste des validations, trouvez l'ID de validation associé au push de la révision de votre application vers GitHub. Cet ID contient généralement 40 caractères et se compose de lettres et de chiffres. (N'utilisez pas la version courte de l'ID de validation, qui correspond généralement aux 10 premiers caractères de la version longue.) Utilisez cette valeur.
Si vous travaillez sur une machine Linux, macOS ou Unix locale :
```
aws deploy create-deployment \
--application-name CodeDeployGitHubDemo-App \
--deployment-config-name CodeDeployDefault.OneAtATime \
--deployment-group-name CodeDeployGitHubDemo-DepGrp \
--description "My GitHub deployment demo" \
--github-location repository=repository,commitId=commit-id
```
Si vous travaillez sur une machine Windows locale :
```
aws deploy create-deployment --application-name CodeDeployGitHubDemo-App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name CodeDeployGitHubDemo-DepGrp --description "My GitHub deployment demo" --github-location repository=repository,commitId=commit-id
```
# Étape 7 : Surveiller et vérifier le déploiement
Au cours de cette étape, vous allez utiliser la CodeDeploy console ou le AWS CLI pour vérifier le succès du déploiement. Vous devez utiliser votre navigateur web pour afficher la page web déployée sur l'instance que vous avez créée ou configurée.
**Note**
Si vous effectuez un déploiement sur une instance Ubuntu Server, utilisez votre propre stratégie de test pour déterminer si la révision déployée fonctionne comme prévu sur l'instance, puis passez à l'étape suivante.
**Pour surveiller et vérifier le déploiement (console)**
1. Dans le volet de navigation, développez **Deploy**, puis choisissez **Deployments.**
1. **Dans la liste des déploiements, recherchez la ligne avec une valeur d'**application** de **CodeDeployGitHubDemo-App** et une valeur de **groupe de déploiement** de CodeDeployGitHubDemo -. DepGrp** Si ni **Succeeded (Réussi)**, ni **Failed (Échec)** ne figure dans la colonne **Statut**, choisissez le bouton **Actualiser** régulièrement.
1. Si **Failed (Échec)** s'affiche dans la colonne **Statut**, suivez les instructions de [Afficher les détails de l'instance (console)](instances-view-details.md#instances-view-details-console) pour dépanner le déploiement.
1. Si **Succeeded (Réussi)** s'affiche dans la colonne **Statut**, vous pouvez maintenant vérifier le déploiement via votre navigateur Web. Notre exemple de révision déploie une page Web unique sur l'instance. Si vous effectuez un déploiement sur une instance Amazon EC2, dans votre navigateur Web, accédez à `http://public-dns` l'instance (par exemple,`http://ec2-01-234-567-890.compute-1.amazonaws.com`).
1. Si vous pouvez voir la page Web, vous avez réussi la procédure. Maintenant que vous avez réussi AWS CodeDeploy à déployer une révision depuis GitHub, vous pouvez passer à[Étape 8 : nettoyer](tutorials-github-clean-up.md).
**Pour surveiller et vérifier le déploiement (interface de ligne de commande)**
1. Appelez la commande **list-deployments** pour obtenir l'ID de déploiement de l'application nommée `CodeDeployGitHubDemo-App` et le groupe de déploiement nommé `CodeDeployGitHubDemo-DepGrp` :
```
aws deploy list-deployments --application-name CodeDeployGitHubDemo-App --deployment-group-name CodeDeployGitHubDemo-DepGrp --query "deployments" --output text
```
1. Appelez la commande **get-deployment**, en fournissant l'ID du déploiement qui figure dans la sortie de la commande **list-deployments** :
```
aws deploy get-deployment --deployment-id deployment-id --query "deploymentInfo.[status, creator]" --output text
```
1. Si **Failed (Échec)** est renvoyé, suivez les instructions de [Afficher les détails de l'instance (console)](instances-view-details.md#instances-view-details-console) pour dépanner le déploiement.
1. Si **Succeeded (Réussi)** est renvoyé, vous pouvez maintenant essayer de vérifier le déploiement par le biais de votre navigateur Web. Notre exemple de révision correspond à une page Web unique déployée sur l'instance. Si vous effectuez un déploiement sur une instance Amazon EC2, vous pouvez consulter cette page dans votre navigateur Web en accédant à `http://public-dns` l'instance Amazon EC2 (par exemple,). `http://ec2-01-234-567-890.compute-1.amazonaws.com`
1. Si vous pouvez voir la page Web, vous avez réussi la procédure. Vous avez utilisé avec succès AWS CodeDeploy le déploiement à partir de votre GitHub référentiel.
# Étape 8 : nettoyer
Pour éviter des frais supplémentaires pour les ressources que vous avez utilisées au cours de ce didacticiel, vous devez mettre fin à l'instance Amazon EC2 et aux ressources associées. Éventuellement, vous pouvez supprimer les enregistrements des composants de déploiement CodeDeploy associés à ce didacticiel. Si vous utilisiez un GitHub dépôt uniquement pour ce didacticiel, vous pouvez également le supprimer maintenant.
## Pour supprimer une CloudFormation pile (si vous avez utilisé le CloudFormation modèle pour créer une instance Amazon EC2)
1. Connectez-vous à la CloudFormation console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)
1. Dans la colonne **Piles**, choisissez la pile commençant par `CodeDeploySampleStack`.
1. Sélectionnez **Delete (Supprimer)**.
1. À l'invite, choisissez **Supprimer la pile**. L'instance Amazon EC2 ainsi que le profil d'instance IAM et le rôle de service associés sont supprimés.
## Pour annuler l'inscription et nettoyer manuellement une instance sur site (si vous avez mis en service une instance sur site)
1. Utilisez la commande AWS CLI pour appeler la commande de [désenregistrement](https://docs.aws.amazon.com/cli/latest/reference/deploy/deregister.html) sur l'instance locale représentée ici par *your-instance-name* et la région associée par : *your-region*
```
aws deploy deregister --instance-name your-instance-name --no-delete-iam-user --region your-region
```
1. À partir de l'instance locale, appelez la commande de [désinstallation](https://docs.aws.amazon.com/cli/latest/reference/deploy/uninstall.html) :
```
aws deploy uninstall
```
## Pour mettre fin manuellement à une instance Amazon EC2 (si vous avez lancé manuellement une instance Amazon EC2)
1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Dans le panneau de navigation, sous **Instances**, choisissez **Instances**.
1. Cochez la case à côté de l'instance Amazon EC2 que vous souhaitez résilier. Dans le menu **Actions**, pointez sur **État de l'instance**, puis choisissez **Terminer**.
1. À l'invite, choisissez **Oui, résilier**.
## Pour supprimer les enregistrements des composants de CodeDeploy déploiement
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Dans le volet de navigation, développez **Deploy**, puis choisissez **Applications**.
1. Choisissez **CodeDeployGitHubDemo-App**.
1. Choisissez **Supprimer l'application**.
1. Lorsque vous y êtes invité, tapez **Delete**, puis choisissez **Supprimer**.
## Pour supprimer votre GitHub dépôt
Consultez [la section Suppression d'un dépôt](https://help.github.com/articles/deleting-a-repository/) dans [GitHub l'aide](https://help.github.com).