AWS SAM CLI で Docker を使用するためのインストール方法 - AWS Serverless Application Model
Docker のインストール次のステップ

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

AWS SAM CLI で Docker を使用するためのインストール方法

Docker はマシン上でコンテナを実行するアプリケーションです。 AWS SAM を使用するとDocker、 のようなローカル環境をコンテナ AWS Lambda として提供して、サーバーレスアプリケーションを構築、テスト、デバッグできます。

注記

Docker が必要になるのは、アプリケーションをローカルでテストする場合と、--use-container オプションを使用してデプロイパッケージをビルドする場合だけです。

Docker のインストール

お使いのオペレーティングシステムに Docker をインストールするには、次の手順に従ってください。

Docker は、CentOS、Debian、および Ubuntu など、最新の Linux ディストリビューションを含めたさまざまなオペレーティングシステムで使用できます。特定のオペレーティングシステムへの Docker のインストールについては、Docker Docs ウェブサイトで「Get 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 グループに追加して、sudo を使用せずに Docker コマンドを実行できるようにします。

    $ sudo usermod -a -G docker ec2-user

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

  6. 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 のインストールで問題が発生した場合は、「 インストールエラーのトラブルシューティング」を参照してください。または、Docker Docs ウェブサイトの Post-installation steps for Linux にある「Troubleshooting」セクションを参照してください。

注記

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」を参照してください。

  2. 共有ドライブの構成

    AWS SAMCLI では、プロジェクトディレクトリまたは親ディレクトリが共有ドライブに一覧表示されている必要があります。これにはファイル共有が必要になる場合があります。詳細については、Docker ドキュメントの「ボリュームのマウントにはファイル共有が必要です」のトラブルシューティングのトピックを参照してください。

  3. インストールの検証

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

Docker のインストールで問題が発生した場合は、トラブルシューティングのヒントを紹介している Docker Docs ウェブサイトの「Troubleshoot and diagnose」セクションを参照してください。

注記

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」を参照してください。

    • 以前のバージョンの Windows Dockerに をインストールするには、DockerToolbox GitHub リポジトリのDocker「ツールボックス」を参照してください。

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

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

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

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

Docker のインストールで問題が発生した場合は、トラブルシューティングのヒントを紹介している Docker Docs ウェブサイトの「Troubleshoot and diagnose」セクションを参照してください。

次のステップ

のインストール方法については、 AWS SAMCLI「」を参照してください  のインストール AWS SAM CLI。