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 マネジメントコンソール にサインインして、AWS CodeBuild コンソール (https://console.aws.amazon.com/codesuite/codebuild/home) を開きます。

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 マネジメントコンソール にサインインしたことが原因と考えられます。これを修正するには、AWS マネジメントコンソール からサインアウトし、次の IAM エンティティのいずれかに属する認証情報でサインインし直します。

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

   • ユーザー (またはユーザーが属する IAM グループ) に AWSCodeBuildAdminAccess、AmazonS3ReadOnlyAccess、および IAMFullAccess 管理ポリシーがアタッチされている、AWS アカウントのユーザー。これらのアクセス許可を持つユーザーやグループが 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. AWS CodeBuild コンソール (https://console.aws.amazon.com/codesuite/codebuild/home) を開きます。

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

   • 完了

   [ビルドステータス] で、[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. Amazon S3 コンソール (https://console.aws.amazon.com/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. AWS CLI を使用して create-project コマンドを実行します。

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

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

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

   {
     "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. AWS CLI を使用して start-build コマンドを実行します。

   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] の値を書き留めておきます。それは次の手順で必要となります。

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

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

  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 SDK を使用して、これらのハッシュを取得する場合、値の名前は 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. Amazon S3 コンソール (https://console.aws.amazon.com/s3/) を開きます。

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

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

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