翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Jenkins AWS CodeBuild で を使用する
<a name="jenkins-plugin"></a>

の Jenkins プラグインを使用して AWS CodeBuild 、CodeBuild を Jenkins ビルドジョブと統合できます。Jenkins ビルドノードにビルドジョブを送信する代わりに、プラグインを使用してビルドジョブを CodeBuild に送信します。これにより、Jenkins ビルドノードのプロビジョニング、設定、および管理が不要になります。

**Topics**
+ [Jenkins の設定](#setup-jenkins)
+ [プラグインをインストールする](#plugin-installation)
+ [プラグインを使用](#plugin-usage)

## Jenkins の設定
<a name="setup-jenkins"></a>

 AWS CodeBuild プラグインで Jenkins を設定する方法と、プラグインのソースコードをダウンロードする方法については、[https://github.com/awslabs/aws-codebuild-jenkins-plugin ](https://github.com/awslabs/aws-codebuild-jenkins-plugin)を参照してください。

## プラグインをインストールする
<a name="plugin-installation"></a>

Jenkins サーバーをセットアップ済みで、 AWS CodeBuild プラグインのみをインストールする場合は、Jenkins インスタンスの Plugin Manager で **CodeBuild Plugin for Jenkins** を検索します。

## プラグインを使用
<a name="plugin-usage"></a><a name="source-available-outside-of-your-vpc"></a>

**VPC の外部からのソース AWS CodeBuild で を使用するには**

1. CodeBuild コンソールでプロジェクトを作成します。詳細については、「[ビルドプロジェクトの作成 (コンソール)](create-project.md#create-project-console)」を参照してください。
   + ビルドを実行する AWS リージョンを選択します。
   + (オプション) CodeBuild ビルドコンテナによる VPC のリソースへのアクセスを許可するように Amazon VPC 設定を指定します。
   + プロジェクトの名前を書き留めます。これはステップ 3 で必要になります。
   + (オプション) ソースリポジトリが CodeBuild でネイティブにサポートされていない場合は、プロジェクトの入力ソースタイプとして Amazon S3 を設定できます。

1. IAM コンソールで、Jenkins プラグインで使用するユーザーを作成します。
   + ユーザーの認証情報を作成するときに、[**Programmatic Access (プログラムによるアクセス)**] を選択します。
   + 次のようなポリシーを作成し、このポリシーをユーザーにアタッチします。

------
#### [ JSON ]

****  

     ```
     {
         "Version":"2012-10-17",		 	 	 
         "Statement": [
             {
                 "Effect": "Allow",
                 "Resource": [
                     "arn:aws:logs:us-east-1:111122223333: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:us-east-1:111122223333:project/{{projectName}}"
                 ],
                 "Action": [
                     "codebuild:StartBuild",
                     "codebuild:BatchGetBuilds",
                     "codebuild:BatchGetProjects"
                 ]
             }
         ]
     }
     ```

------

1. Jenkins で自由形式のプロジェクトを作成します。
   + **[Configure]** (設定) ページで、**[Add build step]** (ビルドステップの追加)、**[Run build on CodeBuild]** (CodeBuild でビルドを実行) を選択します。
   + ビルドステップを設定します。
     + [**Region (リージョン)**]、[**Credentials (認証情報)**]、および [**Project Name (プロジェクト名)**] の値を入力します。
     + [**Use Project source (プロジェクトソースを使用)**] を選択します。
     + 設定を保存し、Jenkins からビルドを実行します。

1. [**Source Code Management (ソースコードの管理)**] で、ソースの取得方法を選択します。Jenkins サーバーでの GitHub プラグイン (またはソースリポジトリプロバイダ用の Jenkins プラグイン) のインストールが必要になる場合があります。
   + [**設定**] ページで、[**ビルドステップの追加**] を選択し、[** AWS CodeBuildでビルドを実行**] を選択します。
   + ビルドステップを設定します。
     + [**Region (リージョン)**]、[**Credentials (認証情報)**]、および [**Project Name (プロジェクト名)**] の値を入力します。
     + [**Use Jenkins source (Jenkins ソースを使用)**] を選択します。
     + 設定を保存し、Jenkins からビルドを実行します。<a name="jenkins-pipeline-plugin"></a>

**Jenkins パイプライン AWS CodeBuild プラグインでプラグインを使用するには**
+ Jenkins パイプラインプロジェクトページで、スニペットジェネレーターを使用して、パイプラインにステップとして CodeBuild を追加するパイプラインスクリプトを生成します。次のようなスクリプトが生成されます。

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