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

# 建立 App Runner 服務
<a name="creating-service-apprunner"></a>

您可以使用 **AWS Explorer** 和 VS Code 的**命令面板**，在 Toolkit for VS Code 中建立 App Runner 服務。在您選擇在特定 AWS 區域中建立服務之後， **Command Palette** 提供的編號步驟會引導您完成設定應用程式執行之服務執行個體的程序。

在建立 App Runner 服務之前，請務必先完成[先決條件](using-apprunner.md#apprunner-prereqs)。這包括提供相關的 IAM 許可，以及確認您要部署的特定來源儲存庫。<a name="create-service"></a>

# 建立 App Runner 服務
<a name="create-service"></a>

1. Open AWS Explorer，如果尚未開啟。

1. 在 **App Runner** 節點上按一下滑鼠右鍵並選擇 **Create Service** (建立服務)。

   **命令面板**隨即顯示。

1. 對於 **Select a source code location type** (選取原始碼位置類型)，請選擇 **ECR** 或 **Repository** (儲存庫)。

   如果選擇 **ECR**，您可以在由 Amazon Elastic Container Registry (Amazon ECR) 維護的儲存庫中指定容器映像。如果選擇 **Repository** (儲存庫)，您可以指定由支援的儲存庫提供者維護的原始碼儲存庫。目前，App Runner 支援 [GitHub](https://github.com/) 作為原始碼儲存庫提供者。

## 從 ECR 部署
<a name="deploying-from-ECR"></a>

1. 若為 **Select or enter an image repository** (選取或輸入映像儲存庫)，請選擇或輸入由您的 Amazon ECR 私有登錄或 Amazon ECR 公有映像庫維護的映像儲存庫 URL。
**注意**  
如果您從 Amazon ECR 公有映像庫指定儲存庫，請確定自動部署已關閉，因為 App Runner 不支援 ECR 公有儲存庫中映像的自動部署。  
根據預設，自動部署會關閉，當 **Command Palette** 標頭上的 圖示具有穿過它的對角線時，就會顯示此選項。如果您選擇開啟自動部署，則會顯示一則訊息，通知您此選項可能產生額外費用。

1. 如果 **Command Palette** 步驟報告**找不到標籤**，您需要返回步驟以選取包含已標記容器映像的儲存庫。

1. 如果您使用的是 Amazon ECR 私有登錄，則需要 ECR 存取角色 **AppRunnerECRAccessRole**，允許 App Runner 在您帳戶中存取 Amazon Elastic Container Registry (Amazon ECR) 映像。選擇 **Command Palette** 標頭上的「＋」圖示，以自動建立此角色。(如果您的映像存放在 Amazon ECR 公有 (其映像可公開存取) 中，則不需要存取角色。) 

1. 對於 **Port** (連接埠)，請輸入服務所使用的 IP 連接埠 (例如：連接埠 `8000`）。

1. 對於 **Configure environment variables** (設定環境變數)，您可以指定包含用來自訂服務執行個體中行為的環境變數的檔案。或者，您可以略過此步驟。

1. 對於 **Name your service** (為您的服務命名)，請輸入唯一的名稱 (不含空格)，然後按下 **Enter 鍵**。

1. 對於 **Select instance configuration** (選取執行個體組態)，請為您的服務執行個體選擇 CPU 單位和以 GB 為單位的記憶體的組合。

   建立您的服務時，其狀態會從**建立中**變更至**執行中**。

1.  服務開始執行後，在該服務上按一下滑鼠右鍵，然後選擇 **Copy Service URL** (複製服務 URL)。

1. 若要存取您部署的應用程式，請將複製的 URL 貼上至您 Web 瀏覽器的網址列中。

## 從遠端儲存庫部署
<a name="deploying-from-repository"></a>

1.  針對**選取連線**，選擇連結 GitHub 的連線 AWS。可供選取的連線清單列於 App Runner 主控台上的 **GitHub connections** (GitHub 連線) 頁面。

1.  對於 **Select a remote GitHub repository** (選取遠端 GitHub 儲存庫)，請選擇或輸入遠端儲存庫的 URL。

    已使用 Visual Studio Code 的來源控制管理 (SCM) 設定的遠端儲存庫可供選取。如果沒有列出儲存庫的連結，您也可以貼上該儲存庫的連結。

1. 對於 **Select a branch** (選取分支)，請選擇您要部署之原始碼中的 Git 分支。

1. 對於 **Choose configuration source** (選擇組態來源)，請指定您要如何定義執行時間組態。

   如果選擇 **Use configuration file** (使用組態檔案)，則您的服務執行個體是由 `apprunner.yaml` 組態檔案所定義之設定來設定。此檔案位於應用程式儲存庫的根目錄中。

   如果您選擇**在此處設定所有設定**，請使用**命令面板**來指定下列項目：
   + **Runtime** (執行時間)：選擇 **Python 3** 或 **Nodejs 12**。
   + **Build command** (建置命令)：輸入命令以在服務執行個體的執行階段環境中建置應用程式。
   + **Start command** (開始命令)：輸入命令以在服務執行個體的執行階段環境中啟動應用程式。

1. 若為 **Port** (連接埠)，請輸入服務所使用的 IP 連接埠 (例如：連接埠 `8000`）。

1. 對於 **Configure environment variables** (設定環境變數)，您可以指定包含用來自訂服務執行個體中行為的環境變數的檔案。或者，您可以略過此步驟。

1. 對於 **Name your service** (為您的服務命名)，請輸入唯一的名稱 (不含空格)，然後按下 **Enter 鍵**。

1. 對於 **Select instance configuration** (選取執行個體組態)，請為您的服務執行個體選擇 CPU 單位和以 GB 為單位的記憶體的組合。

   建立您的服務時，其狀態會從**建立中**變更至**執行中**。

1. 服務開始執行後，在該服務上按一下滑鼠右鍵，然後選擇 **Copy Service URL** (複製服務 URL)。

1. 若要存取您部署的應用程式，請將複製的 URL 貼上至您 Web 瀏覽器的網址列中。

**注意**  
如果您嘗試建立 App Runner 服務失敗，服務會在 **AWS Explorer** 中顯示**建立失敗**狀態。如需疑難排解祕訣，請參閱 *App Runner 開發人員指南*中的「[建立服務失敗時](https://docs.aws.amazon.com/apprunner/latest/dg/manage-create.html#manage-create.failure)」。