本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 管理 AWS SAM CLI版本
透過升級、降級和解除安裝來管理您的 AWS Serverless Application Model 命令列界面 (AWS SAM CLI) 版本。或者，您可以下載並安裝 AWS SAM CLI每晚組建。
**Topics**
+ [升級 AWS SAM CLI](#manage-sam-cli-versions-upgrade)
+ [解除安裝 AWS SAM CLI](#manage-sam-cli-versions-uninstall)
+ [從 切換Homebrew為使用 來管理 AWS SAM CLI](#manage-sam-cli-versions-switch)
+ [管理 AWS SAM CLI每夜組建](#manage-sam-cli-versions-nightly-build)
+ [使用 將 AWS SAM CLI 安裝到虛擬環境中 pip](#manage-sam-cli-versions-install-virtual)
+ [使用 AWS SAM CLI管理 Homebrew](#manage-sam-cli-versions-homebrew)
+ [疑難排解](#manage-sam-cli-versions-troubleshoot)
## 升級 AWS SAM CLI
### Linux
若要升級 Linux AWS SAM CLI上的 ，請遵循 中的安裝說明[安裝 AWS SAM CLI](install-sam-cli.md#install-sam-cli-instructions)，但將 `--update`選項新增至安裝命令，如下所示：
```
sudo ./sam-installation/install --update
```
### macOS
必須透過用來安裝它的 AWS SAM CLI相同方法進行升級。我們建議您使用 套件安裝程式來安裝和升級 AWS SAM CLI。
若要使用套件安裝程式升級 AWS SAM CLI，請安裝最新的套件版本。如需說明，請參閱[安裝 AWS SAM CLI](install-sam-cli.md#install-sam-cli-instructions)。
### Windows
若要升級 AWS SAM CLI，請[安裝 AWS SAM CLI](install-sam-cli.md)再次重複 中的 Windows 安裝步驟。
## 解除安裝 AWS SAM CLI
### Linux
若要在 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
```
1. 刪除符號連結。
```
sudo rm /usr/local/bin/sam
```
1. 刪除安裝目錄。
```
sudo rm -rf /usr/local/aws-sam-cli
```
### macOS
透過用來安裝 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** 是必要的。
1. */path-to* – 您安裝 AWS SAM CLI程式的路徑。預設位置為 `/usr/local`。
1. 透過修改並執行以下項目`$PATH`來 AWS SAM CLI移除 ：
```
$ sudo rm -rf /path-to-symlink-directory/sam
```
1. *sudo* – 如果您的使用者具有 的寫入許可`$PATH`，**sudo**則不需要 。否則，**sudo** 是必要的。
1. *path-to-symlink-directory* – 您的`$PATH`環境變數。預設位置為 `/usr/local/bin`。
1. 執行下列動作，確認已解除安裝 AWS SAM CLI：
```
$ sam --version
command not found: sam
```
### Windows
若要使用 Windows 設定解除安裝 AWS SAM CLI，請遵循下列步驟：
1. 從開始功能表中，搜尋「新增或移除程式」。
1. 選擇名為**AWS SAM 命令列界面**的結果，然後選擇**解除安裝**以啟動解除安裝程式。
1. 確認您要解除安裝 AWS SAM CLI。
## 從 切換Homebrew為使用 來管理 AWS SAM CLI
如果您使用 Homebrew 安裝和升級 AWS SAM CLI，建議您使用 AWS 支援的 方法。請依照這些指示切換到支援的 方法。
**使用 從 切換 Homebrew**
1. 請依照 的指示[解除安裝Homebrew已安裝的 AWS SAM CLI](#manage-sam-cli-versions-homebrew-uninstall)解除安裝 Homebrew受管版本。
1. 遵循 中的指示[安裝 AWS SAM CLI](install-sam-cli.md)，使用支援的方法安裝 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
您可以使用 套件安裝程式，在 Linux x86\$164 平台上安裝 的夜間建置版本 AWS SAM CLI。
**安裝 AWS SAM CLI每晚組建**
1. 在 *aws-sam-cliGitHub*-sam-cli 儲存庫中，從 [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/) 下載套件安裝程式。
1. 請依照[安裝 AWS SAM CLI](install-sam-cli.md) 的步驟，安裝夜間建置套件。
#### macOS
您可以使用夜間建置套件安裝程式macOS，在 上安裝 的夜間建置版本 AWS SAM CLI。
**安裝 AWS SAM CLI每晚組建**
1. 從 aws-sam-cli 儲存庫中的 [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/) 下載您平台的套件安裝程式。 *aws-sam-cli GitHub *
1. 請依照[安裝 AWS SAM CLI](install-sam-cli.md)的步驟，安裝夜間建置套件。
#### Windows
此下載連結提供 的 AWS SAM CLI每夜建置版本：[AWS SAM CLI每夜建置](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi)。若要在 Windows 上安裝每夜組建，請執行與 相同的步驟[安裝 AWS SAM CLI](install-sam-cli.md)，但改用每夜組建下載連結。
若要確認您已安裝每晚建置版本，請執行 **sam-nightly --version**命令。此命令的輸出格式為 `1.X.Y.dev`，例如：
```
SAM CLI, version 1.20.0.dev202103151200
```
### 從 切換Homebrew到套件安裝程式
如果您使用 Homebrew來安裝和升級 AWS SAM CLI每夜組建，並想要使用套件安裝程式切換到 ，請遵循以下步驟。
**從 切換Homebrew到套件安裝程式**
1. 解除安裝Homebrew已安裝 AWS SAM CLI的夜間組建。
```
$ brew uninstall aws-sam-cli-nightly
```
1. 執行下列動作， AWS SAM CLI確認已解除安裝每夜組建：
```
$ sam-nightly --version
zsh: command not found: sam-nightly
```
1. 請依照上一節中的步驟安裝 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](important-notes.md#important-notes-2023-10-python)。
**將 AWS SAM CLI 安裝到虛擬環境**
1. 從您選擇的起始目錄中，建立虛擬環境並將其命名。
------
#### [ Linux / macOS ]
```
$ mkdir project
$ cd project
$ python3 -m venv venv
```
------
#### [ Windows ]
```
> mkdir project
> cd project
> py -3 -m venv venv
```
------
1. 啟用虛擬環境
------
#### [ Linux / macOS ]
```
$ . venv/bin/activate
```
提示會變更以顯示您的虛擬環境處於作用中狀態。
```
(venv) $
```
------
#### [ Windows ]
```
> venv\Scripts\activate
```
提示會變更以顯示您的虛擬環境處於作用中狀態。
```
(venv) >
```
------
1. 將 AWS SAM CLI 安裝到您的虛擬環境。
```
(venv) $ pip install --upgrade aws-sam-cli
```
1. 確認 AWS SAM CLI 已正確安裝。
```
(venv) $ sam --version
SAM CLI, version 1.94.0
```
1. 您可以使用 `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`。
我們建議您使用我們支援的[安裝](install-sam-cli.md)和[升級](#manage-sam-cli-versions-upgrade)方法。
### 使用 安裝 AWS SAM CLI Homebrew
**注意**
這些指示使用社群受 AWS SAM CLI管Homebrew安裝程式。如需進一步支援，請參閱 *[homebrew-core](https://github.com/Homebrew/homebrew-core/issues) 儲存庫*。
**安裝 AWS SAM CLI**
1. 執行下列命令：
```
$ brew install aws-sam-cli
```
1. 驗證安裝：
```
$ sam --version
```
成功安裝 後 AWS SAM CLI，您應該會看到如下所示的輸出：
```
SAM CLI, version 1.94.0
```
### 使用 升級 AWS SAM CLI Homebrew
若要使用 升級 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
```
1. 執行下列動作，確認已解除安裝 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
```
1. 確認 AWS SAM CLI 已解除安裝：
```
$ which sam
sam not found
```
1. 移除 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
```
1. 移除 AWS 受管安裝程式的快取檔案：
```
$ brew cleanup aws/tap
```
1. 更新Homebrew和所有公式：
```
$ brew update
```
1. 安裝 的社群受管版本 AWS SAM CLI：
```
$ brew install aws-sam-cli
```
1. 確認已成功安裝 AWS SAM CLI：
```
$ sam --version
SAM CLI, version 1.94.0
```
## 疑難排解
如果您在安裝或使用 時遇到錯誤 AWS SAM CLI，請參閱 [AWS SAM CLI 故障診斷](sam-cli-troubleshooting.md)。