自定義構建映像和實時包更新 - AWS Amplify

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

自定義構建映像和實時包更新

自訂建置影像

您可以使用自訂建置映像,為 Amplify 應用程式提供自訂的建置環境。如果您在使用 Amplify Console 的預設容器進行建置的期間,需花費很長時間來安裝特定依存項目,則可建立自己的 Docker 影像,並在建置期間參考該影像。圖像可以託管在Docker Hub或 Amazon Elastic Container Registry Public。

注意

建置設定只有當應用程序設置為連續部署並連接到 git 存儲庫時,才會在 Amplify 控制台的應用程序設置菜單中看到。如需這種部署類型的指示,請參閱入門現有程式碼

配置自定義構建映像

設定自訂建置映像

  1. 登入 AWS 管理主控台,並開啟Amplify 主控台

  2. 選擇您想要設定自訂建置影像的應用程式。

  3. 在導覽窗格中,選擇應用程式設定建置設定

  4. 建置設定頁面,在建置影像設定區段中,選擇Edit (編輯)

  5. 在 中編輯建置影像設定對話方塊中,展開建置影像功能表,然後選擇建置影像

  6. 輸入構建映像的名稱。例如,如果您的 Docker 集線器儲存機制的名稱是範例碼頭,並且您的圖像名稱是範例影像您需要輸入exampledockerrepo/exampleimage:latest

  7. 選擇 Save (儲存)。

配置在 Amazon ECR 中託管的自訂構建映像

  1. 請參閱入門中的亞馬遜 ECR 公用用戶指南來設置帶有 Docker 映像的亞馬遜 ECR 公共存儲庫。

  2. 登入 AWS 管理主控台,並開啟Amplify 主控台

  3. 選擇您想要設定自訂建置影像的應用程式。

  4. 在導覽窗格中,選擇應用程式設定建置設定

  5. 建置設定頁面,在建置影像設定區段中,選擇Edit (編輯)

  6. 在 中編輯建置影像設定對話方塊中,展開建置影像功能表,然後選擇建置影像

  7. 輸入您在步驟一建立的 Amazon ECR 公用儲存庫名稱。這是您的構建映像託管的地方。例如,如果你的回購的名稱是例子回購,您需輸入public.ecr.aws/xxxxxxxx/ecr-examplerepo

  8. 選擇 Save (儲存)。

自訂建置影像需求

若要讓自訂建置影像可做為 Amplify Console 建置影像使用,則該影像必須符合下列需求:

  1. cURL:在啟動您的自訂影像時,我們會下載建置執行器至容器,因此需要有 cURL。如果缺少這個依存項目,建置執行器就無法產生任何輸出,因此建置會立即失敗且不會有任何輸出。

  2. Git:若要複製 Git 儲存庫,需要在影像中安裝 Git。如果缺少這個依存項目,「複製儲存庫」的步驟就會失敗。

  3. OpenSSH:為了安全複製儲存庫,OpenSSH 在建置期間需暫時設定 SSH 金鑰,OpenSSH 套件會提供建置執行器執行此操作所需的命令。

  4. (基於 NPM 的構建)節點。:我們的建置執行器不會安裝 Node,而是需要您在影像中安裝 Node 和 NPM。只有需要 NPM 套件或 Node 特定命令的建置,才要進行此操作。

即時套件更新

即時套件更新可讓您指定要在 Amplify Console 預設建置影像中使用的套件和依存項目版本。預設建置影像隨附數個預先安裝的套件和依存項目 (如 Hugo、Amplify CLI、Yarn)。透過即時套件更新,您可以覆寫這些依存項目的版本,並指定使用特定版本或確保隨時安裝最新版本。如果在執行建置前啟用即時套件更新,則建置執行器會先更新 (或降級) 指定的依存項目。這會讓建置時間隨更新依存項目的時間成正比增加,但好處是可確保使用相同版本的依存項目來建置應用程式。

設定即時套件更新

規劃即時套件更新

  1. 登入 AWS 管理主控台,並開啟Amplify 主控台

  2. 選擇您想要為其設定即時套件更新的應用程式。

  3. 在導覽窗格中,選擇應用程式設定建置設定

  4. 建置設定頁面,在建置影像設定區段中,選擇Edit (編輯)

  5. 在 中編輯建置影像設定對話方塊中,展開新增套件版本覆寫清單,然後選擇您想要變更的套件。

  6. 適用於版本,請保留預設值最新或輸入依存項目的特定版本。如果您使用最新,依存項目一律會升級至可用的最新版本。

  7. 選擇 Save (儲存)。