本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
管理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,必须通过运行以下命令删除符号链接和安装目录:
-
找到符号链接和安装路径。
-
使用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
-
-
删除符号链接。
sudo rm /usr/local/bin/sam
-
删除安装目录。
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 是使用软件包安装程序安装的,请使用以下命令将其卸载。
-
通过修改和运行以下命令删除Amazon SAM CLI 程序:
$
sudo
rm -rf/path-to
/aws-sam-cli-
sudo
— 如果您的用户对Amazon SAM CLI 程序的安装位置具有写入权限,sudo则不需要。否则,sudo 是必需的。 -
/path-t
o — 安装Amazon SAM CLI 程序的路径。默认位置是/usr/local
。
-
-
$PATH
通过修改和运行以下Amazon SAM命令删除 CLI:$
sudo
rm -rf/path-to-symlink-directory
/sam-
sudo
— 如果您的用户具有写入权限$PATH
,sudo则不需要。否则,sudo 是必需的。 -
path-to-symlink-directory
— 您的$PATH
环境变量。默认位置是/usr/local/bin
。
-
-
运行以下命令验证Amazon SAM CLI 是否已卸载:
$
sam --version
command not found: sam
要使用 Windows 设置卸载Amazon SAM CLI,请按照以下步骤操作:
-
在 “开始” 菜单中,搜索 “添加或删除程序”。
-
选择名为 Amazon SAMCommand Line Interface 的结果,然后选择卸载以启动卸载程序。
-
确认您要卸载 Amazon SAM CLI。
安装 CAmazon SAM LI 夜间版本
您可以下载并安装Amazon SAM命令行界面的夜间版本。它包含Amazon SAM CLI 代码的预发行版本,该版本可能不如生产版本稳定。安装后,可以在sam-nightly命令中使用夜间构建。您可以同时安装和使用Amazon SAM CLI 的生产和夜间构建版本。
注意
夜间版本不包含构建映像的预发行版本。因此,使用该--use-container选项构建您的无服务器应用程序会使用构建映像的最新生产版本。
要安装Amazon SAM CLI 夜间版本,请按照以下说明进行操作。
要在 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
要验证您是否已安装夜间编译版本,请运行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 安装到虚拟环境中或进行操作
-
从您选择的起始目录中创建虚拟环境并命名它。
-
激活虚拟环境
-
将Amazon SAM CLI 安装到您的虚拟环境中或进行安装。
(venv) $
pip install --upgrade aws-sam-cli
-
验证 Amazon SAM CLI 是否已正确安装:
(venv) $
sam --version
SAM CLI, version 1.76.0 -
您可以使用
deactivate
命令退出虚拟环境。不管何时启动新会话,都必须重新激活环境。
问题排查
如果您在安装或使用Amazon SAM CLI 时遇到错误,请参阅Amazon SAMCLI 纠正。