翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # AWS SAM CLI のインストール 「」の手順に従って、サポートされているオペレーティングシステムに AWS Serverless Application Model コマンドラインインターフェイス (AWS SAM CLI) の最新リリースをインストールします[ステップ 4: をインストールする AWS CLI](prerequisites.md#prerequisites-install-cli)。 ナイトリービルドのアップグレード AWS SAM CLI、アンインストール、管理の方法など、現在インストールされているバージョンの の管理については、「」を参照してください[AWS SAM CLI バージョンの管理](manage-sam-cli-versions.md)。 **AWS SAM CLI CLI を初めてインストールする場合:** 次に進む前に、前のセクションの[前提条件](prerequisites.md)をすべて満たします。これには、以下が含まれます。 AWS アカウントにサインアップする。 への安全なアクセスをセットアップします AWS。 アクセスキー ID とシークレットアクセスキーを作成する。 のインストール AWS CLI。 AWS 認証情報の設定。 **Topics** + [AWS SAM CLIのインストール](#install-sam-cli-instructions) + [インストールエラーのトラブルシューティング](#sam-cli-troubleshoot-install) + [次の手順](#install-sam-cli-next-steps) + [オプション: AWS SAM CLI インストーラの整合性を検証する](reference-sam-cli-install-verify.md) ## AWS SAM CLIのインストール **注記** 2023 年 9 月以降、 AWS は AWS SAM CLI () の AWS マネージドHomebrewインストーラーを維持しなくなります`aws/tap/aws-sam-cli`。Homebrew を使用して をインストールおよび管理する場合は AWS SAM CLI、次のオプションを参照してください。 Homebrew を引き続き使用するには、コミュニティ管理のインストーラーを使用します。詳細については、「[Homebrew で  AWS SAM CLI を管理する](manage-sam-cli-versions.md#manage-sam-cli-versions-homebrew)」を参照してください。 このページに記載されているファーストパーティ製のインストール方法のいずれかを使用することをお勧めします。これらの方法のいずれかを使用する前に、[Homebrew から移行する](manage-sam-cli-versions.md#manage-sam-cli-versions-switch) を参照してください。 さらなる詳細については、「[リリースバージョン: 1.121.0](https://github.com/aws/aws-sam-cli/releases) 」を参照してください。 をインストールするには AWS SAM CLI、オペレーティングシステムの手順に従います。 ### Linux ------ #### [ x86\_64 - command line installer ] 1. [AWS SAM CLI .zip ファイル](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-x86_64.zip)を任意のディレクトリにダウンロードします。 1. **(オプション)** インストール前にインストーラーの整合性を確認できます。手順については、「[オプション: AWS SAM CLI インストーラの整合性を検証する](reference-sam-cli-install-verify.md)」を参照してください。 1. インストールファイルを任意のディレクトリに解凍します。`sam-installation` サブディレクトリを使用した例を次に示します。 **注記** オペレーティングシステムに組み込み **unzip** コマンドがない場合は、同等のコマンドを使用します。 ``` $ unzip aws-sam-cli-linux-x86_64.zip -d {{sam-installation}} ``` 1. `install` 実行可能ファイルを実行して AWS SAM CLI をインストールします。この実行可能ファイルは、前のステップで使用したディレクトリにあります。`sam-installation` サブディレクトリを使用した例を次に示します。 ``` $ sudo ./{{sam-installation}}/install ``` 1. インストールを確認します。 ``` $ sam --version ``` 表示される次のような出力で、正常にインストールされていることを確認します。角括弧で囲まれたテキストは、利用可能な最新バージョンに置き換わります。 ``` SAM CLI, {{}} ``` ------ #### [ arm64 - command line installer ] 1. [AWS SAM CLI .zip ファイル](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-arm64.zip)を任意のディレクトリにダウンロードします。 1. **(オプション)** インストール前にインストーラーの整合性を確認できます。手順については、「[オプション: AWS SAM CLI インストーラの整合性を検証する](reference-sam-cli-install-verify.md)」を参照してください。 1. インストールファイルを任意のディレクトリに解凍します。`sam-installation` サブディレクトリを使用した例を次に示します。 **注記** オペレーティングシステムに組み込み **unzip** コマンドがない場合は、同等のコマンドを使用します。 ``` $ unzip aws-sam-cli-linux-arm64.zip -d {{sam-installation}} ``` 1. `install` 実行可能ファイルを実行して AWS SAM CLI をインストールします。この実行可能ファイルは、前のステップで使用したディレクトリにあります。`sam-installation` サブディレクトリを使用した例を次に示します。 ``` $ sudo ./{{sam-installation}}/install ``` 1. インストールを確認します。 ``` $ sam --version ``` 表示される次のような出力で、インストールが成功したことを確認します。角括弧付きのテキストは、最新の SAM CLI バージョンに置き換わります。 ``` SAM CLI, {{}} ``` ------ ### macOS #### インストール手順 パッケージインストーラを使用して をインストールします AWS SAM CLI。さらに、このパッケージインストーラには、**GUI** と**コマンドライン**の 2 つのインストール方法があります。インストールの対象は、**すべてのユーザー**にすることも、**現在のユーザー**のみにすることもできます。すべてのユーザーにインストールするには、スーパーユーザー承認が必要です。 **注記** AWS SAM CLI はMacOS 13.x より古いバージョンの MacOS をサポートしていません。サポートされているバージョンの MacOS にアップグレードするか、 で AWS SAM CLI をインストールしますHomebrew。 ------ #### [ GUI - All users ] **パッケージインストーラをダウンロードして AWS SAM CLI をインストールするには** **注記** 以前に Homebrew または pip を使用して AWS SAM CLI をインストールした場合は、まずその CLI をアンインストールする必要があります。手順については、「[AWS SAM CLI のアンインストール](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall)」を参照してください。 1. macOS `pkg` を好みのディレクトリにダウンロードします。 + **Intel プロセッサーを実行している Mac の場合は、[x86\_64]** – [[aws-sam-cli-macos-x86\_64.pkg]](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) を選択します。 + **Apple シリコンを実行している Mac の場合は、[arm64]** – [[aws-sam-cli-macos-arm64.pkg]](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) を選択します。 **注記** オプションで、インストール前にインストーラーの整合性を確認することができます。手順については、「[オプション: AWS SAM CLI インストーラの整合性を検証する](reference-sam-cli-install-verify.md)」を参照してください。 1. ダウンロードしたファイルを実行し、画面の指示に従って、「**はじめに**」、「**Read me**」、「**ライセンス**」の手順を続けてください。 1. **[Destination Select]** (インストール先の選択) で、**[Install for all users of this computer]** (このコンピュータのすべてのユーザーにインストール) を選択します。 1. **[Installation Type]** (インストールタイプ) で、 AWS SAM CLI をインストールする場所を選択し、**[Install]** (インストール) を押します。推奨されるデフォルトの場所は `/usr/local/aws-sam-cli` です。 **注記** **sam** コマンドで AWS SAM CLI を呼び出すために、インストーラは `/usr/local/bin/sam` と `/usr/local/aws-sam-cli/sam` または選択したインストールフォルダのいずれかとの間のシンボリックリンクを自動的に作成します。 1. AWS SAM CLI がインストールされ、「The installation was successful」(インストールは成功しました) というメッセージが表示されます。**[Close]** (閉じる) を押します。 **正常にインストールされたことを確認するには** + AWS SAM CLI が正しくインストールされ、シンボリックリンクが設定されていることを確認するには、次のコマンドを実行します。 ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ GUI - Current user ] **AWS SAM CLI をダウンロードしてインストールするには** **注記** 以前に Homebrew または pip を使用して AWS SAM CLI をインストールした場合は、まずその CLI をアンインストールする必要があります。手順については、「[AWS SAM CLI のアンインストール](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall)」を参照してください。 1. macOS `pkg` を好みのディレクトリにダウンロードします。 + **Intel プロセッサーを実行している Mac の場合は、[x86\_64]** – [[aws-sam-cli-macos-x86\_64.pkg]](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) を選択します。 + **Apple シリコンを実行している Mac の場合は、[arm64]** – [[aws-sam-cli-macos-arm64.pkg]](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) を選択します。 **注記** オプションで、インストール前にインストーラーの整合性を確認することができます。手順については、「[オプション: AWS SAM CLI インストーラの整合性を検証する](reference-sam-cli-install-verify.md)」を参照してください。 1. ダウンロードしたファイルを実行し、画面の指示に従って、「**はじめに**」、「**Read me**」、「**ライセンス**」の手順を続けてください。 1. **[Destination Select]** (インストール先の選択) で、**[Install for me only]** (現在のユーザーのみにインストール) を選択します。このオプションが表示されない場合は、次の手順に進みます。 1. **[Installation Type]** (インストールタイプ) で、以下を実行します。 1. AWS SAM CLI をインストールする場所を選択します。デフォルトの場所は `/usr/local/aws-sam-cli` です。書き込み権限が付与されている場所を選択してください。インストール場所を変更するには、**[local]** (ローカル) を選択し、場所を選択します。完了したら、**[Continue]** (続行) を押します。 1. 前のステップで **[Install for me only]** (現在のユーザーのみにインストール) を選択するオプションが表示されない場合は、**[Change Install Location]** (インストール場所を変更) > **[Install for me only]** (現在のユーザーのみにインストール) を選択し、**[Continue]** (続行) を押します。 1. **[Install]** (インストール) を押します。 1. AWS SAM CLI がインストールされ、**「The installation was successful」**(インストールは成功しました) というメッセージが表示されます。**[Close]** (閉じる) を押します。 **シンボリックリンクを作成するには** + **sam** コマンドで AWS SAM CLI を呼び出すには、 AWS SAM CLI プログラムと `$PATH` との間のシンボリックリンクを手動で作成する必要があります。次のコマンドを変更および実行して、シンボリックリンクを作成します。 ``` $ {{sudo}} ln -s {{/path-to}}/aws-sam-cli/sam {{/path-to-symlink-directory}}/sam ``` + {{sudo}} — ユーザーが `$PATH` への書き込み権限を持っている場合、**sudo** は必須ではありません。それ以外の場合、**sudo** が必要です。 + {{path-to}} — AWS SAM CLI プログラムをインストールした場所へのパス。例えば、`/Users/myUser/Desktop`。 + {{path-to-symlink-directory}} — `$PATH` の環境変数。デフォルトの場所は `/usr/local/bin` です。 **正常にインストールされたことを確認するには** + AWS SAM CLI が正しくインストールされ、シンボリックリンクが設定されていることを確認するには、次のコマンドを実行します。 ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ Command line - All users ] **AWS SAM CLI をダウンロードしてインストールするには** **注記** 以前に Homebrew または pip を使用して AWS SAM CLI をインストールした場合は、まずその CLI をアンインストールする必要があります。手順については、「[AWS SAM CLI のアンインストール](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall)」を参照してください。 1. macOS `pkg` を好みのディレクトリにダウンロードします。 + **Intel プロセッサーを実行している Mac の場合は、[x86\_64]** – [[aws-sam-cli-macos-x86\_64.pkg]](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) を選択します。 + **Apple シリコンを実行している Mac の場合は、[arm64]** – [[aws-sam-cli-macos-arm64.pkg]](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) を選択します。 **注記** オプションで、インストール前にインストーラーの整合性を確認することができます。手順については、「[オプション: AWS SAM CLI インストーラの整合性を検証する](reference-sam-cli-install-verify.md)」を参照してください。 1. インストールスクリプトを変更および実行します。 ``` $ sudo installer -pkg {{path-to-pkg-installer}}/{{name-of-pkg-installer}} -target / installer: Package name is AWS SAM CLI installer: Upgrading at base path / installer: The upgrade was successful. ``` **注記** **sam** コマンドで AWS SAM CLI を呼び出すため、インストーラは、`/usr/local/bin/sam` と `/usr/local/aws-sam-cli/sam` の間のシンボリックリンクを自動的に作成します。 **正常にインストールされたことを確認するには** + AWS SAM CLI が正しくインストールされ、シンボリックリンクが設定されていることを確認するには、次のコマンドを実行します。 ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ Command line - Current user ] **AWS SAM CLI をダウンロードしてインストールするには** **注記** 以前に Homebrew または pip を使用して AWS SAM CLI をインストールした場合は、まずその CLI をアンインストールする必要があります。手順については、「[AWS SAM CLI のアンインストール](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall)」を参照してください。 1. macOS `pkg` を好みのディレクトリにダウンロードします。 + **Intel プロセッサーを実行している Mac の場合は、[x86\_64]** – [[aws-sam-cli-macos-x86\_64.pkg]](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) を選択します。 + **Apple シリコンを実行している Mac の場合は、[arm64]** – [[aws-sam-cli-macos-arm64.pkg]](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) を選択します。 **注記** オプションで、インストール前にインストーラーの整合性を確認することができます。手順については、「[オプション: AWS SAM CLI インストーラの整合性を検証する](reference-sam-cli-install-verify.md)」を参照してください。 1. 書き込み権限のあるインストールディレクトリを決定します。次に、テンプレートを使用して `xml` ファイルを作成し、インストールディレクトリを反映するようにファイルを変更します。ディレクトリは既に存在している必要があります。 例えば、{{path-to-my-directory}} を `/Users/myUser/Desktop` に置き換えると、`aws-sam-cli` プログラムフォルダがそこにインストールされます。 ``` choiceAttribute customLocation attributeSetting {{path-to-my-directory}} choiceIdentifier default ``` 1. `xml` ファイルを保存し、以下を実行して有効であることを確認します。 ``` $ installer -pkg {{path-to-pkg-installer}} \ -target CurrentUserHomeDirectory \ -showChoicesAfterApplyingChangesXML {{path-to-your-xml-file}} ``` 出力には、 AWS SAM CLI プログラムに適用される設定が表示されるはずです。 1. をインストールするには、以下を実行します AWS SAM CLI。 ``` $ installer -pkg {{path-to-pkg-installer}} \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML {{path-to-your-xml-file}} # Example output installer: Package name is AWS SAM CLI installer: choices changes file '{{path-to-your-xml-file}}' applied installer: Upgrading at base path {{base-path-of-xml-file}} installer: The upgrade was successful. ``` **シンボリックリンクを作成するには** + **sam** コマンドで AWS SAM CLI を呼び出すには、 AWS SAM CLI プログラムと `$PATH` との間のシンボリックリンクを手動で作成する必要があります。次のコマンドを変更および実行して、シンボリックリンクを作成します。 ``` $ {{sudo}} ln -s {{/path-to}}/aws-sam-cli/sam {{/path-to-symlink-directory}}/sam ``` + {{sudo}} — ユーザーが `$PATH` への書き込み権限を持っている場合、**sudo** は必須ではありません。それ以外の場合、**sudo** が必要です。 + {{path-to}} — AWS SAM CLI プログラムをインストールした場所へのパス。例えば、`/Users/myUser/Desktop`。 + {{path-to-symlink-directory}} — `$PATH` の環境変数。デフォルトの場所は `/usr/local/bin` です。 **正常にインストールされたことを確認するには** + AWS SAM CLI が正しくインストールされ、シンボリックリンクが設定されていることを確認するには、次のコマンドを実行します。 ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ ### Server Windows インストーラ (MSI) ファイルは、Windows オペレーティングシステムのパッケージインストーラファイルです。 これらの手順に従って、MSI ファイルを使用して AWS SAM CLI をインストールします。 1. AWS SAM CLI [64 ビット](https://github.com/aws/aws-sam-cli/releases/latest/download/AWS_SAM_CLI_64_PY3.msi)をダウンロードします。 1. **(オプション)** インストール前にインストーラーの整合性を確認できます。手順については、「[オプション: AWS SAM CLI インストーラの整合性を検証する](reference-sam-cli-install-verify.md)」を参照してください。 1. インストールを確認します。 インストールが完了したら、新しいコマンドプロンプトまたは PowerShell プロンプトを開いて確認します。コマンドラインから `sam` を呼び出すことができるはずです。 ``` sam --version ``` が正常にインストールされると AWS SAM CLI、次のような出力が表示されます。 ``` SAM CLI, {{}} ``` 1. ロングパスを有効にします (Windows 10 以降のみ)。 **重要** は、Windows の最大パス制限を超えるファイルパスとやり取り AWS SAM CLIする場合があります。これにより、Windows 10 **MAX\_PATH** の制限が原因で、`sam init` の実行時にエラーが発生することがあります。この問題を解決するには、新しい長いパスの動作を設定する必要があります。 長いパスを有効にするには、Microsoft の「*Windows アプリの開発に関するドキュメント*」で「[Windows 10 バージョン 1607 以降で長いパスを有効にする](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later)」を参照してください。 1. Git のインストール `sam init` コマンドを使用してサンプルアプリケーションをダウンロードするには、Git をインストールする必要があります。手順については、「[Git のインストール](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)」を参照してください。 ## インストールエラーのトラブルシューティング ### Linux #### Docker エラー: 「Cannot connect to the Docker daemon。Is the docker daemon running on this host?」 `ec2-user` が Docker デーモンにアクセスするための許可の提供には、インスタンスの再起動が必要になる場合があります。このエラーが表示された場合は、インスタンスを再起動してみてください。 #### シェルエラー: 「command not found」 このエラーが表示された場合は、シェルがパス内の AWS SAM CLI 実行可能ファイルを見つけられません。 AWS SAM CLI 実行可能ファイルをインストールしたディレクトリの場所を確認してから、ディレクトリがパス上にあることを確認します。 #### AWS SAM CLI エラー: 「/lib64/libc.so.6: version `GLIBC\_2.14' not found (required by /usr/local/aws-sam-cli/dist/libz.so.1)」 このエラーが表示された場合は、サポートされていないバージョンの Linux を使用しており、組み込みの glibc バージョンが古くなっています。以下のいずれかを実行してみてください。 + Linux ホストを CentOS、Fedora、Ubuntu、または Amazon Linux 2 の最新ディストリビューションの 64 ビット版にアップグレードする。 + 「[AWS SAM CLI のインストール](#install-sam-cli)」の手順を実行する。 ### macOS #### インストールが失敗しました ![インストール失敗のメッセージを表示している AWS SAM CLI インストーラの画像](http://docs.aws.amazon.com/ja_jp/serverless-application-model/latest/developerguide/images/sam-cli-troubleshoot-install-macos-install-failed.jpg) ユーザー用に AWS SAM CLI をインストールするときに、書き込み権限のないインストールディレクトリを選択した場合、このエラーが発生する可能性があります。以下のいずれかを実行してみてください。 1. 書き込み権限のある別のインストールディレクトリを選択してください。 1. インストーラを削除します。次に、再度インストーラをダウンロードして実行します。 ## 次の手順 AWS SAM CLIと、独自のサーバーレスアプリケーションの構築に関する詳細については、以下を参照してください。 + [チュートリアル: を使用して Hello World アプリケーションをデプロイする AWS SAM](serverless-getting-started-hello-world.md) - 基本的なサーバーレスアプリケーションをダウンロード、構築、およびデプロイするためのステップバイステップの手順です。 + [完全な AWS SAM ワークショップ](https://catalog.workshops.aws/complete-aws-sam/en-US) – AWS SAM が提供する主要な機能の多くを学習するために設計されたワークショップ。 + [AWS SAM サンプルアプリケーションとパターン](https://serverlessland.com/patterns?framework=AWS+SAM) – さらに実験できるコミュニティ作成者からのサンプルアプリケーションとパターン。