安装   AWS SAM CLI - AWS Serverless Application Model
安装   AWS SAM CLI排查 安装错误后续步骤

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

安装   AWS SAM CLI

安装最新版本的 AWS Serverless Application Model 命令行界面 (AWS SAM CLI) 在支持的操作系统上。

有关管理当前安装版本的信息 AWS SAM CLI，包括如何升级、卸载或管理夜间版本，请参阅管理 AWS SAM CLI 版本。

这是你第一次安装吗 AWS SAM CLI?

在继续操作之前，请完成上一节中的所有先决条件。这包括：

  1. 报名参加 AWS account。

  2. 创建管理IAM用户。

  3. 创建访问密钥 ID 和秘密访问密钥。

  4. 安装   AWS CLI.

  5. 配置 AWS 证书。

主题

安装   AWS SAM CLI

注意

从 2023 年 9 月开始， AWS 将不再维护 AWS 托管式 Homebrew 的安装程序 AWS SAM CLI (aws/tap/aws-sam-cli)。 如果你使用 Homebrew 安装和管理 AWS SAM CLI，请参阅以下选项：

要安装   AWS SAM CLI，请按照您的操作系统的说明进行操作。

x86_64 - command line installer

  1. 下载 AWS SAM CLI .zip 文件到您选择的目录中。

  2. （可选）您可以在安装前验证安装程序的完整性。有关说明，请参阅 可选：验证的完整性 AWS SAM CLI 安装程序。

  3. 将安装文件解压缩到您选择的目录中。以下是使用 sam-installation 子目录的示例。

    注意

    如果您的操作系统没有内置的 unzip 命令，请使用等效命令。

    $ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation

  4. 安装   AWS SAM CLI 通过运行install可执行文件。该可执行文件位于上一步骤中使用的目录中。以下是使用 sam-installation 子目录的示例：

    $ sudo ./sam-installation/install

  5. 验证安装。

    $ sam --version

    要确认安装成功，您应该会看到一个输出，该输出将以下方括号内的文本替换为最新的可用版本：

     SAM CLI, <latest version>
arm64 - command line installer

  1. 下载 AWS SAM CLI .zip 文件到您选择的目录中。

  2. （可选）您可以在安装前验证安装程序的完整性。有关说明，请参阅 可选：验证的完整性 AWS SAM CLI 安装程序。

  3. 将安装文件解压缩到您选择的目录中。以下是使用 sam-installation 子目录的示例。

    注意

    如果您的操作系统没有内置的 unzip 命令，请使用等效命令。

    $ unzip aws-sam-cli-linux-arm64.zip -d sam-installation

  4. 安装   AWS SAM CLI 通过运行install可执行文件。该可执行文件位于上一步骤中使用的目录中。以下是使用 sam-installation 子目录的示例：

    $ sudo ./sam-installation/install

  5. 验证安装。

    $ sam --version

    要确认安装成功，您应该会看到如下所示的输出，但其中用最新版本SAMCLI替换了方括号内的文本：

     SAM CLI, <latest version>

安装步骤

使用软件包安装程序安装 AWS SAM CLI。 此外，软件包安装程序有两种安装方法可供选择：GUI和命令行。您可以为所有用户安装，也可以只为当前用户安装。要为所有用户安装，需要获得超级用户授权。

GUI - All users
要下载软件包安装程序并安装 AWS SAM CLI
注意

如果您之前安装了 AWS SAM CLI 通过 Homebrew 或者 pip，你需要先将其卸载。有关说明，请参阅 卸载 AWS SAM CLI。

  1. 将 macOS 下载pkg到你选择的目录中：

    注意

    在安装之前，您可以选择验证安装程序的完整性。有关说明，请参阅 可选：验证的完整性 AWS SAM CLI 安装程序。

  2. 运行您下载的文件，然后按照屏幕上的说明继续完成简介、自述和许可步骤。

  3. 在目标选择中，选择为这台计算机的所有用户安装。

  4. 在 “安装类型” 中，选择安装位置 AWS SAM CLI 将安装并按安装。推荐的默认位置是 /usr/local/aws-sam-cli。

    注意

    要调用 AWS SAM CLI 使用该sam命令，安装程序会自动在/usr/local/bin/sam和/usr/local/aws-sam-cli/sam或您选择的安装文件夹之间创建符号链接。

  5. 这些区域有： AWS SAM CLI 将安装并显示安装成功消息。按下关闭。

验证安装是否成功

  • 确认 AWS SAM CLI 已正确安装，并且您的符号链接已通过运行以下命令进行配置：

    $ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
GUI - Current user
要下载并安装 AWS SAM CLI
注意

如果您之前安装了 AWS SAM CLI 通过 Homebrew 或者 pip，你需要先将其卸载。有关说明，请参阅 卸载 AWS SAM CLI。

  1. 将 macOS 下载pkg到你选择的目录中：

    注意

    在安装之前，您可以选择验证安装程序的完整性。有关说明，请参阅 可选：验证的完整性 AWS SAM CLI 安装程序。

  2. 运行您下载的文件，然后按照屏幕上的说明继续完成简介、自述和许可步骤。

  3. 对于目标选择，选择仅为我安装。如果没有看到此选项，请转到下一步。

  4. 对于安装类型，请执行以下操作：

    1. 选择在哪里 AWS SAM CLI 将被安装。默认位置是 /usr/local/aws-sam-cli。选择您拥有写入权限的位置。要更改安装位置，请选择本地并选择您的位置。完成后按下继续。

    2. 如果您在上一步中没有看到仅为我安装的选项，请选择更改安装位置 > 仅为我安装，然后按下继续。

    3. 按下安装。

  5. 这些区域有： AWS SAM CLI 将安装并显示安装成功消息。按下关闭。

要创建符号链接

  • 要调用 AWS SAM CLI 使用该sam命令，您必须手动在之间创建符号链接 AWS SAM CLI 程序和你的$PATH。通过修改并运行以下命令来创建符号链接：

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam

    • sudo — 如果您的用户具有写入权限$PATH，则sudo不是必需的。否则，sudo 是必需的。

    • path-to — 指向安装位置的路径 AWS SAM CLI 节目。例如，/Users/myUser/Desktop。

    • path-to-symlink-directory — 您的$PATH环境变量。默认位置是 /usr/local/bin。

验证安装是否成功

  • 确认 AWS SAM CLI 已正确安装，并且您的符号链接已通过运行以下命令进行配置：

    $ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
Command line - All users
要下载并安装 AWS SAM CLI
注意

如果您之前安装了 AWS SAM CLI 通过 Homebrew 或者 pip，你需要先将其卸载。有关说明，请参阅 卸载 AWS SAM CLI。

  1. 将 macOS 下载pkg到你选择的目录中：

    注意

    在安装之前，您可以选择验证安装程序的完整性。有关说明，请参阅 可选：验证的完整性 AWS SAM CLI 安装程序。

  2. 修改并运行安装脚本：

    $ sudo installer -pkg path-to-pkg-installer/name-of-pkg-installer -target /
installer: Package name is AWS SAM CLI
installer: Upgrading at base path /
installer: The upgrade was successful.
    注意

    要调用 AWS SAM CLI 使用该sam命令，安装程序会自动在/usr/local/bin/sam和/usr/local/aws-sam-cli/sam之间创建符号链接。

验证安装是否成功

  • 确认 AWS SAM CLI 已正确安装，并且您的符号链接已通过运行以下命令进行配置：

    $ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
Command line - Current user
要下载并安装 AWS SAM CLI
注意

如果您之前安装了 AWS SAM CLI 通过 Homebrew 或者 pip，你需要先将其卸载。有关说明，请参阅 卸载 AWS SAM CLI。

  1. 将 macOS 下载pkg到你选择的目录中：

    注意

    在安装之前，您可以选择验证安装程序的完整性。有关说明，请参阅 可选：验证的完整性 AWS SAM CLI 安装程序。

  2. 确定您有写入权限的安装目录。然后，使用模板创建 xml 文件并对其进行修改以反映您的安装目录。目录必须已经存在。

    例如，如果你替换 path-to-my-directory 使用/Users/myUser/Desktop，aws-sam-cli程序文件夹将安装在那里。

    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <array>
    <dict>
      <key>choiceAttribute</key>
      <string>customLocation</string>
      <key>attributeSetting</key>
      <string>path-to-my-directory</string>
      <key>choiceIdentifier</key>
      <string>default</string>
    </dict>
  </array>
</plist>

  3. 保存 xml 文件并通过运行以下命令验证其是否有效：

    $ installer -pkg path-to-pkg-installer \
-target CurrentUserHomeDirectory \
-showChoicesAfterApplyingChangesXML path-to-your-xml-file

    输出应显示将应用于 AWS SAM CLI 节目。

  4. 运行以下命令来安装 AWS SAM CLI: 

    $ installer -pkg path-to-pkg-installer \
-target CurrentUserHomeDirectory \
-applyChoiceChangesXML path-to-your-xml-file

# Example output
installer: Package name is AWS SAM CLI
installer: choices changes file 'path-to-your-xml-file' applied
installer: Upgrading at base path base-path-of-xml-file
installer: The upgrade was successful.
要创建符号链接

  • 要调用 AWS SAM CLI 使用该sam命令，您必须手动在之间创建符号链接 AWS SAM CLI 程序和你的$PATH。通过修改并运行以下命令来创建符号链接：

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam

    • sudo — 如果您的用户具有写入权限$PATH，则sudo不是必需的。否则，sudo 是必需的。

    • path-to — 指向安装位置的路径 AWS SAM CLI 节目。例如，/Users/myUser/Desktop。

    • path-to-symlink-directory — 您的$PATH环境变量。默认位置是 /usr/local/bin。

验证安装是否成功

  • 确认 AWS SAM CLI 已正确安装，并且您的符号链接已通过运行以下命令进行配置：

    $ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>

Windows 安装程序 (MSI) 文件是 Windows 操作系统的软件包安装程序文件。

按照以下步骤安装 AWS SAM CLI 使用该MSI文件。

  1. 下载 AWS SAM CLI 64 位。

  2. （可选）您可以在安装前验证安装程序的完整性。有关说明，请参阅 可选：验证的完整性 AWS SAM CLI 安装程序。

  3. 验证安装。

    安装完成后，打开新的命令提示符或 PowerShell 提示符进行验证。您应该能够从命令行调用 sam。

    sam --version

    成功安装之后 AWS SAM CLI，你应该会看到如下输出：

    SAM CLI, <latest version>

  4. 启用长路径（仅限 Windows 10 及更高版本）。

    重要

    这些区域有： AWS SAM CLI 可能会与超过 Windows 最大路径限制的文件路径进行交互。sam init由于 Windows 10 的MAX_PATH限制，这可能会在运行时导致错误。若要解决此问题，必须配置新的长路径行为。

    要启用长路径，请参阅 Microsoft Windows 应用程序开发文档中的在 Windows 10 版本 1607 及更高版本中启用长路径。

  5. 安装 Git。

    要使用 sam init 命令下载示例应用程序，还必须安装 Git。有关说明，请参见安装 Git。

排查 安装错误

Linux

Docker 错误：“无法连接到 Docker 进程守护程序。Docker 进程守护程序是否在此主机上运行？”

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

Shell 错误：“找不到命令”

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

AWS SAM CLI 错误：“/lib64/libc.so.6：找不到版本 `GLIBC_2.14'（/usr/local/ /dist/libz.so.1 要求）” aws-sam-cli

如果您收到此错误，则表示您使用的是不受支持的 Linux 版本，并且内置的 glibc 版本已过时。请尝试以下任一方法：

  • 将您的 Linux 主机升级到最新的 64 位 CentOS、Fedora、Ubuntu 或 Amazon Linux 2 发行版。

  • 按照 安装   AWS SAM CLI 的说明进行操作。

macOS

安装失败

的图片 AWS SAM CLI 安装程序显示安装失败消息

如果你正在安装 AWS SAM CLI 对于您的用户并选择了您没有写入权限的安装目录，可能会出现此错误。请尝试以下任一方法：

  1. 选择您具有写入权限的其他安装目录。

  2. 删除安装程序。然后重新下载并运行安装程序。

后续步骤

要了解有关... 的更多信息 AWS SAM CLI 要开始构建自己的无服务器应用程序，请参阅以下内容：