Utilisation d'AWS CodeBuild avec Jenkins

Vous pouvez utiliser le plugin Jenkins pourAWS CodeBuild l'intégrer CodeBuild à vos tâches de construction Jenkins. Au lieu d'envoyer les tâches de génération aux nœuds de génération Jenkins, vous utilisez le plug-in pour envoyer vos tâches de génération à CodeBuild. Vous n'avez ainsi plus besoin d'allouer, de configurer et de gérer des nœuds de génération Jenkins.

Configuration de Jenkins

Pour plus d'informations sur la configuration de Jenkins avec leAWS CodeBuild plugin et pour télécharger le code source du plugin, consultez https://github.com/awslabs/aws-codebuild-jenkins-plugin.

Installation du plug-in

Si Jenkins est déjà configuré et que vous souhaitez uniquement installer le plug-in AWS CodeBuild, accédez à votre instance Jenkins, puis dans le gestionnaire de plug-in, recherchez CodeBuild Plugin for Jenkins.

Utilisation du plug-in

Pour utiliser AWS CodeBuild avec des sources depuis l'extérieur d'un VPC

1. Créez un projet dans la CodeBuild console. Pour plus d'informations, veuillez consulter Création d'un projet de génération (console).

   • Spécifiez laAWS région sur laquelle exécuter la génération.

   • (Facultatif) Définissez la configuration Amazon VPC pour permettre au conteneur de CodeBuild génération d'accéder aux ressources de votre VPC.

   • Notez le nom de votre projet. Vous en aurez besoin à l'étape 3.

   • (Facultatif) Si votre référentiel source n'est pas pris en charge de manière native par CodeBuild, vous pouvez définir Amazon S3 comme type de source d'entrée pour votre projet.

2. Dans la console IAMConsole, créez un utilisateur à utiliser par le plugin Jenkins.

   • Lorsque vous créez des informations d'identification pour l'utilisateur, choisissez Programmatic Access (Accès par programmation).

   • Créez une stratégie similaire à ce qui suit, puis attachez la stratégie à votre utilisateur.

     {
       "Version": "2012-10-17",
       "Statement": [
         {
           "Effect": "Allow",
           "Resource": ["arn:aws:logs:{{region}}:{{awsAccountId}}:log-group:/aws/codebuild/{{projectName}}:*"],
           "Action": ["logs:GetLogEvents"]
         },
         {
           "Effect": "Allow",
           "Resource": ["arn:aws:s3:::{{inputBucket}}"],
           "Action": ["s3:GetBucketVersioning"]
         },
         {
           "Effect": "Allow",
           "Resource": ["arn:aws:s3:::{{inputBucket}}/{{inputObject}}"],
           "Action": ["s3:PutObject"]
         },
         {
           "Effect": "Allow",
           "Resource": ["arn:aws:s3:::{{outputBucket}}/*"],
           "Action": ["s3:GetObject"]
         },
         {
           "Effect": "Allow",
           "Resource": ["arn:aws:codebuild:{{region}}:{{awsAccountId}}:project/{{projectName}}"],
           "Action": ["codebuild:StartBuild",
             "codebuild:BatchGetBuilds",
             "codebuild:BatchGetProjects"]
         }
       ]
     }

3. Créez un projet freestyle dans Jenkins.

   • Sur la page Configure (Configurer), choisissez Add build step (Ajouter une étape de génération), puis choisissez Run build on CodeBuild (Exécuter la génération sur &ACB;).

   • Configurez votre étape de génération.

     • Fournissez des valeurs pour Region (Région), Credentials (Informations d'identification) et Project Name (Nom du projet).

     • Choisissez Use Project source (Utiliser la source de projet).

     • Enregistrez la configuration et exécutez une génération à partir de Jenkins.

4. Pour Source Code Management (Gestion de code source), choisissez la façon dont vous souhaitez récupérer votre source. Il se peut que vous deviez installer le GitHub plugin (ou le plugin Jenkins pour votre fournisseur de référentiel source) sur votre serveur Jenkins.

   • Sur la page Configure (Configurer), choisissez Add build step (Ajouter une étape de génération), puis choisissez Run build on AWS CodeBuild (Exécuter la génération sur &ACB;).

   • Configurez votre étape de génération.

     • Fournissez des valeurs pour Region (Région), Credentials (Informations d'identification) et Project Name (Nom du projet).

     • Choisissez Use Jenkins source (Utiliser la source Jenkins).

     • Enregistrez la configuration et exécutez une génération à partir de Jenkins.

Pour utiliser le plug-in AWS CodeBuild avec le plug-in de pipeline Jenkins

• Sur la page de votre projet de pipeline Jenkins, utilisez le générateur d'extraits pour générer un script de pipeline qui s'ajoute en CodeBuild tant qu'étape à votre pipeline. Cela doit générer un script semblable à ce qui suit :

  awsCodeBuild projectName: 'project', credentialsType: 'keys', region: 'us-west-2', sourceControlType: 'jenkins'