本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
安裝 AWS SAM CLI
安裝最新版本的 AWS Serverless Application Model 指令行介面 (AWS SAM CLI) 在支援的作業系統上。
如需管理目前安裝的版本的資訊 AWS SAM CLI，包括如何升級、解除安裝或管理夜間組建，請參閱管理 AWS SAMCLI版本。
請先完成上一節的所有先決條件，然後再繼續進行。其中包含：
-
註冊一個 AWS 帳戶。
-
建立管理IAM使用者。
-
創建訪問密鑰 ID 和秘密訪問密鑰。
-
安裝 AWS CLI.
-
設定 AWS 認證。
安裝 AWS SAM CLI
從二零二三年九月開始， AWS 將不再維持 AWS 受管 Homebrew 的安裝程式 AWS SAM CLI (aws/tap/aws-sam-cli)。 如果您使用 Homebrew 以安裝和管理 AWS SAM CLI，請參閱下列選項：
若要安裝 AWS SAM CLI，請依照您作業系統的指示進行。
- x86_64 - command line installer
-
-
下載 AWS SAM CLI .zip 文件到您選擇的目錄中。
-
(選擇性) 您可以在安裝之前驗證安裝程式的完整性。如需說明，請參閱 可選：驗證 AWS SAM CLI Installer (安裝程式)。
-
將安裝檔案解壓縮到您選擇的目錄中。以下是使用sam-installation子目錄的範例。
如果您的作業系統沒有內建 unzip 命令，請使用對等的命令。
$ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
-
安裝 AWS SAM CLI 通過運行install可執行文件。此可執行檔位於上一個步驟中使用的目錄中。以下是使用sam-installation子目錄的範例：
$ sudo ./sam-installation/install
-
驗證安裝。
$ sam --version
若要確認安裝成功，您應該會看到一個輸出，將下列括弧文字取代為最新的可用版本：
SAM CLI, <latest version>
- arm64 - command line installer
-
-
下載 AWS SAM CLI .zip 文件到您選擇的目錄中。
-
(選擇性) 您可以在安裝之前驗證安裝程式的完整性。如需說明，請參閱 可選：驗證 AWS SAM CLI Installer (安裝程式)。
-
將安裝檔案解壓縮到您選擇的目錄中。以下是使用sam-installation子目錄的範例。
如果您的作業系統沒有內建 unzip 命令，請使用對等的命令。
$ unzip aws-sam-cli-linux-arm64.zip -d sam-installation
-
安裝 AWS SAM CLI 通過運行install可執行文件。此可執行檔位於上一個步驟中使用的目錄中。以下是使用sam-installation子目錄的範例：
$ sudo ./sam-installation/install
-
驗證安裝。
$ sam --version
若要確認安裝成功，您應該會看到類似下列的輸出，但會以最新版SAMCLI本取代括號中的文字：
SAM CLI, <latest version>
安裝步驟
使用套件安裝程式來安裝 AWS SAM CLI。 此外，套件安裝程式有兩種安裝方法可供您選擇：GUI和命令列。您可以為所有使用者安裝，也可以只安裝目前的使用者。要為所有用戶安裝，需要超級用戶授權。
- GUI - All users
-
若要下載套件安裝程式並安裝 AWS SAM CLI
-
pkg將 macOS 下載到您選擇的目錄：
-
執行下載的檔案，然後依照螢幕上的指示繼續進行簡介、讀我說明和授權步驟。
-
在 「目的地選取」 中，選取「為此電腦的所有使用者安裝」。
-
對於「安裝類型」，請選擇 AWS SAM CLI 將安裝並按安裝。建議的預設位置為/usr/local/aws-sam-cli。
若要呼叫 AWS SAM CLI 使用此指sam令時，安裝程式會自動在/usr/local/bin/sam和/usr/local/aws-sam-cli/sam或您選擇的安裝資料夾之間建立符號連結。
-
所以此 AWS SAM CLI 將安裝並顯示安裝成功消息。按關閉。
驗證安裝成功
-
驗證 AWS SAM CLI 已正確安裝，並且您的符號鏈接是通過運行以下方式配置的：
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- GUI - Current user
-
若要下載並安裝 AWS SAM CLI
-
pkg將 macOS 下載到您選擇的目錄：
-
執行下載的檔案，然後依照螢幕上的指示繼續進行簡介、讀我說明和授權步驟。
-
針對 「目的地選取」，選取「僅為我安裝」。如果沒有看到此選項，請前往下一個步驟。
-
對於「安裝類型」，請執行下列操作：
-
選擇在哪裡 AWS SAM CLI 將被安裝。預設位置為 /usr/local/aws-sam-cli。選取您具有寫入權限的位置。若要變更安裝位置，請選取 [本機] 並選擇您的位置。完成後按繼續。
-
如果您在上一個步驟中沒有選擇「僅為我安裝」的選項，請選取「變更安裝位置」>「僅為我安裝」，然後按「繼續」。
-
按安裝。
-
所以此 AWS SAM CLI 將安裝並顯示安裝成功消息。按關閉。
驗證安裝成功
-
驗證 AWS SAM CLI 已正確安裝，並且您的符號鏈接是通過運行以下方式配置的：
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- Command line - All users
-
若要下載並安裝 AWS SAM CLI
-
pkg將 macOS 下載到您選擇的目錄：
-
修改並執行安裝指令碼：
$ 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, <latest version>
- Command line - Current user
-
若要下載並安裝 AWS SAM CLI
-
pkg將 macOS 下載到您選擇的目錄：
-
決定您具有寫入權限的安裝目錄。然後，使用範本建立xml檔案並加以修改，以反映您的安裝目錄。目錄必須已存在。
例如，如果您取代 path-to-my-directory 與/Users/myUser/Desktop，aws-sam-cli程序文件夾將安裝在那裡。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<array>
<dict>
<key>choiceAttribute</key>
<string>customLocation</string>
<key>attributeSetting</key>
<string>path-to-my-directory</string>
<key>choiceIdentifier</key>
<string>default</string>
</dict>
</array>
</plist>
-
儲存xml檔案並執行下列命令來確認檔案是否有效：
$ installer -pkg path-to-pkg-installer \
-target CurrentUserHomeDirectory \
-showChoicesAfterApplyingChangesXML path-to-your-xml-file
輸出應顯示將應用於 AWS SAM CLI 程序。
-
運行以下命令以安裝 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 已正確安裝，並且您的符號鏈接是通過運行以下方式配置的：
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
視窗安裝程式 (MSI) 檔案是 Windows 作業系統的套件安裝程式檔案。
請依照下列步驟安裝 AWS SAM CLI 使用該MSI文件。
-
下載最新版 AWS SAM CLI 64 位元。
-
(選擇性) 您可以在安裝之前驗證安裝程式的完整性。如需說明，請參閱 可選：驗證 AWS SAM CLI Installer (安裝程式)。
-
驗證安裝。
完成安裝後，通過打開新的命令提示符或 PowerShell 提示符進行驗證。您應該能夠sam從命令行調用。
sam --version
成功安裝後 AWS SAM CLI，您應該會看到如下所示的輸出：
SAM CLI, <latest version>
-
啟用長路徑 (僅限視窗 10 及更新版本)。
所以此 AWS SAM CLI 可能會與超過 Windows 最大路徑限制的檔案路徑互動。sam init由於 Windows 10 的MAX_PATH限制，這可能會在運行時導致錯誤。若要解決這個問題，必須設定新的長路徑行為。
若要啟用長路徑，請參閱 Microsoft 視窗應用程式開發文件中的「啟用 Windows 10、1607 版及更新版本」中的「啟用長路徑」。
-
安裝 Git。
若要使用sam init命令下載範例應用程式，您也必須安裝 Git。如需指示，請參閱安裝 Git。
排解安裝錯誤
Linux
碼頭錯誤：「無法連接到 Docker 守護進程。docker 守護程序是否在此主機上運行？」
在某些情況下，若要提供存取 Docker 精靈的權限，您可能必須重新啟動執行個體。ec2-user如果您收到此錯誤訊息，請嘗試重新啟動執行個體。
外殼錯誤：「找不到命令」
如果您收到這個錯誤，您的 shell 無法找到 AWS SAM CLI 路徑中的可執行文件。驗證您安裝的目錄的位置 AWS SAM CLI 可執行文件，然後驗證該目錄是否在您的路徑上。
AWS SAM CLI 錯誤：「/lib64/libc.so.6：找不到版本（由 /usr /本地/ /dist/libz.so.1 所需）」GLIBC aws-sam-cli
如果您收到此錯誤訊息，表示您使用的是不受支援的 Linux 版本，且內建 glibc 版本已過期。請嘗試下列其中一項：
macOS
安裝失敗
如果您正在安裝 AWS SAM CLI 針對您的使用者，並選取您沒有寫入權限的安裝目錄，可能會發生此錯誤。請嘗試下列其中一項：
-
選取您具有寫入權限的其他安裝目錄。
-
刪除安裝程式。然後，下載並再次運行它。
後續步驟
若要進一步瞭解 AWS SAM CLI 若要開始建置您自己的無伺服器應用程式，請參閱下列內容：
