在本機執行建置AWS CodeBuild代理人 - AWS CodeBuild

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

在本機執行建置AWS CodeBuild代理人

您可以使用AWS CodeBuild代理程式在本機電腦上執行 CodeBuild 版本。有代理程式可用於 x86_64 和 ARM 平台。

您還可以訂,以便在代理程式有新版本發佈時收到通知。

先決條件

開始之前,您需要執行下列動作:

  • 在您的本機電腦上安裝 Git。

  • 安裝與設定碼頭工人在您的本機電腦上。

設置構建映像

您只需在第一次運行代理時或映像發生更改時設置構建映像。

設置構建映像

  1. 如果您想要使用精選的 Amazon Linux 2 映像,可以從 CodeBuild 公共 Amazon ECR 存儲庫中提取該映像,網址為https://gallery.ecr.aws/codebuild/amazonlinux2-x86_64-standard使用下列命令:

    $ docker pull public.ecr.aws/codebuild/amazonlinux2-x86_64-standard:3.0

    或者,請執行下列步驟:

    1. 克隆 CodeBuild 映像回購:

      $ git clone https://github.com/aws/aws-codebuild-docker-images.git
    2. 切換至映像目錄。在此範例中,使用aws/codebuild/standard:5.0映像:

      $ cd aws-codebuild-docker-images/ubuntu/standard/5.0
    3. 建立映像。這將需要數分鐘的時間。

      $ docker build -t aws/codebuild/standard:5.0 .
  2. 下載 代理程式。

    若要下載 x86_64 版本的代理程式,請執行下列命令:

    $ docker pull public.ecr.aws/codebuild/local-builds:latest

    若要下載 ARM 版本的代理程式,請執行下列命令:

    $ docker pull public.ecr.aws/codebuild/local-builds:aarch64
  3. 代 CodeBuild 置代理程式可從https://gallery.ecr.aws/codebuild/local-builds

    x86_64 版本的代理的安全哈希算法 (SHA) 簽名為:

    sha256:fdfff9470520c53dcd522606a3cc2b5df195ae8a5546697b08249b48175f45ed

    ARM 版代理的 SHA 簽名為:

    sha256:5480b70cf48435e276c21789c61280cfada24e17701ede6386e5d82088bc41ca

    您可以使用 SHA 標識代理程式的版本。若要查看代理程式的 SHA 簽章,請執行以下命令:

    $ docker inspect public.ecr.aws/codebuild/local-builds:latest

運行 CodeBuild 代理

運行 CodeBuild 代理

  1. 切換至包含您的建置項目源代碼的目錄。

  2. 下載codebuild_build.sh指令碼:

    $ wget https://raw.githubusercontent.com/aws/aws-codebuild-docker-images/master/local_builds/codebuild_build.sh $ chmod +x codebuild_build.sh
  3. 執行codebuild_build.sh指令碼並指定您的容器映像和輸出目錄。

    若要執行 x86_64 版本,請執行下列命令:

    $ ./codebuild_build.sh -i <container-image> -a <output directory>

    若要執行 ARM 版本,請執行下列命令:

    $ ./codebuild_build.sh -i <container-image> -a <output directory> -l public.ecr.aws/codebuild/local-builds:aarch64

    Replace<container-image>與容器映像的名稱相同,例如aws/codebuild/standard:5.0或者public.ecr.aws/codebuild/amazonlinux2-x86_64-standard:3.0

    腳本啟動構建映像並在當前目錄中的項目上運行構建。要指定構建項目的位置,請添加-s <build project directory>選項添加到腳本命令。

接收新的 CodeBuild 代理程式版本的通知

您可以訂 Amazon SNS 通知,以便在AWS CodeBuild代理已釋放。

若要訂 CodeBuild 代理程式通知

  1. https://console.aws.amazon.com/sns/v3/home 開啟 Amazon SNS 主控台。

  2. 在導覽列中,請將AWS區域至美國東部 (維吉尼亞北部)。您必須選擇此AWS區域,因為您要訂的 Amazon SNS 通知已在本區域中建立完成。

  3. 在導覽窗格中,選擇 Subscriptions (訂閱)。

  4. 選擇 Create subscription (建立訂閱)。

  5. In建立訂,執行下列動作:

    1. 對於 Topic ARN (主題 ARN),請使用下列 Amazon Resource Name (ARN):

      arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates
    2. 針對 Protocol (通訊協定),選擇 Email (電子郵件)SMS (簡訊)

    3. 針對 Endpoint (端點),選擇要接收通知的位置 (電子郵件或簡訊)。輸入電子郵件或地址或電話號碼,包括區碼。

    4. 選擇 Create subscription (建立訂閱)。

    5. 選擇電子郵件收到要求確認訂的電子郵件。遵循電子郵件中的指示來完成訂閱。

      如果您不想再接收這些通知,請使用下列程序來取消訂閱。

若要取消訂 CodeBuild 代理程式通知

  1. https://console.aws.amazon.com/sns/v3/home 開啟 Amazon SNS 主控台。

  2. 在導覽窗格中,選擇 Subscriptions (訂閱)。

  3. 選取訂閱,然後從 Actions (動作),選擇 Delete subscriptions (刪除訂閱)。出現確認提示時,選擇 Delete (刪除)