安装Amazon SAMmacOS 上的 CLI - Amazon Serverless Application Model
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

安装Amazon SAMmacOS 上的 CLI

执行以下步骤可安装和配置使用Amazon SAMmacOS 主机上的命令行界面 (CLI):

  1. 创建一个 Amazon 账户。

  2. 配置Amazon Identity and Access Management(IAM) 权限和Amazon凭证。

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

  4. 安装 Homebrew。

  5. 安装 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 是一款在 macOS 计算机上运行容器的应用程序。Amazon SAM提供的本地环境类似于Amazon Lambda用作 Docker 容器。您可以使用此容器构建、测试和调试无服务器应用程序。

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

  1. 安装 Docker

    这些区域有:Amazon SAMCLI 支持在 macOS Sierra 10.12 或更高版本上运行的 Docker。要安装 Docker,请参阅安装适用于 Mac 的 Docker 桌面.

  2. 配置共享驱动器

    这些区域有:Amazon SAMCLI 要求项目目录或任何父目录都列在共享驱动器中。要在 macOS 上共享驱动器,请参阅文件共享.

  3. 验证安装

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

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

第 4 步:安装 Homebrew

推荐的安装方法Amazon SAMmacOS 上的 CLI 是使用Homebrew程序包管理器。有关 Homebrew 的更多信息,请参阅 Homebrew 文档

安装Homebrew,您必须首先安装 Git。有关 Git 的更多信息,请参阅Git 文档. Git 适用于许多不同的操作系统,包括 macOS。有关在特定操作系统上安装 Git 的说明,请参阅安装 Git.

成功安装 Git 后,运行以下命令进行安装Homebrew,确保按照提示进行操作:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

确认 。Homebrew已安装:

brew --version

在成功安装时,您应看到类似下面的输出,类似于Homebrew:

 
 Homebrew 2.5.7
 Homebrew/homebrew-core (git revision 1be3ad; last commit 2020-10-29)
 Homebrew/homebrew-cask (git revision a0cf3; last commit 2020-10-29)
        

第 5 步:安装Amazon SAMCLI

按照以下步骤安装Amazon SAM使用 CLIHomebrew:

brew tap aws/tap brew install aws-sam-cli

验证安装:

sam --version

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

 
 SAM CLI, version 1.35.0

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

升级

升级Amazon SAM使用 CLIHomebrew中,运行以下命令:

brew upgrade aws-sam-cli

卸载

卸载Amazon SAM使用 CLIHomebrew中,运行以下命令:

brew uninstall aws-sam-cli

每晚构建

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

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

要安装的每晚构建版本Amazon SAMCLI、运行以下命令:

brew tap aws/tap brew install aws-sam-cli-nightly

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

SAM CLI, version 1.20.0.dev202103151200

后续步骤

现在,您可以使用此方式开始构建自己的无服务器应用程序Amazon SAM!如果您要从示例无服务器应用程序开始,请选择以下链接之一: