Amplify CLIのセットアップ

開始する前に、以下のものがインストールされていることを確認してください:

Node.js v14.x以降
npm v6.14.4以降
git v2.14.1以降

AWSアカウントのサインアップ

まだAWSアカウントを持っていない場合は、このチュートリアルで説明されている手順を実行するために、アカウントを作成する必要があります。

AWSアカウントの作成に初期費用や期間の約束はなく、サインアップするとAWS無料利用枠に直ちにアクセスできます。

Amplify CLIをインストール

Amplify Command Line Interface (CLI)は、アプリ用のAWSクラウドサービスを作成するための統一されたツールチェーンです。Amplify CLIをインストールしましょう。

npm install -g @aws-amplify/cli

curl -sL https://aws-amplify.github.io/amplify-cli/install | bash && $SHELL

curl -sL https://aws-amplify.github.io/amplify-cli/install-win -o install.cmd && install.cmd

npmでパッケージをグローバルにインストールする際のEACCES権限問題を解決

Amplify CLIを構成

ローカルマシンでAmplify CLIをセットアップするには、AWSアカウントに接続するように構成する必要があります。

注意: マシンにAWS認証情報を持つAWSプロフィールがすでにある場合は、このステップをスキップできます。

以下のコマンドを実行してAmplifyを構成します:

amplify configure

configureコマンドは永続的な認証情報を使用するAWSプロフィールの作成のみをサポートしています。IAMロールまたはIAM Identity Center (以前のAWS SSO)を使用している場合は、Amplify CLIを手動で構成する方法を学習してください。

amplify configureはAWSコンソールへのサインインを求めます。

サインイン後、Amplify CLIはAWS Identity and Access Management (IAM)を使用してIAMユーザーを作成するよう求めます。

Specify the AWS Region
? region:  # Your preferred region
Follow the instructions at
https://docs.amplify.aws/cli/start/install/#configure-the-amplify-cli
to complete the user creation in the AWS console
https://console.aws.amazon.com/iamv2/home#/users/create

IAMユーザー作成ページに移動します(まだ開いていない場合)。

ユーザー名を入力して次へを選択します。ユーザーには任意の名前を付けることができますが、ここでは「amplify-dev」と名前を付けます。

IAMユーザー作成の最初のステップ。ユーザーの詳細を指定。

ポリシーを直接アタッチを選択し、権限ポリシーとしてAdministratorAccess-Amplifyを選択します。次へを選択します。

IAMユーザー作成の2番目のステップ。権限を設定。

レビューページで、すべてが適切に見えることを確認してユーザーを作成を選択します。

IAMユーザー作成の3番目で最終のステップ。レビューと作成。

これはユーザーリストページにリダイレクトします。先ほど作成したユーザーを選択します。

ユーザーテーブルに表示されている新しいユーザー。

ユーザー詳細ページで、セキュリティ認証情報タブに移動し、アクセスキーまでスクロールダウンしてアクセスキーを作成を選択します。

新しく作成されたユーザーのセキュリティ認証情報タブ。

次のページで、コマンドラインインターフェースを選択し、警告を承認して、次へを選択します。

オプションリストで[コマンドラインインターフェース]オプションが選択されています。

次のページでアクセスキーを作成を選択します。その後、ユーザーのアクセスキーが表示されたページが表示されます。コピーアイコンを使用してこれらの値をクリップボードにコピーしてから、Amplify CLIに戻ります。

アクセスキーと秘密アクセスキーのコピーボタンが丸で囲まれたアクセスキー取得ページ。

コピーした値を対応するCLIプロンプトに入力します。

Enter the access key of the newly created user:
? accessKeyId:  # YOUR_ACCESS_KEY_ID
? secretAccessKey:  # YOUR_SECRET_ACCESS_KEY
This would update/create the AWS Profile in your local machine
? Profile Name:  # (default)
Successfully set up the new user.

次のページで、アプリをセットアップしてAmplifyを初期化します。

Amplify CLIを手動で構成

IAMロールまたはIAM Identity Center (以前のAWS SSO)を使用している場合は、amplify configureウィザードではなく、AWSプロフィールエントリを手動で作成することで、Amplify CLI用にローカルマシンを構成できます。

IAM Identity Centerを使用してローカルにAWSプロフィールを作成するには、AWS CLIウィザードaws configure ssoを使用するか、~/.aws/configに直接書き込むことができます:

AWS CLIをインストールする方法を学習

~/.aws/config
[profile my-sso-profile]
sso_session = my-sso
sso_account_id = 123456789011
sso_role_name = AdministratorAccess-Amplify
region = us-west-2
output = json
[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_registration_scopes = sso:account:access

現在、Amplify CLIはIAM Identity Centerとの使用に認証情報の解決方法に関する問題のため、回避策が必要です。

~/.aws/config
[profile my-sso-profile]
sso_session = my-sso
sso_account_id = 123456789011
sso_role_name = AdministratorAccess-Amplify
region = us-west-2
output = json
+ credential_process = aws configure export-credentials --profile my-sso-profile
[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_registration_scopes = sso:account:access

上記の例を使用する場合、新しいアプリを作成するか既存のアプリをプルするときに、Amplifyアプリで使用するAWSプロフィールとしてmy-sso-profileを指定します。

IAMロールを使用してローカルにAWSプロフィールを作成するには、ロールにAdministratorAccess-Amplify権限セットを割り当て、~/.aws/configファイルでロールを設定します:

~/.aws/config
[profile amplify-admin]
role_arn = arn:aws:iam::123456789012:role/amplify-admin
source_profile = amplify-user
[profile amplify-user]
region=us-east-1

上記の例を使用する場合、新しいアプリを作成するか既存のアプリをプルするときに、Amplifyアプリで使用するAWSプロフィールとしてamplify-adminを指定します。

概要

フルスタックプロジェクトのセットアップ