安装Amazon SAM在 Windows 上执行 CLI - Amazon Serverless Application Model
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),您可以向他们授予受限的权限集。有关更多信息,请参阅Permissions

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

第 3 步:安装 Docker(可选)

注意

Docker 只是在本地测试应用程序以及使用--use-container选项。如果您最初不打算使用这些功能,可以跳过本部分或稍后安装 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 SAM使用 MSI 文件的 CLI。

  1. 安装Amazon SAMCLI64 位.

    注意

    如果你在 32 位系统上运行,请参阅安装Amazon SAMCLI 在 32 位 Windows 上.

  2. 验证安装。

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

    sam --version

    成功安装后,您应看到类似下面的输出:Amazon SAMCLI:

     
     SAM CLI, version 1.15.0
                    
  3. 安装 Git。

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

现在,您已准备好启动开发了。

Uninstalling

卸载Amazon SAMCLI 使用 Windows 设置,请执行以下步骤:

  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!如果您要从示例无服务器应用程序开始,请选择下列链接之一: