aws/routing-traffic-with-route53-and-cloudfront

routing-traffic-with-route53-and-cloudfront は何をしますか？

Amazon Route 53 を構成して、カスタムドメインを使用した CloudFront ディストリビューションへのトラフィックルーティングを実現します。DNS エイリアスレコード、代替ドメイン名 (CNAME)、HTTPS 用の ACM 証明書、CloudFront の IPv6 サポートを設定する際に使用します。

概要

このスキルは、以下のタスクを自動化します:

• Route 53 ホストゾーンに A および AAAA エイリアスレコードを作成し、CloudFront ディストリビューションを指すようにします。
• カスタムドメイン名 (例: www.example.com) を CloudFront ディストリビューションの代替ドメイン名 (CNAME) として設定します。
• AWS Certificate Manager (ACM) で SSL/TLS 証明書をリクエストし、CloudFront で HTTPS を有効にします。
• CloudFront ディストリビューションで IPv6 を有効にします (該当する場合)。

前提条件

• 有効な AWS アカウントと適切な IAM 権限 (Route 53、CloudFront、ACM へのフルアクセス)。
• Route 53 で管理されるパブリックホストゾーン (例: example.com) が既に存在していること。
• CloudFront ディストリビューションが既に作成されていること (このスキルは配信設定の更新を行います)。
• aws CLI がインストールされ、設定済みであること。

使用方法

入力パラメータ

パラメータ	型	必須	説明
domain_name	string	はい	使用するカスタムドメイン名 (例: www.example.com)。
hosted_zone_id	string	はい	Route 53 ホストゾーンの ID。
cloudfront_distribution_id	string	はい	CloudFront ディストリビューションの ID。
acm_certificate_arn	string	いいえ	既存の ACM 証明書の ARN。指定しない場合、新しい証明書がリクエストされます。
ipv6_enabled	boolean	いいえ	CloudFront で IPv6 を有効にするかどうか。デフォルトは true。

出力

• Route 53 エイリアスレコードの作成/更新の確認。
• CloudFront ディストリビューションの更新ステータス。
• ACM 証明書の検証ステータス (該当する場合)。

スキルの仕組み

1. ドメイン検証: 指定された domain_name が有効な形式であることを確認します。
2. ACM 証明書のプロビジョニング (必要な場合): acm_certificate_arn が指定されていない場合、us-east-1 リージョンで新しい ACM 証明書をリクエストし、DNS 検証を行います。Route 53 に CNAME レコードを自動的に追加して検証を完了します。
3. CloudFront ディストリビューションの更新: ディストリビューションの構成に代替ドメイン名と ACM 証明書 ARN を追加し、必要に応じて IsIPV6Enabled を設定します。
4. Route 53 エイリアスレコードの作成: 指定されたホストゾーンに A (IPv4) および AAAA (IPv6) エイリアスレコードを作成し、CloudFront ディストリビューションの DNS 名を指すようにします。
5. 最終確認: すべての変更が適用され、DNS 解決が期待通りに動作することを確認します。

例

# 既存の証明書を使用する場合
aws route53 change-resource-record-sets \
    --hosted-zone-id Z3M3LMPEXAMPLE \
    --change-batch '{
        "Changes": [
            {
                "Action": "UPSERT",
                "ResourceRecordSet": {
                    "Name": "www.example.com",
                    "Type": "A",
                    "AliasTarget": {
                        "HostedZoneId": "Z2FDTNDATAQYW2",
                        "DNSName": "d111111abcdef8.cloudfront.net",
                        "EvaluateTargetHealth": false
                    }
                }
            }
        ]
    }'

注意: 上記のコマンドは、エイリアスレコードの作成のみを示しています。完全なスキルフローには、ACM 証明書のプロビジョニングと CloudFront 構成の更新が含まれます。

トラブルシューティング

• DNS 伝搬の遅延: DNS レコードの変更が反映されるまでに数分かかる場合があります。dig www.example.com を使用して確認してください。
• 証明書の検証エラー: ACM 証明書の検証に失敗した場合、Route 53 に適切な CNAME レコードが存在することを確認してください。
• CloudFront の配信ステータス: CloudFront ディストリビューションの更新中は、ステータスが InProgress になります。完全にデプロイされるまでお待ちください。

関連リソース

• AWS Route 53 ドキュメント
• AWS CloudFront ドキュメント
• AWS Certificate Manager ドキュメント