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.
Planifier une intégration AWS CodeBuild
Avant de l'utiliser AWS CodeBuild, vous devez répondre aux questions suivantes :
-
Où est stocké le code source ? CodeBuild prend actuellement en charge la création à partir des fournisseurs de référentiels de code source suivants. Le code source doit contenir un fichier de spécification de génération (buildspec). Un buildspec est un ensemble de commandes de construction et de paramètres associés, au YAML format, qui est CodeBuild utilisé pour exécuter un build. Vous pouvez déclarer une spécification de construction dans la définition d'un projet de construction.
Fournisseur du référentiel Obligatoire Documentation CodeCommit Nom du référentiel.
(Facultatif) ID de validation associé au code source.
Consultez ces rubriques dans le Guide de l'utilisateur AWS CodeCommit :
Amazon S3 Nom du compartiment d'entrée.
Nom de l'objet correspondant au ZIP fichier d'entrée de construction contenant le code source.
(Facultatif) ID de version associé au ZIP fichier d'entrée de compilation.
Consultez les rubriques suivantes dans le guide de démarrage Amazon S3 :
GitHub Nom du référentiel.
(Facultatif) ID de validation associé au code source.
Consultez cette rubrique sur le site Web GitHub d'aide :
Bitbucket Nom du référentiel.
(Facultatif) ID de validation associé au code source.
Consultez cette rubrique sur le site web de la documentation Bitbucket Cloud :
-
Quelles commandes de génération devez-vous exécuter et dans quel ordre ? Par défaut, CodeBuild télécharge l'entrée de build depuis le fournisseur que vous spécifiez et télécharge la sortie de build dans le bucket que vous spécifiez. Vous utilisez la spécification de génération pour indiquer comment transformer l'entrée de génération téléchargée en la sortie de génération attendue. Pour plus d’informations, consultez le Référence des spécifications de génération.
-
Quels sont les environnements d'exécution et les outils dont vous avez besoin pour exécuter la génération ? Par exemple, effectuez-vous une génération pour Java, Ruby, Python ou Node.js ? La génération a-t-elle besoin de Maven ou Ant, ou d'un compilateur pour Java, Ruby ou Python ? La compilation nécessite-t-elle Git AWS CLI, le ou d'autres outils ?
CodeBuild exécute des builds dans des environnements de build qui utilisent des images Docker. Ces images Docker doivent être stockées dans un type de référentiel pris en charge par CodeBuild. Il s'agit notamment du référentiel d'images CodeBuild Docker, du Docker Hub et d'Amazon Elastic Container Registry (AmazonECR). Pour plus d'informations sur le référentiel d'images CodeBuild Docker, consultezImages Docker fournies par CodeBuild.
-
Avez-vous besoin de AWS ressources qui ne sont pas fournies automatiquement par CodeBuild ? Dans l'affirmative, de quelles politiques de sécurité ces ressources ont-elles besoin ? Par exemple, vous devrez peut-être modifier le rôle CodeBuild de service CodeBuild pour autoriser l'utilisation de ces ressources.
-
Vous souhaitez CodeBuild travailler avec votre VPC ? Dans ce cas, vous avez besoin de l'VPCID, du sous-réseau IDs et du groupe de sécurité IDs pour votre VPC configuration. Pour de plus amples informations, veuillez consulter Utilisation AWS CodeBuild avec Amazon Virtual Private Cloud.
Une fois que vous avez répondu à ces questions, vous devriez disposer des paramètres et des ressources dont vous avez besoin pour exécuter une génération avec succès. Pour exécuter votre génération, vous pouvez :
-
Utilisez la AWS CodeBuild console AWS CLI, ou AWS SDKs. Pour de plus amples informations, veuillez consulter Exécuter les builds manuellement.
-
Créez ou identifiez un pipeline dans AWS CodePipeline, puis ajoutez une action de génération ou de test demandant de CodeBuild tester automatiquement votre code, d'exécuter votre build, ou les deux. Pour de plus amples informations, veuillez consulter À utiliser CodeBuild avec CodePipeline.