独自の AWS Amplify アカウントに静的サイトをデプロイする

接続によって得られるメリット

ご自身のAWS Amplifyアカウントを接続することで、Zinn®ダッシュボードからお客様のAWS Amplifyアカウントへ静的サイトを公開できるようになります。プロジェクトと請求はお客様のご負担となり、デプロイ、カスタムドメイン、DNSレコードの管理は弊社が担当します。

始める前に

AWSアカウントが必要です。AWS Amplifyはお客様ご自身のアカウントでのみご利用いただけます。Amplifyは配信データ量とビルド時間に対して課金され、常時無料枠がないため、弊社のアカウントでサイトを運用すると誰も上限を管理できない請求が発生してしまいます。お客様ご自身のアカウントであれば、費用も制限も、AWSコンソールもすべてお客様の管理下となります。

管理対象のアプリケーションに対するAmplifyのアクション（amplify:*）を許可するポリシーを設定し、この接続用のIAMユーザーを作成してください。

1. AWS Amplifyでキーを作成する

AWSコンソールでIAM → ユーザーを開き、この接続で使用するユーザーを選択します（専用のユーザーを作成してください。ルートアカウントは絶対に使用しないでください）。セキュリティ認証情報タブを開き、アクセスキーからアクセスキーの作成を選択します。ユースケースとしてその他を選択して次へ進み、アクセスキーの作成を選択します。アクセスキーIDとシークレットアクセスキーをコピーします。シークレットが表示されるのはこの一度だけです。各IAMユーザーは同時に2つのキーを保持できます。

2. ここで接続する

ダッシュボードで連携を開き、アカウントの接続を選択します。グループとして静的ホスティング（Netlify、Vercel）を、アカウントとしてAWS Amplifyを選択し、アクセスキーIDとシークレットアクセスキーを入力して、アカウントを接続を押します。

保存する前に、入力された内容のテストを行います。機能しないキーが保存されることはなく、エラーの原因が表示されます。正常に機能するキーは、データベースではなくシークレット・バルトに暗号化されて保管され、二度と表示されません（お客様ご自身にも表示されません）。

その後の動作

• 静的サイトの作成または移動を行う際、このアカウントがデプロイ先として表示されます。これを選択すると、サイトのビルドがお客様のアカウント上のプロジェクトに公開されます。
• カスタムドメインが自動的にアタッチされ、ドメインのページには、新しいホストでドメインの名前解決を行うためにベンダーが必要とするDNSレコードが表示されます。
• プロジェクト、その利用状況、および請求はお客様のアカウントに紐づきます。すべてのデプロイは、ご自身のベンダーダッシュボードで確認できます。

接続できない場合

AWSによって認証情報が拒否されました。 IAMでアクセスキーが有効な状態を維持していること、およびユーザーのポリシーがアプリに対するAmplifyのアクションを許可していることを確認してください。無効化されたアクセスキーは、間違ったキーとまったく同じエラーを返します。

シークレットが失われました。 AWSでは、一度作成したシークレットアクセスキーを再表示することはできません。新しいアクセスキーを作成して接続し、その後IAMで古いキーを削除してください。

キーが拒否されたというメッセージが表示されます。 ほとんどの場合、次の3つのいずれかが原因です：コピー時にスペースや改行が混入した、キーの有効期限が切れている、あるいはコピー後にキーが無効化または再生成された。新しいキーを作成し、再度貼り付けてください。

接続は成功したが、後続の処理で失敗する。 キーの認証は成功したものの、処理に必要な権限が不足しています。上記に挙げた権限を持つ新しいキーを作成してから、古い接続を解除し、新しいキーで接続し直してください。

接続の解除

連携を開き、該当するアカウントを見つけて接続を解除を押します。これにより、保存されているキーが即座に削除されます。このキーを使用していた機能は次のアクション実行時に停止し、依存していた画面は、静かに失敗するのではなくその旨を表示します。

接続を解除しても、すでに実行された操作（弊社がお客様のアカウントで変更したレコード、デプロイ、設定など）は元に戻りません。キー自体が漏洩した可能性があると思われる場合は、ベンダー側でもキーを無効化してください。接続を解除することで削除されるのは弊社のコピーであり、ベンダー側のコピーではありません。