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

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

在 AWS SAM 上安装 macOS CLI

按照以下步骤在您的 AWS SAM 主机上使用 macOS 命令行界面 (CLI) 的先决条件:

  1. 创建一个 AWS 账户。

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

  3. 安装 Docker. 注意: Docker 只是本地测试应用程序的先决条件。

  4. 安装 Homebrew.

  5. 安装 AWS SAM CLI。

步骤 1:创建 AWS 账户

如果您还没有 AWS 账户,请参阅www.amazonaws.cn并选择创建 AWS 账户。有关详细说明,请参阅如何创建并激活新的 AWS 账户?

步骤 2:配置 IAM 权限和 AWS 凭证

与 IAM 结合使用的 AWS SAM 用户必须具有足够的权限,才能进行必要的 AWS 服务调用和管理 AWS 资源。要确保用户拥有足够的权限,最简单的方法是授予用户管理员权限。有关更多信息,请参阅 中的IAM创建您的第一个 管理员用户和组。IAM 用户指南

注意

如果您不想向使用 AWS Command Line Interface (AWS CLI) 的用户授予管理员权限,则可向这些用户授予一组有限的权限。有关更多信息,请参阅Permissions

此外,要使 AWS SAM CLI 能够进行 AWS 服务调用,您必须设置 AWS 凭证。有关更多信息,请参阅设置AWS凭据

步骤 3:安装 Docker

注意

Docker 只是用于在本地测试应用程序以及使用 --use-container 标志构建部署程序包的先决条件。如果您最初不打算使用这些功能,则可以跳过此部分,或稍后安装 Docker。

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

要使用 AWS SAM CLI 在本地运行无服务器项目和函数,您必须已安装并能够正常工作 Docker。CLI 使用 AWS SAM 环境变量联系 Docker 守护程序。DOCKER_HOST以下步骤介绍如何安装、配置和验证 Docker 安装以与 AWS SAM CLI 结合使用。

  1. 安装 Docker

    CLI 支持在 AWS SAM Sierra 10.12 或更高版本上运行的 Docker。macOS要安装 Docker,请参阅安装 Docker Desktop for Mac

  2. 配置共享驱动器

    CLI 要求在共享驱动器中列出项目目录或任何父目录。AWS SAM要在 macOS 上共享驱动器,请参阅 文件共享

  3. 验证安装

    安装 Docker 后,请验证其是否正常运行。此外,确认您可以从命令行运行 Docker 命令(例如,docker ps)。您无需安装、提取或提取任何容器– CLI 会根据需要自动执行此操作。–AWS SAM

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

步骤 4:安装 Homebrew

在 AWS SAM 上安装 macOS 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:安装 AWS SAM CLI

按照以下步骤使用 AWS SAM 安装 CLI Homebrew:

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

验证安装:

sam --version

在成功安装 AWS SAM CLI 后,您应看到类似以下内容的输出:

 
 SAM CLI, version 1.15.0

您现在已准备好开始开发。

Upgrading

要升级 AWS SAM CLI,您仍使用 Homebrew,但将 install 替换为 upgrade,如下所示:

brew upgrade aws-sam-cli

后续步骤

现在,您已准备好开始使用 AWS SAM 构建自己的无服务器应用程序! 如果要从示例无服务器应用程序开始,请选择以下链接之一: