安裝 Docker 以搭配 使用 AWS SAM CLI

Docker 是在您的機器上執行容器的應用程式。使用 Docker， AWS SAM 可以提供類似 AWS Lambda 容器的本機環境，以建置、測試和偵錯無伺服器應用程式。

注意

Docker 只有在本機測試應用程式，以及使用 --use-container選項建置部署套件時，才需要 。

安裝 Docker

請依照這些指示安裝 Docker 在您的作業系統上。

Linux

Docker 可在許多不同的作業系統上使用，包括最現代化的 Linux 發行版本，例如 CentOS, Debian 和 Ubuntu。 如需有關安裝 的資訊 Docker 請參閱 Docker Docs 網站上的取得 Docker。

安裝 Docker 在 Amazon Linux 2 或 Amazon Linux 2023 上

1. 更新已安裝的套裝服務，並在執行個體上封裝快取。

   $ sudo yum update -y

2. 安裝最新的 Docker Community Edition 套件。

   • 針對 Amazon Linux 2，執行下列動作：

     $ sudo amazon-linux-extras install docker

   • 對於 Amazon Linux 2023，請執行下列操作：

     $ sudo yum install -y docker

3. 啟動 Docker 服務。

   $ sudo service docker start

4. 將 ec2-user新增至docker群組，以便您可以執行 Docker 不使用 的 命令sudo。

   $ sudo usermod -a -G docker ec2-user

5. 登出並再次登入，以取得新的docker群組許可。若要執行此操作，請關閉目前的SSH終端機視窗，然後重新連線至新的執行個體。您的新SSH工作階段應具有適當的docker群組許可。

6. 確認 ec2-user可以在不使用 的情況下執行 Docker 命令sudo。

   $ docker ps

   您應該會看到下列輸出，確認已安裝並執行 Docker：

    CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES

注意

在 Linux 上，若要使用與主機機器不同的指令集架構建置和執行 Lambda 函數，還有其他步驟可設定 Docker。 例如，若要在x86_64機器上執行arm64函數，您可以執行下列命令來設定 Docker 常駐程式：docker run --rm --privileged multiarch/qemu-user-static --reset -p yes。

如果您遇到安裝問題 Docker，請參閱排解安裝錯誤。或者，請參閱 Docker Docs 網站上的 Linux 安裝後步驟疑難排解一節。

macOS

注意

Docker 正式支援桌面，但開頭為 AWS SAM CLI 1.47.0 版，只要使用 Docker 執行時間。

1. 安裝 Docker

   的 AWS SAM CLI 支援 Docker 在 macOS Sierra 10.12 或更新版本上執行。如需了解如何安裝 Docker，請參閱安裝 Docker 上的適用於 Mac 的桌面 Docker 文件網站。

2. 設定共用磁碟機

   的 AWS SAM CLI 要求專案目錄或任何父目錄在共用磁碟機中列出。這可能需要檔案共用。如需詳細資訊，請參閱磁碟區掛載需要檔案共用疑難排解主題，網址為： Docker 文件 。

3. 驗證安裝

   After Docker 已安裝，請確認它是否正常運作。同時確認您可以執行 Docker 命令 （例如 docker ps）。您不需要安裝、擷取或提取任何容器， AWS SAM CLI 會視需要自動執行此操作。

如果您遇到安裝問題 Docker，如需更多疑難排解秘訣，請參閱 的疑難排解和診斷一節 Docker 文件網站。

Windows

注意

AWS SAM 正式支援 Docker 桌面。不過，從 AWS SAM CLI 1.47.0 版，只要使用 Docker 執行時間。

1. 安裝 Docker.

   Docker 桌面支援最新的 Windows 作業系統。對於舊版 Windows，Docker 工具箱可用。選擇您 Windows 的版本，以取得正確的 Docker 安裝步驟：

   • 安裝 Docker 對於 Windows 10，請參閱安裝 Docker 上的 Windows 桌面 Docker 文件網站。

   • 安裝 Docker 如需舊版 Windows，請參閱 Docker 上的工具箱 Docker 工具箱 GitHub 儲存庫。

2. 設定共用磁碟機。

   的 AWS SAM CLI 要求專案目錄或任何父目錄在共用磁碟機中列出。在某些情況下，您必須為 共用磁碟機 Docker 才能正常運作。

3. 驗證安裝。

   After Docker 已安裝，請確認它是否正常運作。同時確認您可以執行 Docker 來自命令列的命令 （例如 docker ps）。您不需要安裝、擷取或提取任何容器， AWS SAM CLI 會視需要自動執行此操作。

如果您遇到安裝問題 Docker，如需更多疑難排解秘訣，請參閱 的疑難排解和診斷一節 Docker 文件網站。

後續步驟

如需了解如何安裝 AWS SAM CLI，請參閱安裝 AWS SAM CLI。