AWS Cloud9 不再提供給新客戶。 AWS Cloud9 的現有客戶可以繼續正常使用該服務。[進一步了解](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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

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

您可以使用 **AWS Explorer** 在 AWS Toolkit 中建立 App Runner 服務。在您選擇在特定 中建立服務之後 AWS 區域， AWS Toolkit 的命令窗格會說明如何設定應用程式執行所在的服務執行個體。

在建立 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** (建立服務)。

   工具 AWS 組命令窗格隨即顯示。

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 Public Gallery (Amazon ECR 公有映像庫) 指定儲存庫，請確認自動部署已關閉。App Runner 不支援 ECR 公有映像庫中映像的自動部署。  
自動部署預設為關閉狀態。當命令窗格標頭上的圖示出現斜跨圖示的對角線時即表示此狀態。如果您選擇開啟自動部署，則會顯示一則訊息，通知您此選項可能產生額外費用。

1. 如果命令窗格中的步驟報告 **No tags found** (找不到標籤)，請返回上一個步驟來選取包含標記容器映像的儲存庫。

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

1. (可選) 對於 **Configure environment variables** (設定環境變數)，請指定包含用來自訂服務執行個體中行為的環境變數的檔案。

1. 若您使用 Amazon ECR 私有登錄檔，則需 **AppRunnerECRAccessRole** ECR 存取角色。此角色允許 App Runner 存取您帳戶中的 Amazon Elastic Container Registry (Amazon ECR) 映像。選擇命令窗格標頭上的「\+」圖示，即可建立此角色。如果您的映像存放在 Amazon ECR 公有 (其映像可公開存取) 中，則不需要存取角色。

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。

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

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

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

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

   如果選擇 **Configure all settings here** (在此處調整所有設定)，請使用命令窗格來指定下列項目：
   + **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)。