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

# 安裝 Docker 以搭配 使用 AWS SAM CLI
<a name="install-docker"></a>

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

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

**Topics**
+ [安裝 Docker](#install-docker-instructions)
+ [後續步驟](#install-docker-next-steps)

## 安裝 Docker
<a name="install-docker-instructions"></a>

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

### Linux
<a name="install-docker-instructions-linux"></a>

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

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

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

   ```
   $ sudo yum update -y
   ```

1. 安裝最新的 Docker Community Edition 套件。
   + 對於 Amazon Linux 2，請執行下列動作：

     ```
     $ sudo amazon-linux-extras install docker
     ```
   + 對於 Amazon Linux 2023，請執行下列動作：

     ```
     $ sudo yum install -y docker
     ```

1. 啟動 Docker 服務。

   ```
   $ sudo service docker start
   ```

1. 將 `ec2-user`新增至 `docker`群組，讓您無需使用 即可執行Docker命令**sudo**。

   ```
   $ sudo usermod -a -G docker ec2-user
   ```

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

1. 確認 `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，請參閱 [對安裝錯誤進行故障診斷](install-sam-cli.md#sam-cli-troubleshoot-install)。或者，請參閱 Docker Docs 網站上的 **Linux 安裝後步驟**[疑難排解](https://docs.docker.com/engine/install/linux-postinstall/#troubleshooting)一節。

### macOS
<a name="install-docker-instructions-macos"></a>

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

1. 安裝 Docker

    AWS SAM CLI 支援在 macOS Sierra 10.12 或更新版本Docker上執行。如需如何安裝 Docker，請參閱 Docker 文件網站上的[安裝適用於 Mac 的Docker桌面](https://docs.docker.com/docker-for-mac/install/)。

1. 設定共用磁碟機

    AWS SAM CLI 需要將專案目錄或任何父目錄列在共用磁碟機中。這可能需要檔案共用。如需詳細資訊，請參閱 *Docker 文件*中的[磁碟區掛載需要檔案共用](https://docs.docker.com/desktop/troubleshoot-and-support/troubleshoot/topics/#volume-mounting-requires-file-sharing-for-any-project-directories-outside-of-home)疑難排解主題。

1. 驗證安裝

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

如果您在安裝 時遇到問題Docker，如需更多故障診斷秘訣，請參閱 Docker 文件網站的[故障診斷一節](https://docs.docker.com/docker-for-mac/troubleshoot/)。

### Windows
<a name="install-docker-instructions-windows"></a>

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

1. 安裝 Docker。

   Docker 桌面支援最新的 Windows 作業系統。對於舊版 Windows，可使用 Docker 工具箱。選擇您的 Windows 版本，以取得正確的Docker安裝步驟：
   + 若要安裝Docker適用於 Windows 10 的 ，請參閱 Docker 文件網站上的[安裝適用於 Windows 的Docker桌面](https://docs.docker.com/docker-for-windows/install/)。
   + 若要Docker為舊版 Windows 安裝 ，請參閱 [Docker Toolbox](https://github.com/docker-archive/toolbox) GitHub 儲存庫上的Docker工具箱。

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

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

1. 驗證安裝。

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

如果您在安裝 時遇到問題Docker，如需更多故障診斷秘訣，請參閱 Docker 文件網站的[故障診斷一節](https://docs.docker.com/docker-for-mac/troubleshoot/)。

## 後續步驟
<a name="install-docker-next-steps"></a>

如需如何安裝 AWS SAM CLI，請參閱 [安裝 AWS SAM CLI](install-sam-cli.md)。