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

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

安装Amazon SAMmacOS 上的 CLI

请按照以下步骤安装和配置使用Amazon SAM命令行界面 (CLI):

  1. 创建一个 Amazon 账户。

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

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

  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),您可以向它们授予受限制的权限集。有关更多信息,请参阅Permissions

此外,要启用Amazon SAMCLIAmazon服务调用时,您必须设置Amazon凭证。有关更多信息,请参阅设置Amazon凭证

第 3 步:安装 Docker(可选)

注意

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

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

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

  1. 安装 Docker

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

  2. 配置共享驱动器

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

  3. 验证安装

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

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

第 4 步:安装 Homebrew

推荐的安装Amazon SAMCLI 是在 macOS 上使用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 SAMCLI 使用Homebrew:

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

验证安装:

sam --version

成功安装后,将会看到类似如下的输出。Amazon SAMCLI:

 
 SAM CLI, version 1.15.0

现在您已准备就绪,可以开始开发了。

Upgrading

升级Amazon SAMCLI,使用Homebrew,运行以下命令:

brew upgrade aws-sam-cli

Uninstalling

卸载Amazon SAMCLI,使用Homebrew,运行以下命令:

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