安装AWS SAMmacOS 上的 CLI - AWS Serverless Application Model

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

安装AWS SAMmacOS 上的 CLI

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

  1. 创建一个 AWS 账户。

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

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

  4. 安装 Homebrew。

  5. 安装 AWS SAM CLI。

第 1 步:创建 AWS 账户

如果您还没有AWS帐户,请参阅aws.amazon.com并选择创建AWS账户。有关详细说明,请参阅如何创建和激活新的AWS账户?

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

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

注意

如果您不想将管理员权限授予使用AWS Command Line Interface(AWS CLI),您可以向它们授予受限制的权限集。有关更多信息,请参阅Permissions

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

第 3 步:安装 Docker(可选)

注意

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

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

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

  1. 安装 Docker

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

  2. 配置共享驱动器

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

  3. 验证安装

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

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

第 4 步:安装 Homebrew

推荐的安装AWS 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 步:安装AWS SAMCLI

请按照以下步骤安装AWS SAMCLI 使用Homebrew:

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

验证安装:

sam --version

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

 
 SAM CLI, version 1.15.0

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

Upgrading

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

brew upgrade aws-sam-cli

Uninstalling

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

brew uninstall aws-sam-cli

每晚构建

一个夜间构建的AWS SAMCLI 可供您安装。安装后,您可以使用sam-nightly命令。您可以安装和使用生产版本和夜间构建版本的AWS SAM同时提交 CLI。

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

要安装夜间构建版本的AWS 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

后续步骤

现在,您可以使用AWS SAM!如果要从无服务器应用程序示例开始,请选择以下链接之一: