Skip to content

hubs cloud aws troubleshooting

Akihiko Shirai edited this page May 5, 2021 · 3 revisions

id: hubs-cloud-aws-troubleshooting title: AWSのトラブルシューティング sidebar_label: AWSトラブルシューティング

「AWS Sandbox」に入っていて、「magic link」メールが届かない

デプロイが完了後、Hubs Admin コンソールにアクセスできます。 Hubs Admin コンソールは、「AWS Sandbox」にも入っていると表示されます。 スタックAWSのメールサービスは制限されています。

解決方法:

  1. 管理者の個別のメールアドレスを確認する

    • あなたのサイトを使用している管理人が数名のみの場合は、SESで自分のメールアドレスを確認することができます。
    • AWSコンソールのSimple Email Serviceに移動し、「Email Addresses」でサイトを使用するメールアドレスを追加します。
    • 各ユーザーは、クリックする必要がある確認メールを受け取ります。
    • メールアドレスが確認されると、「magic link」のメールが届きます。
  2. 上限の引き上げを求めるリクエストをAWSに送信する

    • AWSのテクニカルサポートがメールサービスの上限引き上げを承認するまでの24時間を待てる場合は、このプロセスを利用してください。
    • AWS create case に移動します
    • 「サービス制限の緩和」を選択します
      • 制限タイプ: "SES 送信制限"
      • Mail Type: "System Notifications"
      • Website URL - optional
      • Describe ... who have requested your mail: "We authenticate users using email links only. "We authenticate users using email links only. Users who want to join and connect to the hosted Mozilla Hubs Room, will enter their email address to get this 'magic hub' link to authenticate. Anyone can choose to not enter their email and not join." Anyone can choose to not enter their email and not join."
      • Describe ... and complaint notifications: "We've set up bounce and complaints to forward to an administrative email address. And we do not send any emails other than this 'magic' authentication email link to join a Hubs room. We don't store emails on our server."
      • Will you comply with AWS Service Terms?: "Yes"
    • Request 1
      • リージョン: Select 米国東部 (バージニア北部)
    • ケースの説明: メッセージ フィールドの以下の質問に回答します。
      • Hubs Cloudインスタンスは何をしますか? こちらにあなたのユースケースに関連するものを記載します。
      • 次の説明文を記載。 As such, would like to use SES to send these emails. There are no other emails sent by the product other than these automated sign-in emails, sent at the time a user requests to log in. We do not send any unsolicited emails or other content-oriented emails, only sign in link emails. We do not store the email addresses of visitors. The emails are securely transmitted to our server at log-in time to send the email link."
    • フォームを送信
    • Eメールが到着次第、サービス上限のリクエストを許可されます。
  3. SMTPをSendGridでセットアップ

    • 即時修正が必要な場合は、このプロセスを使用してください
    • SendGrid にサインアップ
    • 新しいAPIキーを作成
    • APIキーのメール送信機能を付与する
    • Hubs Cloud Admin コンソールで設定を更新する
      1. Server settings > SMTP
      2. "apikey"を"Username"として入力してください
      3. APIキー自体を「Password」として入力してください
      4. "Host"として"smtp.sendgrid.net"を入力
      5. 「ポート」として「2525」と入力してください

AWSスタックはデプロイ後「rollback complete」と言っていますが、何がうまくいかなかったのですか?

Hubs Cloudスタックのデプロイ中に問題が発生しました。 デフォルトでは、AWSは変更をロールバックし、スタックを削除します。

最後のエラーイベントを表示するには

  1. AWS EC2 に移動 > 左サイドバーの「Events」タブを選択
  2. リストを下にスクロールして、「Status」列の赤いエラーまでスクロールします。
  3. 後のトラブルシューティングのためにエラーを記録します

ロールバックを完全に無効にする

  1. AWS Hubs deployment processを開始する > ステップ1と2を終了する > 「ステップ3 Configure stack options」 > 「Advanced options」 > 「Stack creation options」を展開する > 「Rollback on failure」で「Disabled」を選択する
  2. スタックの作成を続行し、スタックが失敗したエラーを発見します。
  3. AWS CloudFormationのスタックを手動で削除してデプロイプロセスを再起動します

The specified key does not exist. (Service: Amazon S3; Status Code: 404; Error Code: NoSuchKey

これは現在Amazon が対応してるAWS Cloudshipingのバグです。 残念ながら、スタックの削除と再作成が必要です。

"ExternalZoneSSLCertLocalIfEast" error or timeout

SSL 証明書の認証に問題があります。

次の手順で解決する可能性があります。

  1. ドメインを確認
    • あなたのドメイン名は正しく入力されていますか?
    • AWS Route 53でドメインを登録したことを確認してください
  2. 証明書の制限に達しました。AWSに上限の増加を依頼する必要があります。
    • このスタックは複数回デプロイしましたか? AWSのデフォルト設定では月額25証明書のみ作成可能の制限に引っかかった可能性があります。 証明書の増加を要求するAWSヘルプデスクのチケットを作成します。 数日後、Hubs Cloudへ再度デプロイできるようになります。
  3. DNS CNAMEの問題。
    • Hubsクラウドスタックを再度デプロイする前に、AWS Route 53に移動してください
    • Hubs Cloudで使用しているドメインを選択します
    • 最後にデプロイしたHubsスタック展開から左からCNAMEを削除する -- ドメインが別のサービスに使用しているCNAMEを削除しないように注意してください
    • Hubs Cloudスタックを再度デプロイする
  4. ネームサーバーはデフォルトのAWSのものですか?
    • ネームサーバーに別のサービスを指すように変更した可能性があります。 現在のものを削除してデフォルトに戻します。

Hubs Cloudのデプロイ成功後、私のサーバーはオフラインまたは「NoSuchKey」エラーです。

スタック作成時に「オフラインモード」を選択しましたか? その場合、正しくデプロイされており、サーバーが実行されていません!

「オンライン」にするためにはスタックガイドの更新 に従って実行します。 再度「オフライン」にしたい場合は、同じプロセスに従って「オフライン」を選択します。

サーバーがオフラインのときにトラフィックをリダイレクトするURLを指定して、このエラーページを避けることもできます。

私たちのユーザーが「Unable to connect to this room, please try again later.」と表示されます。

このエラーは Hubs Cloud バージョン 1.1.0 で修正され、TURN サーバが追加されました。 1.0.0 から 1.1.1.0 にアップグレードする必要があります。 新しいスタックリリースへのアップグレード で解説されているプロセスに従ってください。

そして、 バージョン1.1.0を使用しているかどうかを確認してください

どうすればバージョン1.1.0になっている事を確認できますか?

こちらに記載しているステップを確認してください。バージョン1.1.0を使用しているかどうかを確認

解決策が見つかりませんか?

他のドキュメントで必要なものが見つからない場合は、連絡を取る方法については ヘルプページ を参照してください。

まずはじめに

ユーザーガイド

Spoke 関連

クリエイター向け

開発者向け

Hubs Cloud

Hubs Cloud AWS

Hubs Cloud DigitalOcean

日本語追加ドキュメント

Clone this wiki locally