本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 安裝 AWS SAM CLI 遵循 中的指示，在支援的作業系統上安裝最新版本的 AWS Serverless Application Model 命令列界面 (AWS SAM CLI)[步驟 4：安裝 AWS CLI](prerequisites.md#prerequisites-install-cli)。 如需管理目前安裝的 版本的資訊 AWS SAM CLI，包括如何升級、解除安裝或管理夜間組建，請參閱 [管理 AWS SAM CLI版本](manage-sam-cli-versions.md)。 **這是您第一次安裝 AWS SAM CLI嗎？** 在繼續之前，請先完成上一節中的所有[先決條件](prerequisites.md)。其中包含： 註冊 AWS 帳戶。 設定 的安全存取 AWS。 建立存取金鑰 ID 和私密存取金鑰。 安裝 AWS CLI。 設定 AWS 登入資料。 **Topics** + [安裝 AWS SAM CLI](#install-sam-cli-instructions) + [對安裝錯誤進行故障診斷](#sam-cli-troubleshoot-install) + [後續步驟](#install-sam-cli-next-steps) + [選用：驗證安裝程式的 AWS SAM CLI完整性](reference-sam-cli-install-verify.md) ## 安裝 AWS SAM CLI **注意** 從 2023 年 9 月開始， AWS 將不再維護 AWS SAM CLI() 的 AWS 受管Homebrew安裝程式`aws/tap/aws-sam-cli`。如果您使用 Homebrew 安裝和管理 AWS SAM CLI，請參閱下列選項： 若要繼續使用 Homebrew，您可以使用 社群受管安裝程式。如需詳細資訊，請參閱[使用 AWS SAM CLI管理 Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-homebrew)。 我們建議您使用此頁面中記錄的其中一個第一方安裝方法。使用這些方法之一之前，請參閱 [從 切換 Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-switch)。 如需其他詳細資訊，請參閱[發行版本：1.121.0](https://github.com/aws/aws-sam-cli/releases)。 若要安裝 AWS SAM CLI，請遵循作業系統的指示。 ### Linux ------ #### [ x86\_64 - command line installer ] 1. 將 [AWS SAM CLI .zip 檔案](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-x86_64.zip)下載到您選擇的目錄。 1. **（選用）** 您可以在安裝之前驗證安裝程式的完整性。如需說明，請參閱[選用：驗證安裝程式的 AWS SAM CLI完整性](reference-sam-cli-install-verify.md)。 1. 將安裝檔案解壓縮到您選擇的目錄中。以下是使用 `sam-installation`子目錄的範例。 **注意** 如果您的作業系統沒有內建 **unzip** 命令，請使用對等的命令。 ``` $ unzip aws-sam-cli-linux-x86_64.zip -d {{sam-installation}} ``` 1. 執行 可執行檔來安裝 AWS SAM CLI `install` 。此可執行檔位於上一個步驟中使用的目錄中。以下是使用 `sam-installation`子目錄的範例： ``` $ sudo ./{{sam-installation}}/install ``` 1. 驗證安裝。 ``` $ sam --version ``` 若要確認安裝成功，您應該會看到輸出，以最新的可用版本取代下列括號文字： ``` SAM CLI, {{}} ``` ------ #### [ arm64 - command line installer ] 1. 將 [AWS SAM CLI .zip 檔案](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-arm64.zip)下載到您選擇的目錄。 1. **（選用）** 您可以在安裝之前驗證安裝程式的完整性。如需說明，請參閱[選用：驗證安裝程式的 AWS SAM CLI完整性](reference-sam-cli-install-verify.md)。 1. 將安裝檔案解壓縮到您選擇的目錄中。以下是使用 `sam-installation`子目錄的範例。 **注意** 如果您的作業系統沒有內建 **unzip** 命令，請使用對等的命令。 ``` $ unzip aws-sam-cli-linux-arm64.zip -d {{sam-installation}} ``` 1. 執行 可執行檔來安裝 AWS SAM CLI `install` 。此可執行檔位於上一個步驟中使用的目錄中。以下是使用 `sam-installation`子目錄的範例： ``` $ sudo ./{{sam-installation}}/install ``` 1. 驗證安裝。 ``` $ sam --version ``` 若要確認安裝成功，您應該會看到如下所示的輸出，但會將括號文字取代為最新的 SAM CLI 版本： ``` SAM CLI, {{}} ``` ------ ### macOS #### 安裝步驟 使用 套件安裝程式來安裝 AWS SAM CLI。此外，套件安裝程式有兩種安裝方法供您選擇：**GUI** 和**命令列**。您可以為**所有使用者**或只為**目前的使用者**安裝 。若要為所有使用者安裝 ，需要超級使用者授權。 **注意** AWS SAM CLI 不支援比 MacOS 13.x 更舊的 MacOS 版本。升級至支援的 MacOS AWS SAM 版本，或使用 安裝 CLIHomebrew。 ------ #### [ GUI - All users ] **若要下載套件安裝程式並安裝 AWS SAM CLI** **注意** 如果您之前透過 AWS SAM CLIHomebrew或 安裝 pip，則需要先將其解除安裝。如需說明，請參閱[解除安裝 AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall)。 1. 將 macOS 下載`pkg`至您選擇的目錄： + **對於執行 Intel 處理器的 Mac，請選擇 x86\_64** – [ aws-sam-cli-macos-x86\_64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **對於執行 Apple 晶片的 Mac，請選擇 arm64** – [ aws-sam-cli-macos-arm64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) **注意** 您可以選擇在安裝之前驗證安裝程式的完整性。如需說明，請參閱[選用：驗證安裝程式的 AWS SAM CLI完整性](reference-sam-cli-install-verify.md)。 1. 執行您下載的檔案，並依照畫面上的指示繼續進行**簡介**、**讀我**檔案和**授權**步驟。 1. 針對**目的地選取**，選取**此電腦所有使用者的安裝**。 1. 針對**安裝類型**，選擇將要安裝 AWS SAM CLI的位置，然後按**安裝**。建議的預設位置為 `/usr/local/aws-sam-cli`。 **注意** 若要使用 **sam**命令叫用 AWS SAM CLI，安裝程式會自動在 `/usr/local/bin/sam`和 之間建立符號連結，`/usr/local/aws-sam-cli/sam`或是您選擇的安裝資料夾。 1. AWS SAM CLI 將安裝 ，並**顯示安裝成功**訊息。按**關閉**。 **驗證成功安裝** + 執行下列 AWS SAM CLI動作，確認 已正確安裝，且您的符號連結已設定完成： ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ GUI - Current user ] **下載並安裝 AWS SAM CLI** **注意** 如果您之前透過 AWS SAM CLIHomebrew或 安裝 pip，則需要先將其解除安裝。如需說明，請參閱[解除安裝 AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall)。 1. 將 macOS 下載`pkg`至您選擇的目錄： + **對於執行 Intel 處理器的 Mac，請選擇 x86\_64** – [ aws-sam-cli-macos-x86\_64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **對於執行 Apple 晶片的 Mac，請選擇 arm64** – [ aws-sam-cli-macos-arm64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) **注意** 您可以選擇在安裝之前驗證安裝程式的完整性。如需說明，請參閱[選用：驗證安裝程式的 AWS SAM CLI完整性](reference-sam-cli-install-verify.md)。 1. 執行您下載的檔案，並依照畫面上的指示繼續進行**簡介**、**讀我**檔案和**授權**步驟。 1. 針對**目的地選取**，選取**僅為我安裝**。如果您沒有看到此選項，請前往下一個步驟。 1. 對於**安裝類型**，請執行下列動作： 1. 選擇將要安裝 AWS SAM CLI的位置。預設位置為 `/usr/local/aws-sam-cli`。選取您擁有寫入許可的位置。若要變更安裝位置，請選取**本機**並選擇您的位置。完成後按**繼續**。 1. 如果您未在上一個步驟中取得**僅為我選擇安裝**的選項，請選取**變更安裝位置** > **僅為我安裝**，然後按**繼續**。 1. 按下**安裝**。 1. AWS SAM CLI 將安裝 ，並**顯示安裝成功**訊息。按**關閉**。 **建立符號連結** + 若要使用 AWS SAM CLI**sam**命令叫用 ，您必須在程式與 之間 AWS SAM CLI手動建立符號連結`$PATH`。修改並執行下列命令來建立您的符號連結： ``` $ {{sudo}} ln -s {{/path-to}}/aws-sam-cli/sam {{/path-to-symlink-directory}}/sam ``` + {{sudo}} – 如果您的使用者具有 的寫入許可`$PATH`，**sudo**則不需要 。否則，**sudo** 是必要的。 + {{path-to}} – 您安裝 AWS SAM CLI程式的路徑。例如 `/Users/myUser/Desktop`。 + {{path-to-symlink-directory}} – 您的`$PATH`環境變數。預設位置為 `/usr/local/bin`。 **驗證成功安裝** + 執行下列 AWS SAM CLI動作，確認 已正確安裝，且您的符號連結已設定完成： ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ Command line - All users ] **下載並安裝 AWS SAM CLI** **注意** 如果您之前透過 AWS SAM CLIHomebrew或 安裝 pip，則需要先將其解除安裝。如需說明，請參閱[解除安裝 AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall)。 1. 將 macOS 下載`pkg`至您選擇的目錄： + **對於執行 Intel 處理器的 Mac，請選擇 x86\_64** – [ aws-sam-cli-macos-x86\_64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **對於執行 Apple 晶片的 Mac，請選擇 arm64** – [ aws-sam-cli-macos-arm64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) **注意** 您可以選擇在安裝之前驗證安裝程式的完整性。如需說明，請參閱[選用：驗證安裝程式的 AWS SAM CLI完整性](reference-sam-cli-install-verify.md)。 1. 修改並執行安裝指令碼： ``` $ sudo installer -pkg {{path-to-pkg-installer}}/{{name-of-pkg-installer}} -target / installer: Package name is AWS SAM CLI installer: Upgrading at base path / installer: The upgrade was successful. ``` **注意** 若要使用 AWS SAM CLI**sam**命令叫用 ，安裝程式會自動在 `/usr/local/bin/sam`和 之間建立符號連結`/usr/local/aws-sam-cli/sam`。 **驗證成功安裝** + 執行下列 AWS SAM CLI動作，確認 已正確安裝，且您的符號連結已設定完成： ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ Command line - Current user ] **下載並安裝 AWS SAM CLI** **注意** 如果您之前透過 AWS SAM CLIHomebrew或 安裝 pip，則需要先將其解除安裝。如需說明，請參閱[解除安裝 AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall)。 1. 將 macOS 下載`pkg`至您選擇的目錄： + **對於執行 Intel 處理器的 Mac，請選擇 x86\_64** – [ aws-sam-cli-macos-x86\_64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **對於執行 Apple 晶片的 Mac，請選擇 arm64** – [ aws-sam-cli-macos-arm64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) **注意** 您可以選擇在安裝之前驗證安裝程式的完整性。如需說明，請參閱[選用：驗證安裝程式的 AWS SAM CLI完整性](reference-sam-cli-install-verify.md)。 1. 判斷您有寫入許可的安裝目錄。然後，使用 範本建立 `xml` 檔案並加以修改，以反映您的安裝目錄。目錄必須已存在。 例如，如果您將 {{path-to-my-directory}} 取代為 `/Users/myUser/Desktop`，則會在該處安裝`aws-sam-cli`程式資料夾。 ``` choiceAttribute customLocation attributeSetting {{path-to-my-directory}} choiceIdentifier default ``` 1. 執行下列動作來儲存`xml`檔案並確認其有效： ``` $ installer -pkg {{path-to-pkg-installer}} \ -target CurrentUserHomeDirectory \ -showChoicesAfterApplyingChangesXML {{path-to-your-xml-file}} ``` 輸出應會顯示將套用至程式的 AWS SAM CLI偏好設定。 1. 執行下列動作來安裝 AWS SAM CLI： ``` $ installer -pkg {{path-to-pkg-installer}} \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML {{path-to-your-xml-file}} # Example output installer: Package name is AWS SAM CLI installer: choices changes file '{{path-to-your-xml-file}}' applied installer: Upgrading at base path {{base-path-of-xml-file}} installer: The upgrade was successful. ``` **建立符號連結** + 若要使用 AWS SAM CLI**sam**命令叫用 ，您必須在程式與 之間 AWS SAM CLI手動建立符號連結`$PATH`。修改並執行下列命令來建立您的符號連結： ``` $ {{sudo}} ln -s {{/path-to}}/aws-sam-cli/sam {{/path-to-symlink-directory}}/sam ``` + {{sudo}} – 如果您的使用者具有 的寫入許可`$PATH`，**sudo**則不需要 。否則，**sudo** 是必要的。 + {{path-to}} – 您安裝 AWS SAM CLI程式的路徑。例如 `/Users/myUser/Desktop`。 + {{path-to-symlink-directory}} – 您的`$PATH`環境變數。預設位置為 `/usr/local/bin`。 **驗證成功安裝** + 執行下列 AWS SAM CLI動作，確認 已正確安裝，且您的符號連結已設定完成： ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ ### Windows Windows Installer (MSI) 檔案是 Windows 作業系統的套件安裝程式檔案。 請依照下列步驟，使用 MSI 檔案安裝 AWS SAM CLI。 1. 下載 AWS SAM CLI [64 位元](https://github.com/aws/aws-sam-cli/releases/latest/download/AWS_SAM_CLI_64_PY3.msi)。 1. **（選用）** 您可以在安裝之前驗證安裝程式的完整性。如需說明，請參閱[選用：驗證安裝程式的 AWS SAM CLI完整性](reference-sam-cli-install-verify.md)。 1. 驗證安裝。 完成安裝後，請開啟新的命令提示或 PowerShell 提示來驗證它。您應該能夠`sam`從命令列叫用 。 ``` sam --version ``` 成功安裝 後 AWS SAM CLI，您應該會看到如下所示的輸出： ``` SAM CLI, {{}} ``` 1. 啟用長路徑 （僅限 Windows 10 和更新版本）。 **重要** AWS SAM CLI 可能會與超過 Windows 路徑上限的檔案路徑互動。由於 Windows 10 **MAX\_PATH**限制`sam init`，這可能會導致執行時發生錯誤。若要解決此問題，必須設定新的長路徑行為。 若要啟用長路徑，請參閱 *Microsoft* [Windows 應用程式開發文件中的在 Windows 10 版本 1607 和更新版本中啟用長路徑](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later)。 1. 安裝 Git。 若要使用 `sam init`命令下載範例應用程式，您還必須安裝 Git。如需說明，請參閱[安裝 Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)。 ## 對安裝錯誤進行故障診斷 ### Linux #### Docker 錯誤：「無法連線至 Docker 協助程式。是否在此主機上執行 docker 協助程式？」 在某些情況下，若要提供 `ec2-user`存取 Docker 協助程式的許可，您可能需要重新啟動執行個體。如果您收到此錯誤，請嘗試重新啟動執行個體。 #### Shell 錯誤：「找不到命令」 如果您收到此錯誤，您的 shell 就無法在 AWS SAM CLI 路徑中找到可執行檔。驗證安裝 AWS SAM CLI可執行檔的目錄位置，然後驗證目錄是否位於您的路徑上。 #### AWS SAM CLI 錯誤："/lib64/libc.so.6：找不到版本 `GLIBC\_2.14' （需要 /usr/local/aws-sam-cli/dist/libz.so.1)" 如果您收到此錯誤，表示您使用的是不支援的 Linux 版本，而且內建的 glibc 版本已過期。請嘗試下列其中一項： + 將您的 Linux 主機升級至 CentOS、Fedora、Ubuntu 或 Amazon Linux 2 最近發行版本的 64 位元版本。 + 請遵循 的指示[安裝 AWS SAM CLI](#install-sam-cli)。 ### macOS #### 安裝失敗 ![安裝程式的影像 AWS SAM CLI，顯示安裝失敗訊息](http://docs.aws.amazon.com/zh_tw/serverless-application-model/latest/developerguide/images/sam-cli-troubleshoot-install-macos-install-failed.jpg) 如果您要為使用者安裝 AWS SAM CLI，並選取您沒有寫入許可的安裝目錄，則可能會發生此錯誤。請嘗試下列其中一項： 1. 選取您具有寫入許可的不同安裝目錄。 1. 刪除安裝程式。然後，下載並再次執行。 ## 後續步驟 若要進一步了解 AWS SAM CLI和 以開始建置您自己的無伺服器應用程式，請參閱以下內容： + [教學課程：使用 部署 Hello World 應用程式 AWS SAM](serverless-getting-started-hello-world.md) – Step-by-step說明。 + [完成 AWS SAM 研討會](https://catalog.workshops.aws/complete-aws-sam/en-US) – 旨在教導您許多 AWS SAM 提供的主要功能的研討會。 + [AWS SAM 範例應用程式和模式](https://serverlessland.com/patterns?framework=AWS+SAM) – 社群作者的應用程式和模式範例，您可以進一步實驗。