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

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

在 Linux 上安装 AWS SAM CLI

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

  1. 创建一个 AWS 账户。

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

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

  4. 安装 Homebrew.

  5. 安装 AWS SAM CLI。

注意

按照以下说明操作,将您的环境的默认 Python 版本更改为 Homebrew 安装。此更改发生在 步骤 4:安装 Homebrew 中。

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

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

Docker 适用于许多不同的操作系统,包括大多数现代 Linux 发行版,例如 CentOS、Debian 和 Ubuntu。有关在特定操作系统上安装 Docker 的信息,请参阅 Docker 文档网站上的获取 Docker

如果您使用的是 Amazon Linux 2,请按照以下步骤安装 Docker:

  1. 更新实例上已安装的程序包和程序包缓存。

    sudo yum update -y
  2. 安装最新的 Docker Community Edition 程序包。

    sudo amazon-linux-extras install docker
  3. 启动 Docker 服务。

    sudo service docker start
  4. ec2-user 添加到 docker 组,以便您无需使用 sudo 即可运行 Docker 命令。

    sudo usermod -a -G docker ec2-user
  5. 退出,再重新登录以接受新的 docker 组权限。为此,您可以关闭当前 SSH 终端窗口,然后在新窗口中重新连接到实例。您的新 SSH 会话将具有相应的 docker 组权限。

  6. 验证 ec2-user 能否在不使用 sudo 的情况下运行 Docker 命令。

    docker ps

    您应看到以下输出,确认 Docker 已安装且正在运行:

     
     CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
                    

如果您在安装 Docker 时遇到问题,请参阅本指南后面的Troubleshooting部分。或者,请参阅 Docker 文档网站上 Linux 安装后步骤故障排除部分。

步骤 4:安装 Homebrew

注意

此步骤将您的环境的默认 Python 版本更改为 Homebrew 安装。

要在 Linux 上安装 AWS SAM CLI,我们建议使用 Homebrew 程序包管理器。有关 Homebrew,请参阅Homebrew (在 Linux 上),在 上 Homebrew 文档网站。

安装 Homebrew,则必须先安装 Git。Git 可用于许多不同的操作系统,包括大多数现代 Linux 发行版。有关在特定操作系统上安装 Git 的说明,请参阅 Git 网站上的安装 Git

成功安装 Git 后,安装 Homebrew,运行以下命令:

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

接下来,添加 Homebrew 通过运行以下命令来更改为您的 PATH。这些命令在 Debian 和 Ubuntu 上添加 ~/.profile,或在 ~/.bash_profile、Fedora 和 CentOS 上添加 RedHat,可用于 Linux 的所有主要风格。

test -d ~/.linuxbrew && eval $(~/.linuxbrew/bin/brew shellenv) test -d /home/linuxbrew/.linuxbrew && eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv) test -r ~/.bash_profile && echo "eval \$($(brew --prefix)/bin/brew shellenv)" >>~/.bash_profile echo "eval \$($(brew --prefix)/bin/brew shellenv)" >>~/.profile

验证 。Homebrew 已安装。

brew --version

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

 
 Homebrew 2.1.6 
 Homebrew/homebrew-core (git revision ef21; last commit 2019-06-19)
        

步骤 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

Troubleshooting

Docker 错误:“无法连接到 Docker 守护程序。docker 守护程序是否正在此主机上运行?”

在某些情况下,要为 ec2-user 提供权限以访问 Docker 守护程序,您可能需要重启实例。如果您收到此错误,请尝试重启实例。

Shell 错误:“找不到命令”

如果您收到此错误,则 Shell 无法在路径中找到 AWS SAM CLI 可执行文件。验证安装 AWS SAM CLI 可执行文件的目录的位置,然后验证该目录是否在您的路径上。

例如,如果您使用了本主题中的说明来同时安装 Homebrew 并使用 Homebrew 以安装 AWS SAM CLI,则 AWS SAM CLI 可执行文件将安装到以下位置:

  
 /home/linuxbrew/.linuxbrew/bin/sam
        

后续步骤

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