安装 AWS SAM CLI - AWS Serverless Application Model
安装 AWS SAM CLI故障排除后续步骤

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

安装 AWS SAM CLI

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

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

这是您第一次安装 AWS SAM CLI？

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

  1. 注册一个 AWS 账户。

  2. 创建管理 IAM 用户。

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

  4. 正在安装 AWS CLI.

  5. 配置 AWS 凭证。

安装 AWS SAM CLI

注意

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

  • 要继续使用 Homebrew，您可以使用社区托管的安装程序。有关更多信息，请参阅使用 Homebrew 管理 AWS SAM CLI。

  • 我们建议使用本页中记录的第一方安装方法之一。在使用其中一种方法之前，请参阅 从 Homebrew 切换。

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

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

    $ sudo ./sam-installation/install

  5. 验证安装。

    $ sam --version

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

     SAM CLI, <latest version>
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. 通过运行 install 可执行文件安装 AWS SAM CLI。该可执行文件位于上一步骤中使用的目录中。以下是使用 sam-installation 子目录的示例：

    $ sudo ./sam-installation/install

  5. 验证安装。

    $ sam --version

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

     SAM CLI, <latest version>

使用软件包安装程序安装 AWS SAM CLI。

注意

软件包安装程序在 x86_64 和 arm64 选项中可用。选择与您的 Mac 硬件相匹配的套餐：

  • x86_64：用于 Macs 运行 Intel 处理器。

  • arm64：用于 Macs 运行 Apple 硅芯片。

有关更多信息，请参阅带 Apple 硅芯片的 Mac 计算机。

使用软件包安装程序

软件包安装程序提供两种安装方法让您选择：

  1. GUI

  2. 命令行

您可以为所有用户安装，也可以只为当前用户安装。要为所有用户安装，需要获得超级用户授权。

安装步骤

使用以下任一选项安装 AWS SAM CLI。

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

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

验证软件包安装程序（可选）
要安装 AWS SAM CLI

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

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

  3. 在安装类型中，选择 AWS SAM CLI 要安装的位置，然后按下安装。推荐的默认位置是 /usr/local/aws-sam-cli。

    注意

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

  4. AWS SAM CLI 将进行安装，系统将显示安装成功消息。按下关闭。

验证安装是否成功

  • 通过运行以下命令验证 AWS SAM CLI 是否已正确安装以及符号链接是否已配置：

    $ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
GUI - Current user
要下载软件包安装程序
注意

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

验证软件包安装程序（可选）
要安装 AWS SAM CLI

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

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

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

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

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

    3. 按下安装。

  4. AWS SAM CLI 将进行安装，系统将显示安装成功消息。按下关闭。

要创建符号链接

  • 要使用 sam 命令调用 AWS SAM CLI，您必须在 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
要下载软件包安装程序
注意

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

验证软件包安装程序（可选）
要安装 AWS SAM CLI

  • 修改并运行安装脚本：

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

    要使用 sam 命令调用 AWS SAM CLI，安装程序会自动在 /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
要下载软件包安装程序
注意

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

验证软件包安装程序（可选）
要安装 AWS SAM CLI

  1. 确定您有写入权限的安装目录。然后，使用模板创建 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>

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

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

    输出应显示将应用于 AWS SAM CLI 程序的首选项。

  3. 运行以下命令来安装 AWS SAMCLI：

    $ 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.
要创建符号链接

  • 要使用 sam 命令调用 AWS SAM CLI，您必须在 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 操作系统的软件包安装程序文件。

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

  1. 下载 AWS SAM CLI 64 位版本。

    注意

    如果您使用的是 32 位版本的 Windows，请参阅 在 32 位 Windows 上安装 AWS SAM CLI。

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

  3. 验证安装。

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

    sam --version

    成功安装后 AWS SAMCLI，您应该会看到如下输出：

    SAM CLI, <latest version>

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

    重要

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

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

  5. 安装 Git。

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

故障排除

如果您在安装时遇到问题 AWS SAMCLI，请参阅安装错误。

后续步骤

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