本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

您可以使用 **AWS Explorer** 和 VS Code 的**命令面板**，在 Toolkit for VS Code 中创建 App Runner 服务。选择在特定 AWS 区域创建服务后，**命令面板**提供的带编号的步骤将引导您完成配置应用程序运行的服务实例的过程。

在创建 App Runner 服务之前，请确保您已完成[先决条件](using-apprunner.md#apprunner-prereqs)。这包括提供相关的 IAM 权限以及确认要部署的特定源存储库。<a name="create-service"></a>

# 创建 App Runner 服务
<a name="create-service"></a>

1. 如果 AWS 资源管理器尚未打开，请将其打开。

1. 右键单击 **App Runner** 节点，然后选择 **Create Service**（创建服务）。

   此时将显示**命令面板**。

1. 对于 **Select a source code location type**（选择源代码位置类型），请选择 **ECR** 或 **Repository**（存储库）。

   如果选择 **ECR**，则可以在 Amazon Elastic Container Registry 维护的存储库中指定容器镜像。如果选择 **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 Public Gallery 维护的镜像存储库的 URL。
**注意**  
如果您从 Amazon ECR Public Gallery 中指定存储库，请确保关闭自动部署，因为 App Runner 不支持对 Amazon ECR Public Gallery 中的镜像进行进行自动部署。  
默认情况下，自动部署处于关闭状态，当**命令面板**标题上的图标显示一条对角线时，会显示此状态。如果选择开启自动部署，则会显示一条消息，通知您此选项可能会产生额外费用。

1. 如果**命令面板**中的步骤报告**未找到标签**，则您需要后退一步才能选择包含已设置标签的容器镜像的存储库。

1. 如果您使用的是 Amazon ECR 私有注册表，则需要 ECR 访问角色角色，该角色允许 App Runner 访问您账户**AppRunnerECRAccess中的**亚马逊弹性容器注册表 (Amazon ECR) Container Registry 镜像。选择**命令面板**标题上的“\$1”图标以自动创建此角色。（如果您的镜像存储在 Amazon ECR Public 中，其中镜像是公开可用的，则不需要访问角色。） 

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 连接**页面上。

1.  **在 “选择远程 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** 中显示状态 **Create failed**（创建失败）。有关故障排除技巧，请参阅 *App Runner 开发人员指南*中的[服务创建失败时](https://docs.aws.amazon.com/apprunner/latest/dg/manage-create.html#manage-create.failure)。