安裝 Docker 以搭配 使用 AWS SAM CLI - AWS Serverless Application Model
安裝 Docker後續步驟

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

安裝 Docker 以搭配 使用 AWS SAM CLI

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

注意

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

安裝 Docker

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

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

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

  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 安裝後步驟疑難排解一節。

注意

Docker 桌面已正式支援，但從 AWS SAM CLI 1.47.0 版開始，只要它們使用Docker執行時間，您就可以使用替代方案。

  1. 安裝 Docker

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

  2. 設定共用磁碟機

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

  3. 驗證安裝

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

如果您在安裝 時遇到問題Docker，如需更多故障診斷秘訣，請參閱 Docker 文件網站的故障診斷一節。

注意

AWS SAM 正式支援 Docker Desktop。不過，從 AWS SAM CLI 1.47.0 版開始，只要替代方案使用Docker執行時間，您就可以使用它們。

  1. 安裝 Docker。

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

  2. 設定您的共用磁碟機。

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

  3. 驗證安裝。

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

如果您在安裝 時遇到問題Docker，如需更多故障診斷秘訣，請參閱 Docker 文件網站的故障診斷一節。

後續步驟

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