管理 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 SAM CLI) 通过升级、降级和卸载实现的版本。或者,您可以下载并安装 Amazon SAM CLI 每晚构建。

正在升级 Amazon SAM CLI

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

sudo ./sam-installation/install --update

的 Amazon SAM CLI 必须使用与安装方法相同的方法进行升级。我们建议您使用软件包安装程序来安装和升级 Amazon SAM CLI.

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

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

正在卸载 Amazon SAM CLI

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

  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 通过与安装它相同的方法。我们建议您使用软件包安装程序来安装 Amazon SAM CLI.

如果你安装了 Amazon SAM CLI 使用软件包安装程序,按照以下步骤进行卸载。

要卸载 Amazon SAM CLI
  1. 移除 Amazon SAM CLI 通过修改并运行以下内容来编程:

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

    2. /path-to— 指向安装位置的路径 Amazon SAM CLI 节目。默认位置是 /usr/local

  2. 移除 Amazon SAM CLI $PATH通过修改并运行以下内容:

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

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

  3. 验证 Amazon SAM CLI 通过运行以下命令将其卸载:

    $ sam --version command not found: sam

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

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

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

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

从使用中切换 Homebrew 来管理 Amazon SAM CLI

如果你使用 Homebrew 安装和升级 Amazon SAM CLI,我们建议使用 Amazon 支持的方法。按照以下说明切换到支持的方法。

要从使用中切换 Homebrew
  1. 按照中的正在卸载 Homebrew 已安装 Amazon SAM CLI说明卸载 Homebrew 托管版本。

  2. 按照 安装 Amazon SAM CLI 中的说明使用支持的方法安装 Amazon SAM CLI。

管理 Amazon SAM CLI 每晚构建

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

注意

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

正在安装 Amazon SAM CLI 每晚构建

要安装 Amazon SAM CLI 每晚构建,请按照以下说明进行操作。

你可以安装每晚编译版本的 Amazon SAM CLI 在 Linux 使用软件包安装程序的 x86_64 平台。

要安装 Amazon SAM CLI 每晚构建
  1. sam-cli-nightly中下载软件包安装程序 aws-sam-cli GitHub 存储库

  2. 按照安装步骤进行操作 Amazon SAM CLI来安装夜间编译包。

你可以安装每晚编译版本的 Amazon SAM CLI on macOS,使用夜间构建包安装程序。

要安装 Amazon SAM CLI 每晚构建
  1. sam-cli-nightly中下载适用于您平台的软件包安装程序 aws-sam-cli GitHub 存储库

  2. 按照安装步骤进行操作 Amazon SAM CLI来安装夜间编译包。

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

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

SAM CLI, version 1.20.0.dev202103151200

切换自 Homebrew 到软件包安装程序

如果你正在使用 Homebrew 安装和升级 Amazon SAM CLI nightly build 并想切换到使用软件包安装程序,请按照以下步骤操作。

要从中切换 Homebrew 到软件包安装程序
  1. 卸载 Homebrew 已安装 Amazon SAM CLI 每晚构建。

    $ brew uninstall aws-sam-cli-nightly
  2. 验证 Amazon SAM CLI 通过运行以下命令卸载夜间构建:

    $ sam-nightly --version zsh: command not found: sam-nightly
  3. 按照上一节中的步骤安装 Amazon SAM CLI 每晚构建。

正在安装 Amazon SAM CLI 使用进入虚拟环境 pip

我们建议使用本机软件包安装程序来安装 Amazon SAM CLI。 如果你必须使用 pip,我们建议您安装 Amazon SAM CLI 进入虚拟环境。这样可确保干净的安装环境,并能在出现错误时提供隔离环境。

注意

截至2023年10月24日, Amazon SAM CLI 正在停止支持 Python 3.7。 要了解更多信息,请参阅Amazon SAM CLI 停止支持 Python 3.7

要安装 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.94.0
  5. 您可以使用 deactivate 命令退出虚拟环境。不管何时启动新会话,都必须重新激活环境。

管理 Amazon SAM CLI 替换为 Homebrew

注意

从 2023 年 9 月开始, Amazon 将不再维持 Amazon 托管的 Homebrew 的安装程序 Amazon SAM CLI (aws/tap/aws-sam-cli)。 要继续使用 Homebrew,你可以使用社区管理的安装程序 (aws-sam-cli)。从 2023 年 9 月起,任何 Homebrew 引用aws/tap/aws-sam-cli将重定向到的命令aws-sam-cli

我们建议您使用我们支持的安装升级方法。

正在安装 Amazon SAM CLI 使用 Homebrew

注意

这些说明使用社区管理 Amazon SAM CLI Homebrew 安装程序。如需更多支持,请参阅 homebrew-core 存储库

要安装 Amazon SAM CLI
  1. 运行以下命令:

    $ brew install aws-sam-cli
  2. 验证安装:

    $ sam --version

    成功安装之后 Amazon SAM CLI,你应该会看到如下输出:

    SAM CLI, version 1.94.0

正在升级 Amazon SAM CLI 使用 Homebrew

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

$ brew upgrade aws-sam-cli

正在卸载 Homebrew 已安装 Amazon SAM CLI

如果 Amazon SAM CLI 是使用安装的 Homebrew,请按照以下步骤将其卸载。

要卸载 Amazon SAM CLI
  1. 运行以下命令:

    $ brew uninstall aws-sam-cli
  2. 验证 Amazon SAM CLI 通过运行以下命令将其卸载:

    $ sam --version command not found: sam

切换到社区管理 Homebrew 安装程序

如果你使用的是 Amazon 托管 Homebrew 安装程序 (aws/tap/aws-sam-cli) 并希望继续使用 Homebrew,我们建议切换到社区管理 Homebrew 安装程序 (aws-sam-cli)。

要切换单个命令,请运行以下命令:

$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli

按照这些说明单独运行每条命令。

切换到社区管理 Homebrew 安装程序
  1. 卸载 Amazon 托管 Homebrew 的版本 Amazon SAM CLI:

    $ brew uninstall aws-sam-cli
  2. 验证 Amazon SAM CLI 已被卸载:

    $ which sam sam not found
  3. 移除 Amazon 托管的 Amazon SAM CLI 点击:

    $ brew untap aws/tap

    如果您收到类似以下的错误,请添加 --force 选项并重试。

    Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
    aws-sam-cli-nightly
  4. 移除 Amazon 托管安装程序的缓存文件:

    $ brew cleanup aws/tap
  5. 更新 Homebrew 以及所有公式:

    $ brew update
  6. 安装社区管理版本的 Amazon SAM CLI:

    $ brew install aws-sam-cli
  7. 验证 Amazon SAM CLI 已成功安装:

    $ sam --version SAM CLI, version 1.94.0

故障排除

如果您在安装或使用时遇到错误 Amazon SAM CLI,请参阅 Amazon SAM CLI 故障排除