安装Amazon SAM在 Windows 上执行 CLI - Amazon Serverless Application Model
第 1 步：创建 Amazon 账户第 2 步：配置 IAM 权限和Amazon证书第 3 步：安装 Docker（可选）第 4 步：安装Amazon SAMCLI卸载每晚构建后续步骤
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

安装Amazon SAM在 Windows 上执行 CLI

请按照以下步骤安装和配置使用Amazon SAMWindows 主机上的命令行界面 (CLI)：

  1. 创建Amazon Identity and Access Management(Amazon) 账户。

  2. 配置 IAM 权限和Amazon凭证。

  3. 安装 Docker. 注意：Docker 只是在本地测试应用程序或使用--use-container选项。

  4. 安装 Amazon SAM CLI。

第 1 步：创建 Amazon 账户

如果您还没有Amazon账户，请参阅aws.amazon.com然后选择创建Amazon账户. 有关详细说明，请参阅创建并激活Amazon账户.

第 2 步：配置 IAM 权限和Amazon证书

与之一使用的 IAM 用户Amazon SAM必须有足够的权限才能进行必要Amazon服务呼叫和管理Amazon资源的费用。确保用户拥有足够权限的最简单方法是向他们授予管理员权限。有关更多信息，请参阅 IAM 用户指南中的创建您的第一个 IAM 管理员用户和组。

注意

如果您不想将管理员权限授予使用Amazon Command Line Interface(Amazon CLI)，您可以向他们授予受限的权限集。有关更多信息，请参阅 权限。

此外，要启用Amazon SAM要制作的 CLIAmazon必须设置服务呼叫，您必须设置Amazon凭证。有关更多信息，请参阅 设置Amazon证书。

第 3 步：安装 Docker（可选）

注意

Docker 只是在本地测试应用程序以及使用--use-container选项。如果您最初不打算使用这些功能，则可以跳过本节或稍后安装 Docker。

注意

我们正式支持 Docker Desktop，但是从 SAM CLI 版本 1.47.0 开始，只要使用 Docker 运行时，您就可以使用替代方案。

Docker 是一款在 Linux 计算机上运行容器的应用程序。Amazon SAM提供的本地环境类似于Amazon Lambda用作 Docker 容器。您可以使用此容器构建、测试和调试无服务器应用程序。

使用本地运行无服务器项目和功能Amazon SAMCLI，你必须安装 Docker 并正常工作。这些区域有：Amazon SAMCLI 使用DOCKER_HOST用于联系 Docker 守护程序的环境变量。以下步骤介绍如何安装、配置和验证 Docker 安装以使用Amazon SAMCLI。

  1. 安装 Docker.

    Docker 桌面支持最新的 Windows 操作系统。对于 Windows 的旧版本，Docker 工具箱可用。选择你的 Windows 版本以获取正确的 Docker 安装步骤：

  2. 配置共享驱动器。

    这些区域有：Amazon SAMCLI 要求项目目录或任何父目录都列在共享驱动器中。在某些情况下，您必须共享驱动器才能正常运行 Docker。

  3. 验证安装。

    安装 Docker 之后，验证它是否正常工作。还要确认您可以从命令行运行 Docker 命令（例如，docker ps)。您无需安装、提取或拉取任何容器 —Amazon SAMCLI 根据需要自动执行此操作。

如果您在安装 Docker 时遇到问题，请参阅日志和故障排除的 部分Docker 安装指南有关其他故障排除提示。

第 4 步：安装Amazon SAMCLI

Windows 安装程序 (MSI) 文件是 Windows 操作系统的软件包安装程序文件。

请按照以下步骤安装Amazon SAMCLI 使用 MSI 文件。

  1. 安装Amazon SAMCLI64 位.

    注意

    如果你在 32 位系统上运行，请参阅安装Amazon SAM32 位 Windows 上的 CLI.

  2. 验证安装。

    完成安装后，通过打开新的命令提示符进行验证或 PowerShell 。您应该能够调用sam从命令行进行操作。

    sam --version

    在成功安装后，您应该会看到类似下面的输出，类似于Amazon SAMCLI：

     
 SAM CLI, version 1.35.0

  3. 安装 Git。

    使用下载示例应用程序sam init命令时，您还必须安装 Git。有关说明，请参阅安装 Git.

现在您已准备就绪，可以启动开发。

卸载

卸载Amazon SAM使用 Windows 设置 CLI，请执行以下步骤：

  1. 在 “开始” 菜单中，搜索 “添加或删除程序”。

  2. 选择名为的条目Amazon SAMCommand Line Interface然后选择卸载来启动卸载程序。

  3. 确认您要卸载 Amazon SAM CLI。

每晚构建

每晚构建Amazon SAMCLI 可供你安装。安装完成后，您可以使用每晚使用sam-nightly命令。您可以安装和使用Amazon SAM同时提交 CLI。

每晚版本包含一个预发布版Amazon SAMCLI 代码可能不如生产版本稳定。请注意，夜间构建不包含构建映像的预发行版本，因此使用--use-container选项使用构建映像的最新生产版本。

这个下载链接可以使用每晚版本：Amazon SAMCLI 每晚构建. 要安装的夜间构建版Amazon SAMCLI、执行与第 4 步：安装Amazon SAMCLI本主题前面的部分，但请改用每晚构建下载链接。

要验证你是否安装了夜间构建版本，请运行sam-nightly --version命令。此命令的输出采用格式1.X.Y.dev<YYYYMMDDHHmm>例如：

SAM CLI, version 1.20.0.dev202103151200

后续步骤

现在，您可以使用以下内容来构建自己的无服务器应用程序Amazon SAM！如果您想从示例无服务器应用程序开始，请选择下列链接之一：