Intégration CodeDeploy avec GitHub

CodeDeploy supports GitHub, un service d'hébergement et de partage de code basé sur le Web. CodeDeploy peut déployer des révisions d'applications stockées dans GitHub des référentiels ou des compartiments Amazon S3 sur des instances. CodeDeploy prend en charge GitHub les déploiements EC2/sur site uniquement.

Déploiement de CodeDeploy révisions depuis GitHub

Pour déployer une révision d'application depuis un GitHub référentiel vers des instances :

1. Créez une révision compatible avec le type CodeDeploy d'instance Amazon EC2 sur lequel vous allez effectuer le déploiement.

   Pour créer une révision compatible, suivez les instructions fournies dans les rubriques Planifier une révision pour CodeDeploy et Ajouter un fichier de spécification d'application à une révision pour CodeDeploy.

2. Utilisez un GitHub compte pour ajouter votre révision à un GitHub dépôt.

   Pour créer un GitHub compte, consultez la section S'inscrire GitHub. Pour créer un GitHub dépôt, voir Créer un dépôt.

3. Utilisez la page Créer un déploiement de la CodeDeploy console ou la AWS CLI create-deployment commande pour déployer votre révision depuis votre GitHub référentiel vers des instances cibles configurées pour être utilisées dans CodeDeploy des déploiements.

   Si vous souhaitez appeler la create-deployment commande, vous devez d'abord utiliser la page Créer un déploiement de la console pour CodeDeploy autoriser l'interaction avec GitHub l'application spécifiée au nom de votre GitHub compte préféré. Cette opération ne doit être effectuée qu'une seule fois par application.

   Pour savoir comment utiliser la page Créer un déploiement pour effectuer un déploiement à partir d'un GitHub référentiel, consultezCréez un déploiement avec CodeDeploy.

   Pour savoir comment appeler la create-deployment commande de déploiement à partir d'un GitHub référentiel, consultezCréation d'un déploiement de plate-forme de calcul EC2/sur site (CLI).

   Pour savoir comment préparer des instances en vue de leur utilisation dans les CodeDeploy déploiements, consultezUtilisation d'instances pour CodeDeploy.

Pour plus d’informations, consultez Tutoriel : CodeDeploy À utiliser pour déployer une application depuis GitHub.

GitHub comportements avec CodeDeploy

Rubriques

• GitHub authentification avec des applications dans CodeDeploy
• CodeDeploy interaction avec les GitHub référentiels privés et publics
• CodeDeploy interaction avec les référentiels gérés par l'organisation GitHub
• Déployez automatiquement à partir CodePipeline de CodeDeploy

GitHub authentification avec des applications dans CodeDeploy

Une fois que vous avez donné CodeDeploy l'autorisation d'interagir avec GitHub, l'association entre ce GitHub compte et l'application est stockée dans CodeDeploy. Vous pouvez associer l'application à un autre GitHub compte. Vous pouvez également révoquer l'autorisation CodeDeploy d'interagir avec GitHub.

Pour associer un GitHub compte à une application dans CodeDeploy

1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/codedeploy.

   Note

   Connectez-vous avec le même utilisateur que celui que vous avez configuréCommencer avec CodeDeploy.

2. Dans le volet de navigation, développez Deploy, puis choisissez Applications.

3. Choisissez l'application que vous souhaitez associer à un autre GitHub compte.

4. Si votre application ne possède pas de groupe de déploiement, choisissez Créer un groupe de déploiement pour en créer un. Pour plus d’informations, consultez Créez un groupe de déploiement avec CodeDeploy. Un groupe de déploiement est nécessaire pour pouvoir choisir Créer un déploiement dans l'étape suivante.

5. Dans Déploiements, choisissez Créer un déploiement.

   Note

   Vous n'avez pas à créer un nouveau déploiement. C'est actuellement le seul moyen de lier un autre GitHub compte à une application.

6. Dans Paramètres de déploiement, pour Type de révision, choisissez Mon application est stockée dans GitHub.

7. Effectuez l’une des actions suivantes :

   • Pour créer une connexion entre AWS CodeDeploy les applications et un GitHub compte, déconnectez-vous GitHub dans un onglet de navigateur Web distinct. Dans Nom du GitHub jeton, tapez un nom pour identifier cette connexion, puis choisissez Connect to GitHub. La page Web vous invite CodeDeploy à autoriser l'interaction avec GitHub votre application. Passez à l'étape 10.

   • Pour utiliser une connexion que vous avez déjà créée, dans Nom du GitHub jeton, sélectionnez son nom, puis choisissez Connect to GitHub. Passez à l'étape 8.

   • Pour créer une connexion à un autre GitHub compte, déconnectez-vous GitHub dans un onglet de navigateur Web distinct. Dans Nom du GitHub jeton, tapez un nom pour identifier la connexion, puis choisissez Connect to GitHub. La page Web vous invite CodeDeploy à autoriser l'interaction avec GitHub votre application. Passez à l'étape 10.

8. Si vous n'êtes pas encore connecté GitHub, suivez les instructions de la page de connexion pour vous connecter avec le GitHub compte auquel vous souhaitez associer l'application.

9. Choisissez Autoriser l'application. GitHub donne CodeDeploy l'autorisation d'interagir avec GitHub l'application sélectionnée au nom du GitHub compte connecté.

10. Si vous ne souhaitez pas créer de déploiement, choisissez Annuler.

Pour révoquer l'autorisation CodeDeploy d'interagir avec GitHub

1. Connectez-vous à GitHub l'aide des informations d'identification du GitHub compte pour lequel vous souhaitez révoquer AWS CodeDeploy l'autorisation.

2. Ouvrez la page GitHub Applications, CodeDeploylocalisez-la dans la liste des applications autorisées, puis suivez la GitHub procédure de révocation de l'autorisation d'une application.

CodeDeploy interaction avec les GitHub référentiels privés et publics

CodeDeploy prend en charge le déploiement d'applications à partir de GitHub référentiels privés et publics. Lorsque vous CodeDeploy autorisez l'accès en votre GitHub nom, vous CodeDeploy aurez un accès en lecture-écriture à tous les GitHub référentiels privés auxquels votre GitHub compte a accès. Cependant, CodeDeploy seules les lectures se trouvent dans GitHub les référentiels. Il n'écrira dans aucun de vos GitHub dépôts privés.

CodeDeploy interaction avec les référentiels gérés par l'organisation GitHub

Par défaut, GitHub les référentiels gérés par une organisation (par opposition aux référentiels privés ou publics de votre compte) n'accordent pas l'accès aux applications tierces, notamment. CodeDeploy Votre déploiement échouera si les restrictions relatives aux applications tierces d'une organisation sont activées GitHub et que vous tentez de déployer du code depuis son GitHub référentiel. Il existe deux façons de résoudre ce problème.

• En tant que membre de l'organisation, vous pouvez demander au propriétaire de l'organisation d'approuver l'accès à CodeDeploy. Les étapes à suivre pour demander cet accès varient selon que vous avez déjà autorisé CodeDeploy ou non votre compte individuel :

  • Si vous avez un accès autorisé CodeDeploy à votre compte, consultez la section Demander l'approbation de l'organisation pour vos applications autorisées.

  • Si vous n'êtes pas encore autorisé à accéder CodeDeploy à votre compte, consultez la section Demande d'approbation de l'organisation pour les applications tierces.

• Le propriétaire de l'organisation peut désactiver toutes les restrictions d'application tierce pour l'organisation. Pour plus d'informations, consultez la section Désactivation des restrictions relatives aux applications tierces pour votre organisation.

Pour plus d'informations, voir À propos des restrictions relatives aux applications tierces.

Déployez automatiquement à partir CodePipeline de CodeDeploy

Vous pouvez déclencher un déploiement à partir de CodePipeline chaque fois que le code source change. Pour plus d'informations, consultez CodePipeline.