のインストール AWS SAM CLI - AWS Serverless Application Model

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

  のインストール AWS SAM CLI

の最新リリースをインストールする AWS Serverless Application Model コマンドラインインターフェイス (AWS SAM CLI) がサポートされるオペレーティングシステム。

現在インストールされている のバージョンを管理する方法については、 AWS SAM CLIナイトリービルドのアップグレード、アンインストール、管理の方法を含む については、「」を参照してくださいAWS SAM CLI バージョンの管理

を初めてインストールする場合 AWS SAM CLI?

次に進む前に、前のセクションの前提条件をすべて満たします。これには、以下が含まれます。

  1. にサインアップする AWS アカウント。

  2. 管理IAMユーザーの作成。

  3. アクセスキー ID とシークレットアクセスキーを作成する。

  4.  のインストール AWS CLI.

  5. 設定 AWS 認証情報。

 のインストール AWS SAM CLI

注記

2023 年 9 月から、 AWS は を維持しなくなります。 AWS マネージド Homebrew の インストーラ AWS SAM CLI (aws/tap/aws-sam-cli)。 を使用する場合 Homebrew をインストールして管理する AWS SAM CLI、以下のオプションを参照してください。

  • を引き続き使用するには Homebrew、コミュニティマネージドインストーラを使用できます。詳細については、「Homebrew で  AWS SAM CLI を管理する」を参照してください。

  • このページに記載されているファーストパーティ製のインストール方法のいずれかを使用することをお勧めします。これらの方法のいずれかを使用する前に、Homebrew から移行する を参照してください。

  • 詳細については、「リリースバージョン: 1.121.0」を参照してください。

  をインストールするには AWS SAM CLIお使いのオペレーティングシステムの指示に従ってください。

x86_64 - command line installer
  1. のダウンロードAWS SAM CLI .zip ファイルを任意のディレクトリに圧縮します。

  2. (オプション) インストール前にインストーラーの整合性を確認できます。手順については、オプション: の整合性を検証する AWS SAM CLI installer を参照してください。

  3. インストールファイルを任意のディレクトリに解凍します。sam-installation サブディレクトリを使用した例を次に示します。

    注記

    オペレーティングシステムに組み込み unzip コマンドがない場合は、同等のコマンドを使用します。

    $ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
  4.   のインストール AWS SAM CLI install 実行ファイルを実行する 。この実行可能ファイルは、前のステップで使用したディレクトリにあります。sam-installation サブディレクトリを使用した例を次に示します。

    $ sudo ./sam-installation/install
  5. インストールを確認します。

    $ sam --version

    正常にインストールされたことを確認するには、次の角括弧で囲まれたテキストを利用可能な最新バージョンに置き換える出力が表示されます。

     SAM CLI, <latest version>
arm64 - command line installer
  1. のダウンロードAWS SAM CLI .zip ファイルを任意のディレクトリに圧縮します。

  2. (オプション) インストール前にインストーラーの整合性を確認できます。手順については、オプション: の整合性を検証する AWS SAM CLI installer を参照してください。

  3. インストールファイルを任意のディレクトリに解凍します。sam-installation サブディレクトリを使用した例を次に示します。

    注記

    オペレーティングシステムに組み込み unzip コマンドがない場合は、同等のコマンドを使用します。

    $ unzip aws-sam-cli-linux-arm64.zip -d sam-installation
  4.   のインストール AWS SAM CLI install 実行ファイルを実行する 。この実行可能ファイルは、前のステップで使用したディレクトリにあります。sam-installation サブディレクトリを使用した例を次に示します。

    $ sudo ./sam-installation/install
  5. インストールを確認します。

    $ sam --version

    正常にインストールされたことを確認するには、次のような出力が表示されますが、角括弧で囲まれたテキストはSAMCLI最新バージョンに置き換えられます。

     SAM CLI, <latest version>

インストール手順

パッケージインストーラーを使用して をインストールする AWS SAM CLI。 さらに、パッケージインストーラには、 GUIコマンドライン の 2 つのインストール方法があります。は、すべてのユーザーにインストールすることも、現在のユーザー にのみインストールすることもできます。すべてのユーザーにインストールするには、スーパーユーザー承認が必要です。

GUI - All users
パッケージインストーラをダウンロードして をインストールするには AWS SAM CLI
注記

以前に をインストールしたことがある場合 AWS SAM CLI から Homebrew または pip、最初にアンインストールする必要があります。手順については、AWS SAM CLI のアンインストール を参照してください。

  1. macOS を任意のディレクトリpkgにダウンロードします。

    • Intel プロセッサを実行している Mac の場合は、x86_64 – -x86_64.pkg を選択します。 aws-sam-cli-macos

    • Apple シリコンを実行している Mac の場合は、arm64 – -arm64.pkg を選択します。 aws-sam-cli-macos

    注記

    インストール前にインストーラの整合性を検証するオプションがあります。手順については、オプション: の整合性を検証する AWS SAM CLI installer を参照してください。

  2. ダウンロードしたファイルを実行し、画面の指示に従って、「はじめに」、「Read me」、「ライセンス」の手順を続けてください。

  3. [Destination Select] (インストール先の選択) で、[Install for all users of this computer] (このコンピュータのすべてのユーザーにインストール) を選択します。

  4. インストールタイプ で、 AWS SAM CLI がインストールされ、インストール キーを押します。推奨されるデフォルトの場所は /usr/local/aws-sam-cli です。

    注記

    を呼び出すには AWS SAM CLI sam コマンドを使用すると、インストーラは /usr/local/bin/sam/usr/local/aws-sam-cli/samまたは選択したインストールフォルダの間にシンボリックリンクを自動的に作成します。

  5. - AWS SAM CLI がインストールされ、インストールが成功するとメッセージが表示されます。[Close] (閉じる) を押します。

正常にインストールされたことを確認するには
  • を確認します。 AWS SAM CLI は適切にインストールされており、シンボリックリンクは以下を実行して設定されています。

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>
GUI - Current user
をダウンロードしてインストールするには AWS SAM CLI
注記

以前に をインストールしたことがある場合 AWS SAM CLI から Homebrew または pip、最初にアンインストールする必要があります。手順については、AWS SAM CLI のアンインストール を参照してください。

  1. macOS を任意のディレクトリpkgにダウンロードします。

    • Intel プロセッサを実行している Mac の場合は、x86_64 – -x86_64.pkg を選択します。 aws-sam-cli-macos

    • Apple シリコンを実行している Mac の場合は、arm64 – -arm64.pkg を選択します。 aws-sam-cli-macos

    注記

    インストール前にインストーラの整合性を検証するオプションがあります。手順については、オプション: の整合性を検証する AWS SAM CLI installer を参照してください。

  2. ダウンロードしたファイルを実行し、画面の指示に従って、「はじめに」、「Read me」、「ライセンス」の手順を続けてください。

  3. [Destination Select] (インストール先の選択) で、[Install for me only] (現在のユーザーのみにインストール) を選択します。このオプションが表示されない場合は、次の手順に進みます。

  4. [Installation Type] (インストールタイプ) で、以下を実行します。

    1. の場所を選択する AWS SAM CLI がインストールされます。デフォルトの場所は /usr/local/aws-sam-cli です。書き込み権限が付与されている場所を選択してください。インストール場所を変更するには、[local] (ローカル) を選択し、場所を選択します。完了したら、[Continue] (続行) を押します。

    2. 前のステップで [Install for me only] (現在のユーザーのみにインストール) を選択するオプションが表示されない場合は、[Change Install Location] (インストール場所を変更) > [Install for me only] (現在のユーザーのみにインストール) を選択し、[Continue] (続行) を押します。

    3. [Install] (インストール) を押します。

  5. - AWS SAM CLI がインストールし、インストールが正常に完了したことを示すメッセージが表示されます。[Close] (閉じる) を押します。

シンボリックリンクを作成するには
  • を呼び出すには AWS SAM CLI sam コマンドを使用して、 の間にシンボリックリンクを手動で作成する必要があります。 AWS SAM CLI プログラムと $PATH。次のコマンドを変更および実行して、シンボリックリンクを作成します。

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
    • sudo – ユーザーに への書き込みアクセス許可がある場合$PATHsudoは必要ありません。それ以外の場合、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, <latest version>
Command line - All users
をダウンロードしてインストールするには AWS SAM CLI
注記

以前に をインストールしたことがある場合 AWS SAM CLI から Homebrew または pip、最初にアンインストールする必要があります。手順については、AWS SAM CLI のアンインストール を参照してください。

  1. macOS を任意のディレクトリpkgにダウンロードします。

    • Intel プロセッサを実行している Mac の場合は、x86_64 – -x86_64.pkg を選択します。 aws-sam-cli-macos

    • Apple シリコンを実行している Mac の場合は、arm64 – -arm64.pkg を選択します。 aws-sam-cli-macos

    注記

    インストール前にインストーラの整合性を検証するオプションがあります。手順については、オプション: の整合性を検証する AWS SAM CLI installer を参照してください。

  2. インストールスクリプトを変更および実行します。

    $ 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.
    注記

    を呼び出すには AWS SAM CLI sam コマンドを使用すると、インストーラは /usr/local/bin/samと の間にシンボリックリンクを自動的に作成します/usr/local/aws-sam-cli/sam

正常にインストールされたことを確認するには
  • を確認します。 AWS SAM CLI は適切にインストールされており、シンボリックリンクは以下を実行して設定されています。

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>
Command line - Current user
をダウンロードしてインストールするには AWS SAM CLI
注記

以前に をインストールしたことがある場合 AWS SAM CLI から Homebrew または pip、最初にアンインストールする必要があります。手順については、AWS SAM CLI のアンインストール を参照してください。

  1. macOS を任意のディレクトリpkgにダウンロードします。

    • Intel プロセッサを実行している Mac の場合は、x86_64 – -x86_64.pkg を選択します。 aws-sam-cli-macos

    • Apple シリコンを実行している Mac の場合は、arm64 – -arm64.pkg を選択します。 aws-sam-cli-macos

    注記

    インストール前にインストーラの整合性を検証するオプションがあります。手順については、オプション: の整合性を検証する AWS SAM CLI installer を参照してください。

  2. 書き込み権限のあるインストールディレクトリを決定します。次に、テンプレートを使用して xml ファイルを作成し、インストールディレクトリを反映するようにファイルを変更します。ディレクトリは既に存在している必要があります。

    例えば、path-to-my-directory では/Users/myUser/Desktopaws-sam-cliプログラムフォルダがそこにインストールされます。

    <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>choiceAttribute</key> <string>customLocation</string> <key>attributeSetting</key> <string>path-to-my-directory</string> <key>choiceIdentifier</key> <string>default</string> </dict> </array> </plist>
  3. xml ファイルを保存し、以下を実行して有効であることを確認します。

    $ installer -pkg path-to-pkg-installer \ -target CurrentUserHomeDirectory \ -showChoicesAfterApplyingChangesXML path-to-your-xml-file

    出力には、 に適用される設定が表示されます。 AWS SAM CLI プログラム。

  4. 以下を実行して をインストールします。 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.
シンボリックリンクを作成するには
  • を呼び出すには AWS SAM CLI sam コマンドを使用して、 の間にシンボリックリンクを手動で作成する必要があります。 AWS SAM CLI プログラムと $PATH。次のコマンドを変更および実行して、シンボリックリンクを作成します。

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
    • sudo – ユーザーに への書き込みアクセス許可がある場合$PATHsudoは必要ありません。それ以外の場合、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, <latest version>

Windows Installer (MSI) ファイルは、Windows オペレーティングシステムのパッケージインストーラファイルです。

をインストールするには、次の手順に従います。 AWS SAM CLI MSI ファイルを使用する。

  1. のダウンロード AWS SAM CLI 64 ビット

  2. (オプション) インストール前にインストーラーの整合性を確認できます。手順については、オプション: の整合性を検証する AWS SAM CLI installer を参照してください。

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

    インストールが完了したら、新しいコマンドプロンプトまたは PowerShell プロンプトを開いて確認します。コマンドラインから sam を呼び出すことができるはずです。

    sam --version

    が正常にインストールされた後 AWS SAM CLI、次のような出力が表示されます。

    SAM CLI, <latest version>
  4. ロングパスを有効にします (Windows 10 以降のみ)。

    重要

    - AWS SAM CLI は、Windows の最大パス制限を超えるファイルパスとやり取りする場合があります。これにより、Windows 10 MAX_PATHの制限sam initにより、実行時にエラーが発生する可能性があります。この問題を解決するには、新しい長いパスの動作を設定する必要があります。

    長いパスを有効にするには、「Windows アプリの開発に関するドキュメント」の「Windows 10、バージョン 1607 以降で長いパスを有効にする」を参照してください。

  5. Git をインストールする。

    sam init コマンドを使用してサンプルアプリケーションをダウンロードするには、Git をインストールする必要があります。手順については、「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 (/usr/local/aws-sam-cli/dist/libz.so.1 で必要)"

このエラーが表示された場合は、サポートされていないバージョンの Linux を使用しており、組み込みの glibc バージョンが古くなっています。以下のいずれかを実行してみてください。

  • Linux ホストを CentOS、Fedora、Ubuntu、または Amazon Linux 2 の最新ディストリビューションの 64 ビット版にアップグレードする。

  •   のインストール AWS SAM CLI」の手順を実行する。

macOS

インストールが失敗しました

のイメージ AWS SAM CLI インストール失敗メッセージを表示する インストーラ

をインストールする場合 AWS SAM CLI ユーザーの で、書き込みアクセス許可がないインストールディレクトリを選択した場合、このエラーが発生する可能性があります。以下のいずれかを実行してみてください。

  1. 書き込み権限のある別のインストールディレクトリを選択してください。

  2. インストーラを削除します。次に、再度インストーラをダウンロードして実行します。

次のステップ

の詳細については、「」を参照してください。 AWS SAM CLI および を使用して、独自のサーバーレスアプリケーションの構築を開始するには、以下を参照してください。