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

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

Linux への AWS SAM CLI のインストール

-AWS SAMコマンドラインインターフェイス (CLI) は、CentOS、Fedora、Ubuntu、Amazon Linux 2 の最近のディストリビューションの 64 ビット版でサポートされています。をインストールするにはAWS SAMCLI では、ダウンロードしたパッケージを抽出または「解凍」する必要があります。オペレーティングシステムに組み込み unzip コマンドがない場合は、同等のコマンドを使用します。

使用するための前提条件をインストールして構成するにはAWS SAMLinux ホスト上の CLI を使用するには、以下のステップに従います。

  1. AWS アカウントを作成します。

  2. 設定AWS Identity and Access Management(IAM) アクセス許可とAWS認証情報。

  3. Docker をインストールします。注意: Docker は、アプリケーションをローカルでテストするか、アプリケーションをローカルでテストするための前提条件です。--use-containerオプション。

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

ステップ 1: AWS アカウントを作成する

まだ持っていない場合は、AWSアカウントの詳細については、aws.amazon.comを選択し、を作成するAWSアカウント。詳細な手順については、「」を参照してください。どのようにして新しい [] を作成し、アクティベートする方法を教えてください。AWSアカウント?

ステップ 2: IAM アクセス許可を設定すると IAM アクセス許可を設定するAWS認証情報

で使用する IAM ユーザーAWS SAM必要になるための十分な権限を持っている必要がありますAWSサービスコールと管理AWSリソースの使用料金を見積もることができます。ユーザーに十分な権限を付与する最も簡単な方法は、ユーザーに管理者権限を付与することです。詳細については、IAM ユーザーガイド「最初の IAM 管理者のユーザーおよびグループの作成」を参照してください。

注記

使用するユーザーに管理者権限を付与しない場合は、AWS Command Line Interface(AWS CLI) を使用すると、制限された一連のアクセス許可をそれらのアクセス許可に付与できます。詳細については、「Permissions」を参照してください。

さらに、AWS SAM作成する CLIAWSサービス呼び出しを行うには、セットアップする必要があります。AWS認証情報。詳細については、「のセットアップAWS認証情報」を参照してください。

ステップ 3: Docker のインストール(オプション)

注記

Docker は、アプリケーションをローカルでテストし、--use-containerオプション。これらの機能を最初に使用する予定がない場合は、このセクションをスキップするか、後で Docker をインストールできます。

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

サーバーレスプロジェクトと関数をローカルで実行するにはAWS SAMCLIを使用するには、Dockerをインストールして動作している必要があります。AWS SAM CLI は、DOCKER_HOST 環境変数を使用して Docker デーモンにアクセスします。次の手順では、AWS SAM CLI で動作するように Docker のインストールをインストール、設定、および検証する方法について説明します。

Docker は、CentOS、Debian、Ubuntu のような最新の Linux ディストリビューションを含む、さまざまなオペレーティングシステムで使用できます。Docker を特定のオペレーティングシステムにインストールする方法については、Docker を取得します。Docker Docs ウェブサイトにあります。

Amazon Linux 2 を使用している場合は、以下のステップに従って Docker をインストールします。

  1. インスタンスでインストールされているパッケージとパッケージキャッシュを更新します。

    sudo yum update -y
  2. 最新の Docker Community Edition パッケージをインストールします。

    sudo amazon-linux-extras install docker
  3. Docker サービスを開始します。

    sudo service docker start
  4. を追加します。ec2-userdockerグループを使用して、Docker コマンドを実行することができます。sudo

    sudo usermod -a -G docker ec2-user
  5. 新しいdockerグループ権限は、ログアウトして再度ログインします。これを行うには、現在の SSH ターミナルウィンドウを閉じて、インスタンスを新しいセッションに再接続します。新しい SSH セッションには、適切なdockerグループのアクセス許可を持ちます。

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

    docker ps

    Docker がインストールされ、実行されていることを確認する次の出力が表示されます。

     CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES

Docker のインストールで問題が発生した場合は、「Docker のインストールで問題が発生した場合は、Troubleshootingこのセクションの後の方にある「」セクションを参照してください。または、トラブルシューティングセクションに追加します。Linux のインストール後のステップ(Linux 用)Docker Docs ウェブサイトにあります。

ステップ 4: のインストールAWS SAMCLI

をインストールするにはAWS SAMCLI では、次のステップに従います。

  1. のダウンロードAWS SAMCLI Zip ファイル任意のディレクトリに移動します。

  2. 次のコマンドを使用してハッシュ値を生成し、ダウンロードしたインストーラファイルの整合性と信頼性を検証します。

    sha256sum aws-sam-cli-linux-x86_64.zip

    出力は次の例のようになります。

     <64-character SHA256 hash value> aws-sam-cli-linux-x86_64.zip

    64 文字の SHA256 ハッシュ値を、目的の SHA256 ハッシュ値と比較します。AWS SAMの CLI バージョン(CLI バージョン)AWS SAMCLI リリースノート(CLIGitHub で。

  3. インストールファイルをsam-installation/サブディレクトリ。

    unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
  4. AWS SAM CLI のインストール

    sudo ./sam-installation/install
  5. インストールを検証します。

    sam --version

    正常に実行された場合、次のような出力が表示されます。

     SAM CLI, version 1.18.0

これで開発を開始する準備が整いました。

Upgrading

をアップグレードするにはAWS SAMCLI では、「」の手順を実行します。のインストールAWS SAMCLIセクションに追加しますが、--updateオプションを install コマンドに追加します。

sudo ./sam-installation/install --update

Uninstalling

をアンインストールするにはAWS SAMCLI を使用するには、次のコマンドを実行して、シンボリックリンクとインストールディレクトリを削除する必要があります。

  1. シンボリックリンクとインストールパスを見つけます。

    • シンボリックリンクを検索するには、whichコマンド:

      which sam

      出力は、パスを示しています。AWS SAMバイナリが配置されています。たとえば、次のようになります。

       /usr/local/bin/sam
    • シンボリックリンクが指すディレクトリを見つけます。lsコマンド:

      ls -l /usr/local/bin/sam

      次の例では、インストールディレクトリは/usr/local/aws-sam-cli

       lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam
  2. シンボリックリンクを削除します。

    sudo rm /usr/local/bin/sam
  3. インストールディレクトリを削除します。

    sudo rm -rf /usr/local/aws-sam-cli

夜間build

夜間のビルドAWS SAMCLI は、インストールできます。インストールしたら、夜間のビルドを使用して使用することができます。sam-nightlyコマンド。インストールし、両方の本番ビルドバージョンと夜間ビルドバージョンの両方を使用することができますAWS SAMCLI を同時にできます。

夜間ビルドには、プレリリース版のAWS SAM本番バージョンよりも安定性が低いCLIコード。nightly ビルドにはビルドイメージのプレリリースバージョンが含まれていないため、--use-containerオプションは、ビルドイメージの最新の実動バージョンを使用します。

夜間のビルドは、このダウンロードリンクで利用できます:AWS SAMCLI 夜間ビルド。夜間のビルドバージョンをインストールするにはAWS SAMCLI では、「」の手順を実行します。ステップ 4: のインストールAWS SAMCLIセクションで説明しますが、代わりに夜間ビルドのダウンロードリンクを使用してください。夜間ビルドインストーラーファイルのハッシュ値は、AWS SAM夜間ビルドのCLIリリースノートGitHub で。

夜間ビルドバージョンがインストールされていることを確認するには、sam-nightly --versionコマンド。このコマンドの出力は、形式は次のとおりです。1.X.Y.dev<YYYYMMDDHHmm>例:

SAM CLI, version 1.20.0.dev202103151200

Troubleshooting

Docker エラー: 「Docker デーモンに接続できません。このホスト上で Docker デーモンは実行されていますか。」

場合によっては、ec2-userを使用してDockerデーモンにアクセスするには、インスタンスを再起動する必要があります。このエラーが表示された場合は、インスタンスを再起動してみてください。

シェルエラー:「コマンドが見つかりません」

このエラーが表示された場合、シェルは、AWS SAMパスで CLI 実行可能ファイルを指定します。をインストールしたディレクトリの場所を確認します。AWS SAMCLI 実行可能ファイルを参照し、ディレクトリがパス上にあることを確認します。

AWS SAMCLIエラー:「/lib64/libc.so.6: バージョン `GLIBC_2.14' が見つかりません (/usr/local/aws-sam-cli/dist/libz.so.1 で必須)」

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

次のステップ

これで、独自のサーバーレスアプリケーションの構築を開始する準備が整いました。AWS SAM。サンプルサーバーレスアプリケーションから開始するには、次のいずれかのリンクを選択します。