管理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 SAM安装夜间版本。

升级 CAmazon SAM LI

要在 Linux 上升级 CLAmazon SAM I安装 Amazon SAM CLI,请按照中的安装说明进行操作,但在安装命令中添加--update选项,如下所示:

sudo ./sam-installation/install --update

通过用于安装Amazon SAM CLI 的相同服务升级 CLI。

Homebrew

要使用 macOS 上的Amazon SAM CLI 升级Homebrew,请运行以下命令:

$ brew upgrade aws-sam-cli
注意

要升级到Amazon SAM v1.70.1 或更高版本,我们建议brew upgrade aws/tap/aws-sam-cli改为运行。

Package 安装程序

要使用软件包安装程序升级Amazon SAM CLI,请安装最新的软件包版本。有关说明,请参阅 安装 Amazon SAM CLI

要升级Amazon SAM CLI,请安装 Amazon SAM CLI再次重复中的 Windows 安装步骤。

卸载Amazon SAM CLI

要在 Linux 上卸载 CLAmazon SAM I,必须通过运行以下命令删除符号链接和安装目录:

  1. 找到符号链接和安装路径。

    • 使用which以下命令查找符号链接:

      which sam

      输出显示Amazon SAM二进制文件所在的路径,例如:

       /usr/local/bin/sam
    • 使用ls命令查找符号链接指向的目录:

      ls -l /usr/local/bin/sam

      在以下示例中,安装目录为/usr/local/aws-sam-cli

       lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam
  2. 删除符号链接。

    sudo rm /usr/local/bin/sam
  3. 删除安装目录。

    sudo rm -rf /usr/local/aws-sam-cli

通过用于安装Amazon SAM CLI 的相同服务卸载 CLI。

Homebrew

如果Amazon SAM CLI 是使用Homebrew或安装的pip,请运行以下命令将其卸载:

$ pip uninstall aws-sam-cli && brew uninstall aws-sam-cli

运行以下命令验证Amazon SAM CLI 是否已卸载:

$ sam --version command not found: sam

Package 安装程序

如果Amazon SAM CLI 是使用软件包安装程序安装的,请使用以下命令将其卸载。

  1. 通过修改和运行以下命令删除Amazon SAM CLI 程序:

    $ sudo rm -rf /path-to/aws-sam-cli
    1. sudo — 如果您的用户对Amazon SAM CLI 程序的安装位置具有写入权限,sudo则不需要。否则,sudo 是必需的。

    2. /path-t o — 安装Amazon SAM CLI 程序的路径。默认位置是 /usr/local

  2. $PATH通过修改和运行以下Amazon SAM命令删除 CLI:

    $ sudo rm -rf /path-to-symlink-directory/sam
    1. sudo — 如果您的用户具有写入权限$PATHsudo则不需要。否则,sudo 是必需的。

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

  3. 运行以下命令验证Amazon SAM CLI 是否已卸载:

    $ sam --version command not found: sam

要使用 Windows 设置卸载Amazon SAM CLI,请按照以下步骤操作:

  1. 在 “开始” 菜单中,搜索 “添加或删除程序”。

  2. 选择名为 Amazon SAMCommand Line Interface 的结果,然后选择卸载以启动卸载程序。

  3. 确认您要卸载 Amazon SAM CLI。

安装 CAmazon SAM LI 夜间版本

您可以下载并安装Amazon SAM命令行界面的夜间版本。它包含Amazon SAM CLI 代码的预发行版本,该版本可能不如生产版本稳定。安装后,可以在sam-nightly命令中使用夜间构建。您可以同时安装和使用Amazon SAM CLI 的生产和夜间构建版本。

注意

夜间版本不包含构建映像的预发行版本。因此,使用该--use-container选项构建您的无服务器应用程序会使用构建映像的最新生产版本。

要安装Amazon SAM CLI 夜间版本,请按照以下说明进行操作。

Command line installer

夜间版本可通过以下下载链接获得:Amazon SAMCLI nightly build。要安装Amazon SAM CLI 的夜间编译版本,请执行与该安装 Amazon SAM CLI部分相同的步骤,但改用夜间编译下载链接。你可以在夜间构建的 Amazon SAMCLI 发行说明中找到夜间编译安装程序文件的哈希值 GitHub。

要验证您是否已安装夜间编译版本,请运行sam-nightly --version命令。此命令的输出格式为1.X.Y.dev<YYYYMMDDHHmm>,例如:

SAM CLI, version 1.20.0.dev202103151200
Homebrew

要在 Linux 上安装Amazon SAM CLI 的夜间编译版本Homebrew,请使用运行以下命令:

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

要验证您是否已安装夜间编译版本,请运行sam-nightly --version命令。此命令的输出格式为1.X.Y.dev<YYYYMMDDHHmm>,例如:

SAM CLI, version 1.20.0.dev202103151200

要在 macOS 上安装Amazon SAM CLI 的夜间编译版本Homebrew,请使用运行以下命令:

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

要验证您是否已安装夜间编译版本,请运行sam-nightly --version命令。此命令的输出格式为1.X.Y.dev<YYYYMMDDHHmm>,例如:

SAM CLI, version 1.20.0.dev202103151200

Amazon SAMCLI 的夜间构建版本可通过以下下载链接获得:CL Amazon SAMI nightly build。要在 Windows 上安装夜间版本,请执行与中相同的步骤安装 Amazon SAM CLI,但请改用夜间编译下载链接。

要验证您是否已安装夜间编译版本,请运行sam-nightly --version命令。此命令的输出格式为1.X.Y.dev<YYYYMMDDHHmm>,例如:

SAM CLI, version 1.20.0.dev202103151200

使用以下方法将Amazon SAM CLI 安装到虚拟环境中pip

我们建议使用原生软件包安装程序来安装Amazon SAM CLI。如果您必须使用pip,我们建议您将Amazon SAM CLI 安装到虚拟环境中。这样可以确保在出现错误时提供干净的安装环境和隔离的环境。

将Amazon SAM CLI 安装到虚拟环境中或进行操作
  1. 从您选择的起始目录中创建虚拟环境并命名它。

    Linux / macOS
    $ mkdir project $ cd project $ python3 -m venv venv
    Windows
    > mkdir project > cd project > py -3 -m venv venv
  2. 激活虚拟环境

    Linux / macOS
    $ . venv/bin/activate

    提示符更改为显示您的虚拟环境处于活动状态。

    (venv) $
    Windows
    > venv\Scripts\activate

    提示符更改为显示您的虚拟环境处于活动状态。

    (venv) >
  3. 将Amazon SAM CLI 安装到您的虚拟环境中或进行安装。

    (venv) $ pip install --upgrade aws-sam-cli
  4. 验证 Amazon SAM CLI 是否已正确安装:

    (venv) $ sam --version SAM CLI, version 1.76.0
  5. 您可以使用 deactivate 命令退出虚拟环境。不管何时启动新会话,都必须重新激活环境。

问题排查

如果您在安装或使用Amazon SAM CLI 时遇到错误,请参阅Amazon SAMCLI 纠正