CodeBuild の開始方法

1. ローカルコンピュータまたはインスタンスの空のディレクトリに、このディレクトリ構造を作成します。

   (root directory name)
       `-- src
            |-- main
            |     `-- java
            `-- test
                  `-- java

2. 任意のテキストエディタを使用して、このファイルを作成し、MessageUtil.java という名前を付けて、src/main/java ディレクトリに保存します。

   public class MessageUtil {
     private String message;
   
     public MessageUtil(String message) {
       this.message = message;
     }
   
     public String printMessage() {
       System.out.println(message);
       return message;
     }
   
     public String salutationMessage() {
       message = "Hi!" + message;
       System.out.println(message);
       return message;
     }
   }

   このクラスファイルは、渡された文字列を出力として作成します。MessageUtil コンストラクタは、文字列を設定します。printMessage メソッドは出力を作成します。salutationMessage メソッドが Hi! を出力した後に文字列が続きます。

3. このファイルを作成し、TestMessageUtil.java という名前を付けて、/src/test/java ディレクトリに保存します。

   import org.junit.Test;
   import org.junit.Ignore;
   import static org.junit.Assert.assertEquals;
   
   public class TestMessageUtil {
   
     String message = "Robert";    
     MessageUtil messageUtil = new MessageUtil(message);
      
     @Test
     public void testPrintMessage() {      
       System.out.println("Inside testPrintMessage()");     
       assertEquals(message,messageUtil.printMessage());
     }
   
     @Test
     public void testSalutationMessage() {
       System.out.println("Inside testSalutationMessage()");
       message = "Hi!" + "Robert";
       assertEquals(message,messageUtil.salutationMessage());
     }
   }

   このクラスファイルは message クラスの MessageUtil 変数を Robert に設定します。その後、文字列 message および Robert が出力に表示されているかどうかを調べることによって、Hi!Robert 変数が正常に設定されたかどうかを調べます。

4. このファイルを作成し、pom.xml という名前を付けて、ルート (最上位) ディレクトリに保存します。

   <project xmlns="http://maven.apache.org/POM/4.0.0" 
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.example</groupId>
     <artifactId>messageUtil</artifactId>
     <version>1.0</version>
     <packaging>jar</packaging>
     <name>Message Utility Java Sample App</name>
     <dependencies>
       <dependency>
         <groupId>junit</groupId>
         <artifactId>junit</artifactId>
         <version>4.11</version>
         <scope>test</scope>
       </dependency>	
     </dependencies>
     <build>
       <plugins>
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-compiler-plugin</artifactId>
           <version>3.8.0</version>
         </plugin>
       </plugins>
     </build>
   </project>

   Apache Maven では、このファイルの指示に従って、MessageUtil.java および TestMessageUtil.java ファイルを messageUtil-1.0.jar という名前のファイルに変換し、指定されたテストを実行します。

ビルドプロジェクトを作成するには

1. にサインイン AWS Management Console し、https://console.aws.amazon.com/codesuite/codebuild/home で AWS CodeBuild コンソールを開きます。

2. AWS リージョンセレクタを使用して、CodeBuild がサポートされている AWS リージョンを選択します。詳細については、「Amazon Web Services 全般のリファレンス」の「AWS CodeBuild エンドポイントとクォータ」を参照してください。

3. CodeBuild の情報ページが表示された場合、ビルドプロジェクトを作成するを選択します。それ以外の場合は、ナビゲーションペインでビルドを展開し、[ビルドプロジェクト] を選択し、次に [Create build project (ビルドプロジェクトの作成)] を選択します。

4. [Create build project (ビルドプロジェクトの作成)] ページで、[Project configuration (プロジェクト設定)] の [プロジェクト名] にこのビルドプロジェクトの名前を入力します (この例では、codebuild-demo-project)。ビルドプロジェクト名は、 AWS アカウントごとに一意である必要があります。別の名前を選択した場合は、このチュートリアル全体でその名前を使用してください。

   注記

   [Create build project (ビルドプロジェクトの作成)] ページに「このオペレーションを実行する権限がありません」というようなエラーメッセージが表示される場合があります。これは、多くの場合、ビルドプロジェクトを作成するアクセス許可を持たない ユーザー AWS Management Console として にサインインしたためです。これを修正するには、 からサインアウトし AWS Management Console、次のいずれかの IAM エンティティに属する認証情報でサインインし直します。

   • AWS アカウントの管理者ユーザー。詳細については、「 ユーザーガイド」の「最初の AWS アカウント ルートユーザーとグループの作成」を参照してください。

   • 、AWSCodeBuildAdminAccess、および IAMFullAccess管理ポリシーがアタッチされた AWS アカウントの ユーザーAmazonS3ReadOnlyAccess、またはユーザーが属する IAM グループ。これらのアクセス許可を持つ ユーザーまたはグループが AWS アカウントになく、これらのアクセス許可をユーザーまたはグループに追加できない場合は、 AWS アカウント管理者にお問い合わせください。詳細については、「AWS の 管理 (事前定義) ポリシー AWS CodeBuild」を参照してください。

   どちらのオプションにも、このチュートリアルを完了できるように、ビルドプロジェクトの作成を許可する管理者権限が含まれています。常に必要最小限のアクセス許可を使用してタスクを達成してください。詳細については、「AWS CodeBuild アクセス許可リファレンス」を参照してください。

5. [Source] (ソース) で、[Source provider] (ソースプロバイダー) として [Amazon S3] を選択します。

6. [Bucket] (バケット) として、[codebuild-region-ID-account-ID-input-bucket] を選択します。

7. [S3 オブジェクトキー] に「MessageUtil.zip」と入力します。

8. [環境] の [環境イメージ] で、[Managed image (マネージド型イメージ)] を選択したままにしておきます。

9. [オペレーティングシステム] で、[Amazon Linux] を選択します。

10. [ランタイム] で、[Standard (標準)] を選択します。

11. イメージ で、aws/codebuild/amazonlinux-x86_64-standard:corretto11 を選択します。

12. [サービスロール] で、[New service role (新しいサービスロール)] は選択したままにして、[Role name (ロール名)] は変更しません。

13. [Buildspec] で、[Use a buildspec file (buildspec ファイルを使用)] を選択したままにしておきます。

14. [Artifacts] (アーティファクト) で、[Type] (タイプ) として [Amazon S3] を選択します。

15. [Bucket name] (バケット名) として、[codebuild-region-ID-account-ID-output-bucket] を選択します。

16. ​[名前] と [パス] を空白のままにします。

17. [Create build project (ビルドプロジェクトの作成)] を選択します。

ビルドを実行するには

1. https://console.aws.amazon.com/codesuite/codebuild/home で AWS CodeBuild コンソールを開きます。

2. ナビゲーションペインで、[Build projects] を選択します。

3. ビルドプロジェクトのリストで、[codebuild-demo-project]、[Start build] (ビルドの開始) の順に選択します。ビルドがすぐに開始されます。

1. [codebuild-demo-project:<build-ID>] ページが表示されない場合は、ナビゲーションバーで [Build history] (ビルド履歴) を選択します。次にビルドプロジェクトのリストで、[Project] (プロジェクト) の [codebuild-demo-project] に対応する [Build run] (ビルドの実行) リンクを選択します。一致するリンクは 1 つだけです。（このチュートリアルを完了したことがある場合は、[完了済み] 列で最新の値のリンクを選択します。）

2. [Build status] (ビルドステータス) ページの [Phase details] (フェーズ詳細) に以下のビルドフェーズが表示され、[Status] (ステータス) 列に [Succeeded] (成功) と示されます。

   • SUBMITTED

   • QUEUED

   • PROVISIONING

   • DOWNLOAD_SOURCE

   • INSTALL

   • PRE_BUILD

   • BUILD

   • POST_BUILD

   • UPLOAD_ARTIFACTS

   • FINALIZING

   • COMPLETED

   [ビルドステータス] で、[Succeeded (成功)] が表示されます。

   代わりに [進行中] と表示される場合は、更新ボタンを選択します。

3. 各ビルドフェーズの横に表示される [所要時間] 値は、ビルドフェーズの所要時間を示します。[終了時間] 値は、ビルドフェーズの完了日時を示します。

詳細なビルド情報を表示するには

1. ビルドの詳細ページが前のステップから引き続き表示された状態で、ビルドログの最後の 10,000 行が [Build logs] に表示されます。CloudWatch Logs でビルドログ全体を表示するには、[View entire log] (ログ全体の表示) リンクを選択します。

2. CloudWatch Logs ログストリームでは、ログイベントを参照できます。デフォルトでは、ログイベントの最後のセットだけが表示されます。以前のログイベントを表示するには、リストの先頭にスクロールします。

3. このチュートリアルでは、ほとんどのログイベントに、CodeBuild でビルド依存ファイルをビルド環境にダウンロードおよびインストールする操作に関する詳細情報が含まれますが、これらの情報は不要な場合があります。[Filter events] ボックスを使用すると、表示する情報量を減らすことができます。例えば、[Filter events] (イベントのフィルター) で「"[INFO]"」と入力した場合、「[INFO]」を含むイベントのみが表示されます。詳細については、Amazon CloudWatch ユーザーガイドの「フィルターとパターンの構文」を参照してください。

ビルド出力アーティファクトを取得するには (AWS CodeBuild コンソール）

1. CodeBuild コンソールが開いていて、ビルドの詳細ページが前のステップから引き続き表示されている状態で、[Build details] を選択して [Artifacts] セクションまでスクロールします。

   注記

   ビルドの詳細ページが表示されていない場合は、ナビゲーションバーで [Build history] (ビルド履歴)、[Build run] (ビルドの実行) リンクの順に選択します。

2. Amazon S3 フォルダへのリンクは、[Artifacts upload location] (アーティファクトのアップロード場所) の下にあります。Amazon S3 内のフォルダが開き、「messageUtil-1.0.jar」という名前のビルド出力アーティファクトファイルを見つけます。

ビルド出力アーティファクトを取得するには (Amazon S3 コンソール)

1. https://console.aws.amazon.com/s3/ で Amazon S3 コンソールを開きます。

2. codebuild-region-ID-account-ID-output-bucket を開きます。

3. codebuild-demo-project フォルダを開きます。

4. target という名前のフォルダを開き、messageUtil-1.0.jar という名前のビルド出力アーティファクトファイルを見つけます。

1. ローカルコンピュータまたはインスタンスの空のディレクトリに、このディレクトリ構造を作成します。

   (root directory name)
       `-- src
            |-- main
            |     `-- java
            `-- test
                  `-- java

2. 任意のテキストエディタを使用して、このファイルを作成し、MessageUtil.java という名前を付けて、src/main/java ディレクトリに保存します。

   public class MessageUtil {
     private String message;
   
     public MessageUtil(String message) {
       this.message = message;
     }
   
     public String printMessage() {
       System.out.println(message);
       return message;
     }
   
     public String salutationMessage() {
       message = "Hi!" + message;
       System.out.println(message);
       return message;
     }
   }

   このクラスファイルは、渡された文字列を出力として作成します。MessageUtil コンストラクタは、文字列を設定します。printMessage メソッドは出力を作成します。salutationMessage メソッドが Hi! を出力した後に文字列が続きます。

3. このファイルを作成し、TestMessageUtil.java という名前を付けて、/src/test/java ディレクトリに保存します。

   import org.junit.Test;
   import org.junit.Ignore;
   import static org.junit.Assert.assertEquals;
   
   public class TestMessageUtil {
   
     String message = "Robert";    
     MessageUtil messageUtil = new MessageUtil(message);
      
     @Test
     public void testPrintMessage() {      
       System.out.println("Inside testPrintMessage()");     
       assertEquals(message,messageUtil.printMessage());
     }
   
     @Test
     public void testSalutationMessage() {
       System.out.println("Inside testSalutationMessage()");
       message = "Hi!" + "Robert";
       assertEquals(message,messageUtil.salutationMessage());
     }
   }

   このクラスファイルは message クラスの MessageUtil 変数を Robert に設定します。その後、文字列 message および Robert が出力に表示されているかどうかを調べることによって、Hi!Robert 変数が正常に設定されたかどうかを調べます。

4. このファイルを作成し、pom.xml という名前を付けて、ルート (最上位) ディレクトリに保存します。

   <project xmlns="http://maven.apache.org/POM/4.0.0" 
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.example</groupId>
     <artifactId>messageUtil</artifactId>
     <version>1.0</version>
     <packaging>jar</packaging>
     <name>Message Utility Java Sample App</name>
     <dependencies>
       <dependency>
         <groupId>junit</groupId>
         <artifactId>junit</artifactId>
         <version>4.11</version>
         <scope>test</scope>
       </dependency>	
     </dependencies>
     <build>
       <plugins>
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-compiler-plugin</artifactId>
           <version>3.8.0</version>
         </plugin>
       </plugins>
     </build>
   </project>

   Apache Maven では、このファイルの指示に従って、MessageUtil.java および TestMessageUtil.java ファイルを messageUtil-1.0.jar という名前のファイルに変換し、指定されたテストを実行します。

ビルドプロジェクトを作成するには

1. を使用して create-project コマンド AWS CLI を実行します。

   aws codebuild create-project --generate-cli-skeleton

   JSON 形式のデータが出力に表示されます。 AWS CLI がインストールされているローカルコンピュータまたはインスタンス上の場所create-project.jsonにある という名前のファイルにデータをコピーします。別のファイル名を使用する場合は、このチュートリアル全体でそのファイル名を使用してください。

   コピーされたデータをこの形式に従って変更して、結果を保存します。

   {
     "name": "codebuild-demo-project",
     "source": {
       "type": "S3",
       "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip"
     },
     "artifacts": {
       "type": "S3",
       "location": "codebuild-region-ID-account-ID-output-bucket"
     },
     "environment": {
       "type": "LINUX_CONTAINER",
       "image": "aws/codebuild/standard:5.0",
       "computeType": "BUILD_GENERAL1_SMALL"
     },
     "serviceRole": "serviceIAMRole"
   }

   serviceIAMRole を、CodeBuild サービスロールの Amazon リソースネーム (ARN) (例: arn:aws:iam::account-ID:role/role-name) に置き換えます。サービスロールを作成する場合は、「CodeBuild が他の AWS のサービスとやり取りすることを許可」を参照してください。

   このデータの各要素は以下のとおりです。

   • name は、このビルドプロジェクト (この例では codebuild-demo-project) に必要な識別子を表します。ビルドプロジェクト名は、アカウント内のすべてのビルドプロジェクト間で一意である必要があります。

   • source の場合、type はソースコードのリポジトリのタイプを表す必須の値です (この例では、Amazon S3 バケットの場合は S3)。

   • source の場合、location は、ソースコードへのパスを表します (この例では、入力バケット名の後に ZIP ファイル名が続きます)。

   • artifacts の場合、type は、ビルド出力アーティファクトのリポジトリのタイプを表す必須の値です (この例では、Amazon S3 バケットの場合は S3)。

   • artifacts の場合、location は、以前に作成または識別した出力バケットの名前を表します (この例では、codebuild-region-ID-account-ID-output-bucket)。

   • environment を使用する場合、type はビルド環境のタイプを表す必須の値です (この例では LINUX_CONTAINER)。

   • environment の場合、image は、Docker イメージリポジトリタイプで指定された、このビルドプロジェクトが使用する Docker イメージ名とタグの組み合わせを表す必須の値です (この例では、aws/codebuild/standard:5.0 Docker イメージリポジトリ内の Docker イメージの場合は aws/codebuild/standard)。CodeBuild は、Docker イメージの名前です。5.0 は、Docker イメージのタグです。

     シナリオで使用できる Docker イメージをさらに見つけるには、「ビルド環境に関するリファレンス」を参照してください。

   • environment の場合、computeType は、CodeBuild が使用するコンピューティングリソース (この例では BUILD_GENERAL1_SMALL) を表す必須の値です。

   注記

   description、buildspec、auth (type と resource を含む)、path、namespaceType、name (artifacts)、packaging、environmentVariables (name と value を含む)、timeoutInMinutes、encryptionKey、tags (key と value を含む) などの元の JSON 形式のデータで使用可能なその他の値はオプションです。これらは、このチュートリアルで使用されていないため、ここには示されていません。詳細については、「ビルドプロジェクトの作成 (AWS CLI)」を参照してください。

2. 保存したばかりのファイルがあるディレクトリに移動してから、create-project コマンドをもう一度実行します。

   aws codebuild create-project --cli-input-json file://create-project.json

   成功した場合、次のようなデータが出力に表示されます。

   {
     "project": {
       "name": "codebuild-demo-project",
       "serviceRole": "serviceIAMRole",
       "tags": [],
       "artifacts": {
         "packaging": "NONE",
         "type": "S3",
         "location": "codebuild-region-ID-account-ID-output-bucket",
         "name": "message-util.zip"
       },
       "lastModified": 1472661575.244,
       "timeoutInMinutes": 60,
       "created": 1472661575.244,
       "environment": {
         "computeType": "BUILD_GENERAL1_SMALL",
         "image": "aws/codebuild/standard:5.0",
         "type": "LINUX_CONTAINER",
         "environmentVariables": []
       },
       "source": {
         "type": "S3",
         "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip"
       },
       "encryptionKey": "arn:aws:kms:region-ID:account-ID:alias/aws/s3",
       "arn": "arn:aws:codebuild:region-ID:account-ID:project/codebuild-demo-project"
     }
   }

   • project は、このビルドプロジェクトに関する情報を表します。

     • tags は、宣言されたタグを表します。

     • packaging は、ビルド出力アーティファクトが出力バケットに保存される方法を表します。NONE は、出力バケット内にフォルダが作成されることを意味します。ビルド出力アーティファクトはそのフォルダ内に格納されます。

     • lastModified は、ビルドプロジェクトに関する情報が最後に変更された時刻 (Unix の時間形式) を表します。

     • timeoutInMinutes は、ビルドが完了していない場合、CodeBuild がビルドを停止するまでの時間 (分) を表します。(デフォルトは 60 分です。)

     • created は、ビルドプロジェクトが作成された時刻 (Unix の時間形式) を表します。

     • environmentVariables は、CodeBuild がビルド中に使用するために宣言されて、使用可能な環境変数を表します。

     • encryptionKey は、CodeBuild がビルド出力アーティファクトの暗号化に使用したカスタマー管理キーの ARN を表します。

     • arn は、ビルドプロジェクトの ARN を表します。

ビルドを実行するには

1. を使用して start-build コマンド AWS CLI を実行します。

   aws codebuild start-build --project-name project-name

   project-name を、前の手順のビルドプロジェクト名 (例: codebuild-demo-project) に置き換えます。

2. 成功すると、次のようなデータが出力に表示されます。

   {
     "build": { 
       "buildComplete": false,
       "initiator": "user-name",   
       "artifacts": { 
         "location": "arn:aws:s3:::codebuild-region-ID-account-ID-output-bucket/message-util.zip"
       },
       "projectName": "codebuild-demo-project",
       "timeoutInMinutes": 60, 
       "buildStatus": "IN_PROGRESS",
       "environment": {
         "computeType": "BUILD_GENERAL1_SMALL",
         "image": "aws/codebuild/standard:5.0",
         "type": "LINUX_CONTAINER",
         "environmentVariables": []
       },
       "source": {
         "type": "S3",
         "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip"
       },
       "currentPhase": "SUBMITTED",
       "startTime": 1472848787.882,
       "id": "codebuild-demo-project:0cfbb6ec-3db9-4e8c-992b-1ab28EXAMPLE",
       "arn": "arn:aws:codebuild:region-ID:account-ID:build/codebuild-demo-project:0cfbb6ec-3db9-4e8c-992b-1ab28EXAMPLE"    
     }
   }

   • build は、このビルドに関する情報を表します。

     • buildComplete は、ビルドの完了 () を表します。trueそうでない場合は、false です。

     • initiator は、ビルドを開始したエンティティを表します。

     • artifacts は、場所を含む、ビルド出力に関する情報を表します。

     • projectName は、ビルドプロジェクトの名前を表します。

     • buildStatus は、start-build コマンドが実行されたときの現在のビルドのステータスを表します。

     • currentPhase は、start-build コマンドが実行されたときの現在のビルドフェーズを表します。

     • startTime は、ビルドプロセスが開始された時刻 (Unix の時間形式) を表します。

     • id は、ビルドの ID を表します。

     • arn は、ビルドの ARN を表します。

   [id] の値を書き留めておきます。それは次の手順で必要となります。

要約されたビルド情報を表示するには

• を使用して batch-get-builds コマンド AWS CLI を実行します。

  aws codebuild batch-get-builds --ids id

  id を、前のステップの出力に表示された id 値に置き換えます。

  成功した場合、次のようなデータが出力に表示されます。

  {
    "buildsNotFound": [],
    "builds": [
      {
        "buildComplete": true,
        "phases": [
          {
            "phaseStatus": "SUCCEEDED",
            "endTime": 1472848788.525,
            "phaseType": "SUBMITTED",
            "durationInSeconds": 0,
            "startTime": 1472848787.882
          },
          ... The full list of build phases has been omitted for brevity ...
          {
            "phaseType": "COMPLETED",
            "startTime": 1472848878.079
          }
        ],
        "logs": {
          "groupName": "/aws/codebuild/codebuild-demo-project",
          "deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=region-ID#logEvent:group=/aws/codebuild/codebuild-demo-project;stream=38ca1c4a-e9ca-4dbc-bef1-d52bfEXAMPLE",
          "streamName": "38ca1c4a-e9ca-4dbc-bef1-d52bfEXAMPLE"
        },
        "artifacts": {
          "md5sum": "MD5-hash",
          "location": "arn:aws:s3:::codebuild-region-ID-account-ID-output-bucket/message-util.zip",
          "sha256sum": "SHA-256-hash"
        },
        "projectName": "codebuild-demo-project",
        "timeoutInMinutes": 60,
        "initiator": "user-name",
        "buildStatus": "SUCCEEDED",
        "environment": {
          "computeType": "BUILD_GENERAL1_SMALL",
          "image": "aws/codebuild/standard:5.0",
          "type": "LINUX_CONTAINER",
          "environmentVariables": []
        },
        "source": {
          "type": "S3",
          "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip"
        },
        "currentPhase": "COMPLETED",
        "startTime": 1472848787.882,
        "endTime": 1472848878.079,
        "id": "codebuild-demo-project:38ca1c4a-e9ca-4dbc-bef1-d52bfEXAMPLE",
        "arn": "arn:aws:codebuild:region-ID:account-ID:build/codebuild-demo-project:38ca1c4a-e9ca-4dbc-bef1-d52bfEXAMPLE"      
      }
    ]
  }

  • buildsNotFound は、情報が利用できないビルドのビルド ID を表します。この例では、空である必要があります。

  • builds は、利用可能な各ビルドに関する情報を表します。この例では、出力に 1 つのビルドのみに関する情報が表示されます。

    • phases は、CodeBuild がビルドプロセス中に実行する一連のビルドフェーズを表します。各ビルドフェーズに関する情報が startTime、endTime、durationInSeconds (フェーズの開始時と終了時、Unix 時間形式で表示、持続時間 (秒))、phaseType (SUBMITTED、PROVISIONING、DOWNLOAD_SOURCE、INSTALL、PRE_BUILD、BUILD、POST_BUILD、UPLOAD_ARTIFACTS、FINALIZING、COMPLETED など)、phaseStatus (SUCCEEDED、FAILED、FAULT、TIMED_OUT、IN_PROGRESS、STOPPED など) として個別にリストされます。batch-get-builds コマンドを初めて実行するときは、多くの (またはまったく) フェーズが存在しない可能性があります。同じビルド ID を持つ batch-get-builds コマンドを続けて実行すると、より多くのビルドフェーズが出力に表示されます。

    • logs は、Amazon CloudWatch Logs のビルドのログに関する情報を表します。

    • md5sum および sha256sum は、ビルドの出力アーティファクトの MD5 と SHA-256 ハッシュを表します。これらは、関連するビルドプロジェクトの packaging 値が ZIP に設定されている場合にのみ出力に表示されます。（このチュートリアルでは設定していません。） これらのハッシュとチェックサムツールを使用して、ファイルの完全性と信頼性を確認することができます。

      注記

      Amazon S3 コンソールを使用して、これらのハッシュを表示することもできます。ビルド出力アーティファクトの横にあるボックスを選択し、[アクション]、[プロパティ] の順に選択します。[Properties] ペインで [Metadata] を展開し、[x-amz-meta-codebuild-content-md5] と [x-amz-meta-codebuild-content-sha256] の値を確認します。(Amazon S3 コンソールでは、ビルド出力アーティファクトの [ETag] 値を MD5 または SHA-256 ハッシュのいずれかに解釈することはできません。)

      AWS SDKs を使用してこれらのハッシュを取得する場合、値は codebuild-content-md5と という名前になりますcodebuild-content-sha256。

    • endTime は、ビルドプロセスが終了した時刻 (Unix の時間形式) を表します。

  注記

  Amazon S3 メタデータには、x-amz-meta-codebuild-buildarn という名前の CodeBuild ヘッダーがあります。このヘッダーには、Amazon S3 にアーティファクトを公開する CodeBuild ビルドの buildArn が含まれています。通知のソーストラッキングを許可し、アーティファクトの生成元であるビルドを参照するために buildArn を追加します。

詳細なビルド情報を表示するには

1. ウェブブラウザを使用して、前の手順の出力に表示された deepLink の場所に移動します (例: https://console.aws.amazon.com/cloudwatch/home?region=region-ID#logEvent:group=/aws/codebuild/codebuild-demo-project;stream=38ca1c4a-e9ca-4dbc-bef1-d52bfEXAMPLE)。

2. CloudWatch Logs ログストリームでは、ログイベントを参照できます。デフォルトでは、ログイベントの最後のセットだけが表示されます。以前のログイベントを表示するには、リストの先頭にスクロールします。

3. このチュートリアルでは、ほとんどのログイベントに、CodeBuild でビルド依存ファイルをビルド環境にダウンロードおよびインストールする操作に関する詳細情報が含まれますが、これらの情報は不要な場合があります。[Filter events] ボックスを使用すると、表示する情報量を減らすことができます。例えば、[Filter events] (イベントのフィルター) で「"[INFO]"」と入力した場合、「[INFO]」を含むイベントのみが表示されます。詳細については、Amazon CloudWatch ユーザーガイドの「フィルターとパターンの構文」を参照してください。

ビルド出力アーティファクトを取得するには (AWS CodeBuild コンソール）

1. CodeBuild コンソールが開いていて、ビルドの詳細ページが前のステップから引き続き表示されている状態で、[Build details] を選択して [Artifacts] セクションまでスクロールします。

   注記

   ビルドの詳細ページが表示されていない場合は、ナビゲーションバーで [Build history] (ビルド履歴)、[Build run] (ビルドの実行) リンクの順に選択します。

2. Amazon S3 フォルダへのリンクは、[Artifacts upload location] (アーティファクトのアップロード場所) の下にあります。Amazon S3 内のフォルダが開き、「messageUtil-1.0.jar」という名前のビルド出力アーティファクトファイルを見つけます。

ビルド出力アーティファクトを取得するには (Amazon S3 コンソール)

1. https://console.aws.amazon.com/s3/ で Amazon S3 コンソールを開きます。

2. codebuild-region-ID-account-ID-output-bucket を開きます。

3. codebuild-demo-project フォルダを開きます。

4. target という名前のフォルダを開き、messageUtil-1.0.jar という名前のビルド出力アーティファクトファイルを見つけます。