翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS SAM CLI で Docker を使用するためのインストール方法
<a name="install-docker"></a>

Docker はマシン上でコンテナを実行するアプリケーションです。 AWS SAM を使用するとDocker、 は のようなローカル環境をコンテナ 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 は、CentOS、Debian、および Ubuntu など、最新の Linux ディストリビューションを含めたさまざまなオペレーティングシステムで使用できます。特定のオペレーティングシステムへの Docker のインストールについては、Docker Docs ウェブサイトで「[Get Docker](https://docs.docker.com/get-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` グループに追加して、**sudo** を使用せずに Docker コマンドを実行できるようにします。

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

1. ログアウトしてから再度ログインして、新しい `docker` グループ許可を取得します。これを実行するには、現在の SSH ターミナルウィンドウを閉じ、新しいウィンドウでインスタンスに再接続します。新しい SSH セッションには適切な `docker` グループ許可が必要です。

1. `ec2-user` が **sudo** を使用せずに Docker コマンドを実行できることを確認します。

   ```
   $ 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 ウェブサイトの **Post-installation steps for Linux** にある「[Troubleshooting](https://docs.docker.com/engine/install/linux-postinstall/#troubleshooting)」セクションを参照してください。

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

**注記**  
Docker Desktop がサポートされていますが、 AWS SAM CLI バージョン 1.47.0 以降では、Docker ランタイムを使用する代替手段を使用できます。

1. Docker をインストールする

    AWS SAM CLI では、macOS Sierra 10.12 以降で動作する Docker がサポートされています。Docker のインストール方法については、Docker Docs ウェブサイトの「[Install Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/install/)」を参照してください。

1. 共有ドライブの構成

    AWS SAM CLI では、プロジェクトディレクトリまたは親ディレクトリが共有ドライブにリストされている必要があります。これにはファイル共有が必要になる場合があります。詳細については、「*Docker ドキュメント*」のトラブルシューティングトピック「[Volume mounting requires file sharing](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 Docs ウェブサイトの「[Troubleshoot and diagnose](https://docs.docker.com/docker-for-mac/troubleshoot/)」セクションを参照してください。

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

**注記**  
AWS SAM は Docker Desktop を正式にサポートしています。ただし、 AWS SAM CLI バージョン 1.47.0 以降では、Docker ランタイムを使用する代替手段を使用できます。

1. Docker をインストールします。

   Docker Desktop は、最新の Windows オペレーティングシステムをサポートしています。Windows の旧バージョンでは、Docker Toolbox を使用できます。正しい手順で Docker のインストールを行うため、Windows のバージョンを選択してください。
   + Windows 10 用 Docker をインストールするには、Docker Docs ウェブサイトの「[Install Docker Desktop for Windows](https://docs.docker.com/docker-for-windows/install/)」を参照してください。
   + 旧バージョンの Windows に Docker をインストールするには、Docker Toolbox GitHub リポジトリの「[Docker Toolbox](https://github.com/docker-archive/toolbox)」を参照してください。

1. 共有ドライブを設定します。

    AWS SAM CLI では、プロジェクトディレクトリまたは親ディレクトリが共有ドライブにリストされている必要があります。Docker を正しく機能させるには、ドライブを共有する必要が生じる場合があります。

1. インストールを確認します。

   Docker がインストールされたら、動作していることを検証します。また、コマンドラインから Docker コマンドを実行できることを確認します (**docker ps** など)。コンテナをインストール、フェッチ、またはプルする必要はありません。これらは、 AWS SAM CLI が必要に応じて自動的に行います。

Docker のインストールで問題が発生した場合は、トラブルシューティングのヒントを紹介している Docker Docs ウェブサイトの「[Troubleshoot and diagnose](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)。