安装Amazon SAMmacOS 上的 CLI - Amazon Serverless Application Model
第 1 步：创建 Amazon 账户第 2 步：配置 IAM 权限和Amazon证书第 3 步：安装 Docker（可选）第 4 步：安装 Homebrew第 5 步：安装Amazon SAMCLI升级卸载每晚构建后续步骤
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！如果您要从示例无服务器应用程序开始，请选择以下链接之一：