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());
     }
   }

   이 클래스 파일은 MessageUtil 클래스의 message 변수를 Robert로 설정합니다. 그런 다음 테스트를 수행하여 Robert 및 Hi!Robert 문자열이 출력에 나타나는지 여부를 확인하여 message 변수가 성공적으로 설정되었는지를 확인합니다.

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 정보 페이지가 나타나면 빌드 프로젝트 생성을 선택합니다. 그렇지 않을 경우, 탐색 창에서 빌드를 확장한 후 빌드 프로젝트를 선택하고 빌드 프로젝트 생성을 선택합니다.

4. 빌드 프로젝트 만들기 페이지의 프로젝트 구성에서 프로젝트 이름에 이 빌드 프로젝트의 이름(이 예에서는 codebuild-demo-project)을 입력합니다. 각 AWS 계정에서 빌드 프로젝트 이름은 고유해야 합니다. 다른 이름을 사용하는 경우 이 자습서 전체에서 해당 이름을 사용해야 합니다.

   참고

   빌드 프로젝트 생성 페이지에 You are not authorized to perform this operation.와 같은 오류 메시지가 표시될 수 있습니다. 빌드 프로젝트를 생성할 권한이 없는 사용자로 AWS Management Console에 로그인했기 때문일 가능성이 큽니다. 이 문제를 해결하려면 AWS Management Console에서 로그아웃한 후, 다음 IAM 엔터티 중 하나에 속한 보안 인증을 사용하여 다시 로그인합니다.

   • AWS 계정의 관리자 사용자. 자세한 내용은 사용 설명서에서 첫 번째 AWS 계정 루트 사용자 및 그룹 생성을 참조하세요.

   • 해당 사용자 또는 사용자가 속한 IAM 그룹에 연결된 AWSCodeBuildAdminAccess, AmazonS3ReadOnlyAccess 및 IAMFullAccess 관리형 정책을 사용하는 AWS 계정의 사용자. AWS 계정에 이러한 권한이 있는 사용자 또는 그룹이 없으며, 이러한 권한을 사용자나 그룹에 추가할 수 없는 경우, AWS 계정 관리자에게 지원을 요청하세요. 자세한 내용은 AWS CodeBuild에 대한 AWS 관리형(미리 정의된) 정책 단원을 참조하십시오.

   두 옵션 모두 이 자습서를 완료할 수 있도록 빌드 프로젝트를 생성할 수 있는 관리자 권한이 포함되어 있습니다. 작업을 완료하는 데 필요한 최소 권한을 항상 사용하는 것이 좋습니다. 자세한 내용은 AWS CodeBuild 권한 참조 단원을 참조하십시오.

5. 소스의 소스 공급자에서 Amazon S3를 선택합니다.

6. 버킷에서 codebuild-region-ID-account-ID-input-bucket을 선택합니다.

7. S3 object key(S3 객체 키)에 MessageUtil.zip을 입력합니다.

8. 환경의 환경 이미지에서 관리형 이미지를 선택된 상태로 둡니다.

9. 운영 체제에서 Amazon Linux를 선택합니다.

10. 런타임에서 표준을 선택합니다.

11. 이미지의 경우 aws/codebuild/amazonlinux2-x86_64-standard:corretto11을 선택합니다.

12. 서비스 역할에서 새 서비스 역할을 선택된 상태로 두고, 역할 이름도 변경하지 않고 그대로 둡니다.

13. Buildspec(빌드 사양)에서 Use a buildspec file(빌드 사양 파일 사용)을 선택된 상태로 둡니다.

14. 아티팩트에서 유형으로 Amazon S3를 선택합니다.

15. 버킷 이름에서 codebuild-region-ID-account-ID-output-bucket을 선택합니다.

16. 이름 및 경로는 비워 둡니다.

17. 빌드 프로젝트 생성을 선택합니다.

빌드를 실행하려면

1. https://console.aws.amazon.com/codesuite/codebuild/home에서 AWS CodeBuild 콘솔을 엽니다.

2. 탐색 창에서 프로젝트 빌드를 선택합니다.

3. 빌드 프로젝트 목록에서 codebuild-demo-project를 선택한 후 빌드 시작을 선택합니다. 빌드가 즉시 시작됩니다.

1. codebuild-demo-project:<build-ID> 페이지가 표시되지 않으면, 탐색 모음에서 빌드 이력을 선택합니다. 그런 다음, 빌드 프로젝트 목록에서 프로젝트에 대해 codebuild-demo-project에 대한 빌드 실행 링크를 선택합니다. 일치하는 링크가 하나만 있어야 합니다. (이전에 이 자습서를 완료한 경우 완료됨 열에서 가장 최근 값이 포함된 링크를 선택합니다.)

2. 빌드 상태 페이지의 단계 세부 정보에는 다음과 같은 빌드 단계가 표시되고 상태 열에 성공이 표시되어야 합니다.

   • SUBMITTED

   • 대기됨

   • PROVISIONING

   • DOWNLOAD_SOURCE

   • INSTALL

   • PRE_BUILD

   • BUILD

   • POST_BUILD

   • UPLOAD_ARTIFACTS

   • FINALIZING

   • COMPLETED

   빌드 상태에, 성공이 표시되어야 합니다.

   대신 진행 중이 표시되면 새로 고침 단추를 선택합니다.

3. 각 빌드 단계 옆에 있는 기간 값은 빌드 단계가 지속되는 기간을 나타냅니다. 종료 시간 값은 빌드 단계가 종료되었음을 나타냅니다.

자세한 빌드 정보를 보려면

1. 이전 단계의 빌드 세부 정보 페이지가 계속 표시된 상태에서 [Build logs]에 빌드 로그의 마지막 10,000행이 표시되어 있습니다. CloudWatch Logs에 전체 빌드 로그를 표시하려면 전체 로그 보기 링크를 선택합니다.

2. CloudWatch Logs 로그 스트림에서 로그 이벤트를 찾아 볼 수 있습니다. 기본적으로 가장 최근의 로그 이벤트 세트만 표시됩니다. 이전의 로그 이벤트를 보려면 목록의 처음으로 스크롤합니다.

3. 이 자습서에서는 대부분의 로그 이벤트에 CodeBuild가 빌드 종속성 파일을 빌드 환경에 다운로드 및 설치하는 작업에 대한 자세한 정보가 들어 있는데, 대부분의 사용자에게 필요하지 않은 정보입니다. [Filter events]를 사용하면 표시되는 정보를 줄일 수 있습니다. 예를 들어, 필터 이벤트에 "[INFO]"를 입력하면 [INFO]를 포함하는 이벤트만 표시됩니다. 자세한 내용은 Amazon CloudWatch Logs 사용 설명서의 필터 및 패턴 구문을 참조하세요.

빌드 출력 결과물을 가져오려면(AWS CodeBuild 콘솔)

1. CodeBuild 콘솔이 여전히 열려 있고 이전 단계의 빌드 세부 정보 페이지가 계속 표시된 상태에서 빌드 세부 정보 탭을 선택하고 아티팩트 섹션으로 스크롤합니다.

   참고

   빌드 세부 정보 페이지가 표시되지 않으면, 탐색 모음에서 빌드 이력을 선택한 다음, 빌드 실행 링크를 선택합니다.

2. Amazon S3 폴더로 연결되는 링크는 아티팩트 업로드 위치 아래에 있습니다. 이 링크를 클릭하면 messageUtil-1.0.jar 빌드 출력 아티팩트 파일을 찾는 Amazon S3의 폴더가 열립니다.

빌드 출력 아티팩트를 가져오려면(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());
     }
   }

   이 클래스 파일은 MessageUtil 클래스의 message 변수를 Robert로 설정합니다. 그런 다음 테스트를 수행하여 Robert 및 Hi!Robert 문자열이 출력에 나타나는지 여부를 확인하여 message 변수가 성공적으로 설정되었는지를 확인합니다.

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 형식 데이터가 출력에 표시됩니다. 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는 도커 이미지 리포지토리 유형에서 지정한 대로 이 빌드 프로젝트에서 사용할 도커 이미지 이름 및 태그 조합을 나타내는 필수 값입니다(이 예에서는 CodeBuild 도커 이미지 리포지토리의 도커 이미지의 경우 aws/codebuild/standard:5.0). aws/codebuild/standard는 도커 이미지의 이름입니다. 5.0은 도커 이미지의 태그입니다.

     자신의 시나리오에서 사용할 수 있는 더 많은 도커 이미지를 찾으려면 빌드 환경 참조 단원을 참조하십시오.

   • environment의 computeType은 CodeBuild가 사용할 컴퓨팅 리소스를 나타내는 필수 값입니다(이 예에서는 BUILD_GENERAL1_SMALL).

   참고

   원래의 JSON 형식 데이터에서 사용 가능한 다른 값으로, description, buildspec, auth (type 및 resource 포함), path, namespaceType, name(artifacts의 경우), packaging, environmentVariables(name 및 value 포함), timeoutInMinutes, encryptionKey 및 tags(key 및 value 포함) 등이 있으며 선택 사항입니다. 이러한 값은 이 자습서에서 사용되지 않으므로 여기서는 다루지 않습니다. 자세한 내용은 빌드 프로젝트 생성(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는 정보를 찾을 수 있는 각 빌드에 대한 정보를 나타냅니다. 이 예에서는 한 빌드에 대한 정보만 출력에 표시됩니다.

    • 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 메타데이터에는 Amazon S3에 아티팩트를 게시하는 CodeBuild 빌드의 buildArn이 포함된 x-amz-meta-codebuild-buildarn라는 CodeBuild 헤더가 있습니다. 알림에 대한 소스 추적을 허용하고 아티팩트가 생성된 빌드를 참조할 수 있도록 하기 위해 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]를 사용하면 표시되는 정보를 줄일 수 있습니다. 예를 들어, 필터 이벤트에 "[INFO]"를 입력하면 [INFO]를 포함하는 이벤트만 표시됩니다. 자세한 내용은 Amazon CloudWatch Logs 사용 설명서의 필터 및 패턴 구문을 참조하세요.

빌드 출력 결과물을 가져오려면(AWS CodeBuild 콘솔)

1. CodeBuild 콘솔이 여전히 열려 있고 이전 단계의 빌드 세부 정보 페이지가 계속 표시된 상태에서 빌드 세부 정보 탭을 선택하고 아티팩트 섹션으로 스크롤합니다.

   참고

   빌드 세부 정보 페이지가 표시되지 않으면, 탐색 모음에서 빌드 이력을 선택한 다음, 빌드 실행 링크를 선택합니다.

2. Amazon S3 폴더로 연결되는 링크는 아티팩트 업로드 위치 아래에 있습니다. 이 링크를 클릭하면 messageUtil-1.0.jar 빌드 출력 아티팩트 파일을 찾는 Amazon S3의 폴더가 열립니다.

빌드 출력 아티팩트를 가져오려면(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 빌드 출력 결과물 파일을 찾을 수 있습니다.