管理 AWS SAMCLI版本 - AWS Serverless Application Model
升級 AWS SAMCLI解除安裝 AWS SAMCLI從切換 Homebrew管理 AWS SAMCLI夜間組建使用將其安裝 AWS SAMCLI到虛擬環境中 pip管理 AWS SAMCLI與 Homebrew故障診斷

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

管理 AWS SAMCLI版本

透過升級、降級和解除安裝來管理您的 AWS Serverless Application Model 指令行介面 (AWS SAMCLI) 版本。或者，您可以下載並安裝 AWS SAMCLI夜間構建。

升級 AWS SAMCLI

若要在 Linux AWS SAMCLI 上升級，請遵循中的安裝指示安裝 AWS SAM CLI，但將選--update項新增至 install 命令，如下所示：

sudo ./sam-installation/install --update

AWS SAMCLI必須透過與安裝它相同的方法進行升級。我們建議您使用套件安裝程式來安裝和升級 AWS SAMCLI.

若要 AWS SAMCLI使用套件安裝程式升級，請安裝最新的套件版本。如需說明，請參閱安裝 AWS SAM CLI。

若要升級 AWS SAMCLI，請安裝 AWS SAM CLI再次重複中的 Windows 安裝步驟。

解除安裝 AWS SAMCLI

若要 AWS SAMCLI在 Linux 上解除安裝，您必須執行下列命令來刪除符號連結和安裝目錄：

  1. 找到符號連結並安裝路徑。

    • 使用以下which命令查找符號鏈接：

      which sam

      輸出顯示 AWS 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

AWS SAMCLI通過用於安裝它的相同方法卸載。我們建議您使用套件安裝程式來安裝 AWS SAMCLI.

如果您 AWS SAMCLI使用套件安裝程式安裝，請依照下列步驟解除安裝。

若要解除安裝 AWS SAMCLI

  1. 修改並執行下列命令以移除 AWS SAMCLI程式：

    $ sudo rm -rf /path-to/aws-sam-cli

    1. sudo — 如果您的使用者具有 AWS SAMCLI程式安裝位置的寫入權限，sudo則不需要。否則，sudo 是必要的。

    2. /路徑-安裝程式的路徑。 AWS SAMCLI預設位置為 /usr/local。

  2. AWS SAMCLI$PATH通過修改並運行以下命令來刪除：

    $ sudo rm -rf /path-to-symlink-directory/sam

    1. sudo — 如果您的使用者具有寫入權限$PATH，sudo則不需要。否則，sudo 是必要的。

    2. path-to-symlink-directory— 您的$PATH環境變數。預設位置為 /usr/local/bin。

  3. 執行下列命 AWS SAMCLI令，確認已解除安裝：

    $ sam --version
command not found: sam

要卸載 AWS SAMCLI使用 Windows 設置，請按照下列步驟操作：

  1. 從開始菜單中，搜索「添加或刪除程序」。

  2. 選擇名為命AWS SAM 令列介面的結果，然後選擇 [解除安裝] 以啟動解除安裝程式。

  3. 確認您要解除安裝 AWS SAMCLI.

從使用切換Homebrew到管理 AWS SAMCLI

如果您使Homebrew用安裝和升級 AWS SAMCLI，建議您使用 AWS 支援的方法。請依照下列指示切換至支援的方法。

切換使用 Homebrew

  1. 依照中的指示解除Homebrew安裝已安裝的 AWS SAM CLI解除安裝受Homebrew管理的版本。

  2. 請遵循中安裝 AWS SAM CLI的說明，使用支援的方法安裝 AWS SAM CLI。

管理 AWS SAMCLI夜間組建

您可以下載並安裝 AWS SAMCLI夜間版本。它包含 AWS SAMCLI代碼的預發布版本，可能比生產版本不太穩定。安裝後，您可以使用該sam-nightly命令的夜間構建。您可以同時安裝和使用的生產版本和夜間建置版本。 AWS SAMCLI

注意

每晚構建不包含構建映像的預發布版本。因此，使用此--use-container選項建置無伺服器應用程式會使用組建映像的最新生產版本。

安裝 AWS SAMCLI夜間構建

要安裝 AWS SAMCLI夜間構建，請按照以下說明進行操作。

您可以使用套件安裝程式，在 Linux x86_64 平台 AWS SAMCLI上安裝夜間建置版本。

若要安裝 AWS SAMCLI夜間組建

  1. 從aws-sam-cli GitHub存放庫sam-cli-nightly中下載套件安裝程式。

  2. 請遵循安裝的步驟 AWS SAMCLI來安裝每晚組建套件。

您可以使用每晚構建包安裝程序安裝程序來安裝 AWS SAMCLI on macOS 的夜間構建版本。

若要安裝 AWS SAMCLI夜間組建

  1. 從aws-sam-cli GitHub存放庫中下載適用於您平台sam-cli-nightly的套件安裝程式。

  2. 請遵循安裝的步驟 AWS SAMCLI來安裝每晚組建套件。

的每晚構建版本可通過以下下載鏈接獲得：AWS SAMCLI每晚構建。 AWS SAMCLI若要在 Windows 上安裝夜間組建，請執行與中相同的步驟安裝 AWS SAM CLI，但請改用夜間組建下載連結。

若要確認您是否已安裝夜間建置版本，請執行命sam-nightly --version令。此命令的輸出格式為1.X.Y.dev<YYYYMMDDHHmm>，例如：

SAM CLI, version 1.20.0.dev202103151200

從切換Homebrew到套件安裝程式

如果您使Homebrew用安裝和升級 AWS SAMCLI夜間組建，而且想要切換到使用套件安裝程式，請依照下列步驟執行。

從套件安Homebrew裝程式切換

  1. 卸載Homebrew已安裝的 AWS SAMCLI夜間構建。

    $ brew uninstall aws-sam-cli-nightly

  2. 執行下列命令，確認已解除安裝 AWS SAMCLI每晚組建：

    $ sam-nightly --version
zsh: command not found: sam-nightly

  3. 請依照上一節中的步驟安裝 AWS SAMCLI每晚組建。

使用將其安裝 AWS SAMCLI到虛擬環境中 pip

我們建議您使用原生套件安裝程式來安裝 AWS SAMCLI. 如果必須使用pip，建議您將安裝 AWS SAMCLI到虛擬環境中。如果發生錯誤，這可確保整潔的安裝環境和隔離的環境。

注意

截至 2023 年 10 月 24 日， AWS SAM CLI正在停止支持。Python 3.7如需進一步了解，請參閱AWS SAM CLI 中斷支援 Python 3.7。

若要 AWS SAMCLI將其安裝到虛擬環境中

  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. 將安裝 AWS SAMCLI到您的虛擬環境中。

    (venv) $ pip install --upgrade aws-sam-cli

  4. 確認已 AWS SAMCLI正確安裝。

    (venv) $ sam --version
SAM CLI, version 1.94.0

  5. 您可以使用 deactivate 命令來離開虛擬環境。每當您啟動新的工作階段時，您都必須重新啟用環境。

管理 AWS SAMCLI與 Homebrew

注意

從 2023 年 9 月開始， AWS 將不再維護 AWS SAMCLI (aws/tap/aws-sam-cli) 的 AWS 受管理Homebrew安裝程式。若要繼續使用Homebrew，您可以使用社群管理的安裝程式 (aws-sam-cli)。從 2023 年 9 月起，任何引用的Homebrew命令都aws/tap/aws-sam-cli將重定向到aws-sam-cli。

我們建議您使用我們支援的安裝和升級方法。

安裝使 AWS SAMCLI用 Homebrew

注意

這些指示使用社群管理的 AWS SAMCLIHomebrew安裝程式。有關進一步的支持，請參閱自製核心存儲庫。

若要安裝 AWS SAMCLI

  1. 執行下列命令：

    $ brew install aws-sam-cli

  2. 驗證安裝：

    $ sam --version

    成功安裝之後 AWS SAMCLI，您應該會看到如下所示的輸出：

    SAM CLI, version 1.94.0

升級使 AWS SAMCLI用 Homebrew

若要升級使 AWS SAMCLI用Homebrew，請執行下列命令：

$ brew upgrade aws-sam-cli

解除Homebrew安裝已安裝的 AWS SAM CLI

如果使 AWS SAMCLI用安裝Homebrew，請按照下列步驟將其解除安裝。

若要解除安裝 AWS SAMCLI

  1. 執行下列命令：

    $ brew uninstall aws-sam-cli

  2. 執行下列命 AWS SAMCLI令，確認已解除安裝：

    $ sam --version
command not found: sam

切換至社群管理的Homebrew安裝程式

如果您使用的是 AWS 受管理的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. 解除安裝下列項目的 AWS 受管理Homebrew版本 AWS SAMCLI：

    $ brew uninstall aws-sam-cli

  2. 確認 AWS SAMCLI已解除安裝：

    $ which sam
sam not found

  3. 移除受 AWS 管理的 AWS SAMCLI點選：

    $ 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. 移除 AWS 受管理安裝程式的快取檔案：

    $ brew cleanup aws/tap

  5. 更新Homebrew和所有公式：

    $ brew update

  6. 安裝以下版本的社群管理版本 AWS SAMCLI：

    $ brew install aws-sam-cli

  7. 確認已 AWS SAMCLI成功安裝：

    $ sam --version
SAM CLI, version 1.94.0

故障診斷

如果您在安裝或使用時遇到錯誤 AWS SAMCLI，請參閱AWS SAMCLI疑難排。