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

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

安装 AWS SAM Linux上的CLI

以下步骤可帮助您安装和配置使用 AWS SAM Linux主机上的CLI:

  1. 创建 AWS 账户。

  2. 配置 IAM 权限。

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

  4. 安装Homebrew。

  5. 安装 AWS SAM CLI。

注意

这些说明使环境的默认Python版本成为Homebrew安装的版本。默认Python版本的更改发生在 第4步: 安装主螺杆.

第1步: 创建 AWS 账户

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

第2步: 创建 IAM 具有管理员权限的用户

如果您还没有 IAM 具有管理员权限的用户,请参阅 创建您的第一个IAM管理员用户和组IAM 用户指南.

此外,您必须设置AWS凭证以启用 AWS SAM CLI将调用AWS服务。例如, AWS SAM CLI拨打呼叫至 Amazon S3 和 AWS CloudFormation. 有关设置AWS凭证的更多信息,请参阅 设置AWS凭据.

第3步: 安装 Docker

注意

Docker只是在本地测试应用程序和使用 --use-container 标记。如果您最初未计划使用这些功能,则可以跳过此部分或稍后安装Docker。

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

您必须安装Docker并工作,才能在本地使用运行无服务器项目和功能 AWS SAM CLI。的 AWS SAM CLI使用 DOCKER_HOST 环境变量,以联系Docker守护程序。以下步骤描述了如何安装、配置和验证Docker安装,以使用 AWS SAM CLI。

Docker可用于许多不同的操作系统,包括最现代化的Linux发行版,如 CentOS、Debian、Ubuntu等。有关如何在特定的操作系统上安装 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 组,以便您能够执行 Docker 命令,而无需使用 sudo

    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
                    
    注意

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

    Cannot connect to the Docker daemon. Is the docker daemon running on this host?

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

第4步: 安装主螺杆

注意

此步骤使您的环境的默认Python版本由Homebrew安装。

推荐的安装方法 AWS SAM Linux上的CLI将使用Homebrew包管理器。有关Homebrew的更多信息,请参阅 内花文档.

要安装Homebrew,您必须首先安装Git。有关Git的更多信息,请参阅 Git文档. Git可用于许多不同的操作系统,包括最现代的Linux发行版。有关在特定操作系统上安装Git的说明,请参阅 安装Git.

成功安装Git后,运行以下程序以安装Homebrew:

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

接下来,通过运行以下命令,将Homebrew添加到您的PATH。这些命令通过添加 ~/.profile 在Debian/Ubuntu上,或 ~/.bash_profile 于 CentOS/Fedora/红牛:

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 使用Homebrew的CLI:

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

验证安装:

sam --version

在成功安装 AWS SAM CLI区:

 
 SAM CLI, version 1.3.0

您现在可以开始开发了。

Upgrading

要升级 AWS SAM CLI,您仍然使用Homebrew,但替换 installupgrade 如下:

brew upgrade aws-sam-cli

Troubleshooting

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

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

Shell错误:“找不到命令”

您的外壳无法找到 AWS SAM 路径中的CLI可执行文件。如果收到此错误,请验证目录的位置, AWS SAM 已安装CLI可执行文件,并验证目录位于路径上。

例如,如果您使用本主题中的说明来安装1)安装Homebrew,以及2)使用Homebrew安装 AWS SAM CLI,然后 AWS SAM CLI可执行文件将安装到以下位置:

  
 /home/linuxbrew/.linuxbrew/bin/sam
        

错误: "AWSSAMCLI不再支持Python2.7上的安装。"

您的系统正在使用与不相容的旧Python安装 AWS SAM CLI。如果收到此错误,请按照 安装 AWS SAM Linux上的CLI 安装兼容Python的版本 AWS SAM CLI。

后续步骤

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