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

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

安装 Amazon SAM CLI

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

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

这是您第一次安装 Amazon SAM CLI?

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

  1. 注册一个 Amazon 账户。

  2. 创建管理 IAM 用户。

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

  4. 正在安装 Amazon CLI.

  5. 配置 Amazon 凭证。

安装 Amazon SAM CLI

注意

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

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

arm64 - command line installer
  1. Amazon SAM CLI .zip 文件下载到所选目录。

  2. (可选)您可以在安装前验证安装程序的完整性。有关说明,请参阅验证 Amazon SAM CLI 安装程序的完整性

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

    注意

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

    $ unzip aws-sam-cli-linux-arm64.zip -d sam-installation
  4. 通过运行 install 可执行文件安装 Amazon SAM CLI。该可执行文件位于上一步骤中使用的目录中。以下是使用 sam-installation 子目录的示例:

    $ sudo ./sam-installation/install
  5. 验证安装。

    $ sam --version

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

     SAM CLI, <latest version>
x86_64 - command line installer
  1. Amazon SAM CLI .zip 文件下载到所选目录。

  2. (可选)您可以在安装前验证安装程序的完整性。有关说明,请参阅验证 Amazon SAM CLI 安装程序的完整性

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

    注意

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

    $ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
  4. 通过运行 install 可执行文件安装 Amazon SAM CLI。该可执行文件位于上一步骤中使用的目录中。以下是使用 sam-installation 子目录的示例:

    $ sudo ./sam-installation/install
  5. 验证安装。

    $ sam --version

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

     SAM CLI, <latest version>

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

注意

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

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

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

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

使用软件包安装程序

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

  1. GUI

  2. 命令行

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

安装步骤

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

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

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

验证软件包安装程序(可选)
要安装 Amazon SAM CLI
  1. 运行您下载的文件,然后按照屏幕上的说明继续完成简介自述许可步骤。

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

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

    注意

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

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

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

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

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

验证软件包安装程序(可选)
要安装 Amazon SAM CLI
  1. 运行您下载的文件,然后按照屏幕上的说明继续完成简介自述许可步骤。

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

  3. 对于安装类型,请执行以下操作:

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

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

    3. 按下安装

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

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

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
    • sudo – 如果您的用户具有 $PATH 写入权限,则无需 sudo。否则,sudo 是必需的。

    • path-to – Amazon SAM CLI 程序安装位置的路径。例如,/Users/myUser/Desktop

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

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

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>
Command line - All users
要下载软件包安装程序
注意

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

验证软件包安装程序(可选)
要安装 Amazon 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 命令调用 Amazon SAM CLI,安装程序会自动在 /usr/local/bin/sam/usr/local/aws-sam-cli/sam 之间创建符号链接。

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

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

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

验证软件包安装程序(可选)
要安装 Amazon 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

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

  3. 运行以下命令来安装 Amazon 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 命令调用 Amazon SAM CLI,您必须在 Amazon SAM CLI 程序和您的 $PATH 之间手动创建符号链接。通过修改并运行以下命令来创建符号链接:

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
    • sudo – 如果您的用户具有 $PATH 写入权限,则无需 sudo。否则,sudo 是必需的。

    • path-to – Amazon SAM CLI 程序安装位置的路径。例如,/Users/myUser/Desktop

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

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

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

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

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

  1. 下载 Amazon SAM CLI 64 位版本

    注意

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

  2. (可选)您可以在安装前验证安装程序的完整性。有关说明,请参阅验证 Amazon SAM CLI 安装程序的完整性

  3. 验证安装。

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

    sam --version

    成功安装后 Amazon SAMCLI,您应该会看到如下输出:

    SAM CLI, <latest version>
  4. 启用长路径(仅限 Windows 10 及更高版本)。

    重要

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

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

  5. 安装 Git。

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

故障排除

如果您在安装时遇到问题 Amazon SAMCLI,请参阅安装错误

后续步骤

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