CodeBuild Demo

​

Overview

1. Implement a simple Java utility and unit tests.
2. Create a buildspec.yml to define build commands.
3. Provision two S3 buckets—one for source input, one for build output.
4. Configure and run a CodeBuild project that pulls from S3, builds with Maven, and pushes artifacts back to S3.

​

Prerequisites

• An AWS account with permissions for CodeBuild, S3, and IAM.
• AWS CLI or access to the AWS Management Console.
• Java 11 (Corretto) and Maven installed locally (for packaging).

​

Step 1: Create the Java Utility and Unit Tests

1. In your project directory, create the MessageUtil class:

// src/main/java/MessageUtil.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;
    }
}

2. Next, add a JUnit test for MessageUtil:

// src/test/java/TestMessageUtil.java
import org.junit.Test;
import static org.junit.Assert.assertEquals;

public class TestMessageUtil {
    String message = "Robert";
    MessageUtil messageUtil = new MessageUtil(message);

    @Test
    public void testPrintMessage() {
        assertEquals(message, messageUtil.printMessage());
    }

    @Test
    public void testSalutationMessage() {
        String expected = "Hi! Robert";
        assertEquals(expected, messageUtil.salutationMessage());
    }
}

​

Step 2: Define the Build Specification (buildspec.yml)

version: 0.2
phases:
  install:
    runtime-versions:
      java: corretto11
  pre_build:
    commands:
      - echo "Starting pre-build phase..."
  build:
    commands:
      - echo "Build started on `date`"
      - mvn install
artifacts:
  files:
    - target/*.jar

​

Build Phases at a Glance

​

Step 3: Verify Directory Structure

project-root/
├── pom.xml
├── buildspec.yml
└── src
    ├── main
    │   └── java
    │       └── MessageUtil.java
    └── test
        └── java
            └── TestMessageUtil.java

​

Step 4: Create S3 Buckets for Source and Artifacts

1. In the AWS Console, navigate to S3 and click Create bucket.

2. Enter a name like codebuilddemo-kodekloud-mbbucket1 and accept the defaults.

3. Repeat to create a second bucket (e.g., codebuilddemo-kodekloud-mbbucket2).

​

Step 5: Package and Upload Your Source Code

1. Zip your project files: pom.xml, buildspec.yml, and the src directory.

2. Name the archive MessageUtil.zip and upload it to your source bucket:

3. Click the bucket, choose Upload, add MessageUtil.zip, and complete the upload wizard.

​

Step 6: Create and Configure the CodeBuild Project

1. In the AWS Console, open CodeBuild and click Create build project.

2. Under Source, choose Amazon S3.

3. Select your input bucket and set Object key to MessageUtil.zip.

4. Scroll to Environment:
   • Managed image
   • Operating system: Linux
   • Runtime: Standard
   • Image: x86_64 standard: 3.0

5. Under Buildspec, choose Use a buildspec file.
6. For Artifacts, select Amazon S3 and pick your output bucket.

7. Click Create build project to finalize.

​

Step 7: Start the Build and Monitor Logs

1. Select your newly created project and click Start build.

2. Watch the real-time logs for each build phase:

[Container] 2023/04/29 17:58:45 Waiting for agent ping
[Container] 2023/04/29 17:58:48 Phase is DOWNLOAD_SOURCE
[Container] 2023/04/29 17:58:49 Selecting 'java' runtime version 'corretto'...
[Container] 2023/04/29 17:58:49 Running command mvn install
...

3. Upon completion, you’ll see Succeeded status and your JAR files in the output bucket.

​

What’s Next?

​

References

• AWS CodeBuild User Guide
• Amazon S3 Documentation
• Apache Maven Project
• JUnit 4 Documentation