通過在本地計算機上構建應用程式，您可以：

• 在本地測試 buildspec 檔案的完整性和內容。
• 提交之前，在本地測試並構建應用程式。
• 快速識別並修復本地開發環境中的錯誤。

先決條件

在這篇博文中，我將使用 AWS Cloud9 IDE 作為開發環境。

如果您要將 AWS Cloud9 用作 IDE，請遵循“AWS Cloud9 使用者指南”中的快速設定步驟。

AWS Cloud9 IDE 中已安裝了 Docker 和 Git。如果您打算使用膝上型電腦或桌上型電腦作為開發環境，請先安裝 Docker 和 Git。

在本地構建 CodeBuild 映像的步驟

$ git clone https://github.com/aws/aws-codebuild-docker-images.git

 

我們來為 JDK 8 環境構建一個本地 CodeBuild 映像。JDK 8 的 Dockerfile 位於 /aws-codebuild-docker-images/ubuntu/java/openjdk-8。

編輯 Dockerfile 刪除最後一行 ENTRYPOINT [“dockerd-entrypoint.sh”]，並儲存該檔案。

執行 cd ubuntu/java/openjdk-8 以更改本地工作區中的目錄。

執行 docker build -t aws/codebuild/java:openjdk-8 以在本地構建 Docker 映像。執行完該命令需要幾分鐘的時間。

$ cd aws-codebuild-docker-images
$ cd ubuntu/java/openjdk-8
$ docker build -t aws/codebuild/java:openjdk-8 .

設定 CodeBuild 本地代理的步驟

執行以下 Docker pull 命令，下載本地 CodeBuild 代理。

$ docker pull amazon/aws-codebuild-local:latest --disable-content-trust=false

現在，您的計算機上已經具有本地代理映像，並可以執行本地構建了。

執行以下 git 命令下載示例 Java 專案。

$ git clone https://github.com/karthiksambandam/sample-web-app.git

使用本地代理構建示例專案的步驟

我們來使用本地代理構建示例 Java 專案。

執行以下 Docker 命令，執行本地代理並構建您之前克隆的示例 Web 應用程式儲存庫。

$ docker run -it -v /var/run/docker.sock:/var/run/docker.sock -e "IMAGE_NAME=aws/codebuild/java:openjdk-8" -e "ARTIFACTS=/home/ec2-user/environment/artifacts" -e "SOURCE=/home/ec2-user/environment/sample-web-app" amazon/aws-codebuild-local

注意 ：我們需要提供三個環境變數，即 IMAGE_NAME、SOURCE 和 ARTIFACTS。

IMAGE_NAME ：構建環境映像的名稱。

SOURCE ：原始碼目錄的絕對路徑。

ARTIFACTS ：工件輸出資料夾的絕對路徑。

如果您在其他作業系統上執行，絕對路徑可能會有所不同：

Linux：/home/user/…
MacOS ：/Users/user/…

當您執行示例專案時，會出現執行時錯誤，提示 YAML 檔案不存在。這是因為示例 Web 專案中未包含 buildspec.yml 檔案。AWS CodeBuild 需要 buildspec.yml 來執行構建。有關 buildspec.yml 的更多資訊，請參閱“AWS CodeBuild 使用者指南”中的構建規範示例。

我們來將 buildspec.yml 檔案及以下內容新增到 sample-web-app 資料夾，然後重新構建專案。

version: 0.2

phases:
  build:
    commands:
      - echo Build started on `date`
      - mvn install

artifacts:
  files:
    - target/javawebdemo.war

$ docker run -it -v /var/run/docker.sock:/var/run/docker.sock -e "IMAGE_NAME=aws/codebuild/java:openjdk-8" -e "ARTIFACTS=/home/ec2-user/environment/artifacts" -e "SOURCE=/home/ec2-user/environment/sample-web-app" amazon/aws-codebuild-local

現在，您應該可以成功構建了。成功執行後，在“/artifacts”資料夾中檢視構建的最終 artifacts.zip 檔案並進行驗證。

總結：

在這篇博文中，我向您演示瞭如何快速設定 CodeBuild 本地代理，以便從本地臺式機或膝上型電腦上直接構建專案。如您所見，本地構建可以幫助您快速識別和修復錯誤，從而提高開發人員的工作效率。

希望本文會對您有所幫助。歡迎在評論中留下您的反饋或建議。