管理 AWS SAM CLI版本 - AWS Serverless Application Model
升級 AWS SAM CLI解除安裝 AWS SAM CLI從 切換 Homebrew管理 AWS SAM CLI每夜組建使用 將 AWS SAM CLI 安裝到虛擬環境中 pip使用 AWS SAM CLI管理 Homebrew疑難排解

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

管理 AWS SAM CLI版本

透過升級、降級和解除安裝來管理您的 AWS Serverless Application Model 命令列界面 (AWS SAM CLI) 版本。或者，您可以下載並安裝 AWS SAM CLI每晚組建。

升級 AWS SAM CLI

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

sudo ./sam-installation/install --update

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

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

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

解除安裝 AWS SAM CLI

若要在 Linux 上解除安裝 AWS SAM CLI，您必須執行下列命令來刪除 symlink 和安裝目錄：

  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 SAM CLI的相同方法解除安裝 。我們建議您使用 套件安裝程式來安裝 AWS SAM CLI。

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

若要解除安裝 AWS SAM CLI

  1. 修改並執行下列動作以移除 AWS SAM CLI程式：

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

    1. sudo – 如果您的使用者擁有 AWS SAM CLI程式安裝位置的寫入許可，sudo則不需要 。否則，sudo 是必要的。

    2. /path-to – 您安裝 AWS SAM CLI程式的路徑。預設位置為 /usr/local。

  2. 透過修改並執行以下項目$PATH來 AWS SAM CLI移除 ：

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

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

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

  3. 執行下列動作，確認已解除安裝 AWS SAM CLI：

    $ sam --version
command not found: sam

若要使用 Windows 設定解除安裝 AWS SAM CLI，請遵循下列步驟：

  1. 從開始功能表中，搜尋「新增或移除程式」。

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

  3. 確認您要解除安裝 AWS SAM CLI。

從 切換Homebrew為使用 來管理 AWS SAM CLI

如果您使用 Homebrew 安裝和升級 AWS SAM CLI，建議您使用 AWS 支援的 方法。請依照這些指示切換到支援的 方法。

使用 從 切換 Homebrew

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

  2. 遵循 中的指示安裝 AWS SAM CLI，使用支援的方法安裝 AWS SAM CLI。

管理 AWS SAM CLI每夜組建

您可以下載並安裝 AWS SAM CLI每晚組建。它包含程式碼的 AWS SAM CLI發行前版本，可能比生產版本不穩定。安裝後，您可以搭配 sam-nightly命令使用夜間組建。您可以同時安裝和使用 AWS SAM CLI的生產版本和夜間建置版本。

注意

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

安裝 AWS SAM CLI每晚組建

若要安裝 AWS SAM CLI每晚組建，請遵循下列指示。

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

安裝 AWS SAM CLI每晚組建

  1. 在 aws-sam-cliGitHub-sam-cli 儲存庫中，從 sam-cli-nightly 下載套件安裝程式。

  2. 請依照安裝 AWS SAM CLI 的步驟，安裝夜間建置套件。

您可以使用夜間建置套件安裝程式macOS，在 上安裝 的夜間建置版本 AWS SAM CLI。

安裝 AWS SAM CLI每晚組建

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

  2. 請依照安裝 AWS SAM CLI的步驟，安裝夜間建置套件。

此下載連結提供 的 AWS SAM CLI每夜建置版本：AWS SAM CLI每夜建置。若要在 Windows 上安裝每夜組建，請執行與 相同的步驟安裝 AWS SAM CLI，但改用每夜組建下載連結。

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

SAM CLI, version 1.20.0.dev202103151200

從 切換Homebrew到套件安裝程式

如果您使用 Homebrew來安裝和升級 AWS SAM CLI每夜組建，並想要使用套件安裝程式切換到 ，請遵循以下步驟。

從 切換Homebrew到套件安裝程式

  1. 解除安裝Homebrew已安裝 AWS SAM CLI的夜間組建。

    $ brew uninstall aws-sam-cli-nightly

  2. 執行下列動作， AWS SAM CLI確認已解除安裝每夜組建：

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

  3. 請依照上一節中的步驟安裝 AWS SAM CLI每夜組建。

使用 將 AWS SAM CLI 安裝到虛擬環境中 pip

我們建議您使用原生套件安裝程式來安裝 AWS SAM CLI。如果您必須使用 pip，我們建議您將 AWS SAM CLI 安裝到虛擬環境中。這可確保乾淨的安裝環境，並在發生錯誤時隔離環境。

注意

截至 2023 AWS SAM CLI 年 10 月 24 日， 不再支援 Python 3.7。如需詳細資訊，請參閱 AWS SAM CLI 停止對 的支援 Python 3.7。

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

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

  4. 確認 AWS SAM CLI 已正確安裝。

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

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

使用 AWS SAM CLI管理 Homebrew

注意

從 2023 年 9 月開始， AWS 將不再維護 () AWS SAM CLI的 AWS 受管Homebrew安裝程式aws/tap/aws-sam-cli。若要繼續使用 Homebrew，您可以使用 社群受管安裝程式 (aws-sam-cli)。從 2023 年 9 月開始，任何參考 的Homebrew命令aws/tap/aws-sam-cli都會重新導向至 aws-sam-cli。

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

使用 安裝 AWS SAM CLIHomebrew

注意

這些指示使用 社群受 AWS SAM CLI管Homebrew安裝程式。如需進一步支援，請參閱 homebrew-core 儲存庫。

安裝 AWS SAM CLI

  1. 執行下列命令：

    $ brew install aws-sam-cli

  2. 驗證安裝：

    $ sam --version

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

    SAM CLI, version 1.94.0

使用 升級 AWS SAM CLIHomebrew

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

$ brew upgrade aws-sam-cli

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

如果 AWS SAM CLI使用 安裝 Homebrew，請依照下列步驟解除安裝它。

解除安裝 AWS SAM CLI

  1. 執行下列命令：

    $ brew uninstall aws-sam-cli

  2. 執行下列動作，確認已解除安裝 AWS SAM CLI：

    $ 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 SAM CLI：

    $ brew uninstall aws-sam-cli

  2. 確認 AWS SAM CLI 已解除安裝：

    $ which sam
sam not found

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

    $ brew cleanup aws/tap

  5. 更新Homebrew和所有公式：

    $ brew update

  6. 安裝 的社群受管版本 AWS SAM CLI：

    $ brew install aws-sam-cli

  7. 確認已成功安裝 AWS SAM CLI：

    $ sam --version
SAM CLI, version 1.94.0

疑難排解

如果您在安裝或使用 時遇到錯誤 AWS SAM CLI，請參閱 AWS SAM CLI 故障診斷。