📝
CloudFormation で構築した CloudFront の代替ドメイン名を移行してみた
CloudFrontのCNAMEをディストリビューション間でダウンタイム無しにアトミックに移行できるようになりました | DevelopersIO
CloudFormation で構築した CloudFront でやってみました。
前提
- バージニア北部リージョンの ACM で証明書を発行済み
手順概要
- 移行元の CloudFront ディストリビューションを作成
- 移行先の CloudFront ディストリビューションを作成
- Route 53 で DNS TXT レコードの作成
- AssociateAlias API の実行
1. 移行元の CloudFront ディストリビューションを作成
以下の CloudFormation テンプレートで移行元の CloudFront ディストリビューションを作成します。
- パラメータにはバージニア北部リージョンの ACM 証明書の ARN を指定
- Aliases にはドメインを指定
AWSTemplateFormatVersion: "2010-09-09"
Description: "First CloudFront Distribution for domain switching test"
Parameters:
CertificateArn:
Type: String
Description: SSL Certificate ARN from ACM (us-east-1)
Default: your-certificate
Resources:
FirstCloudFrontDistribution:
Type: AWS::CloudFront::Distribution
Properties:
DistributionConfig:
Aliases:
- test1.your-domain.com
DefaultCacheBehavior:
TargetOriginId: dummy-origin
ViewerProtocolPolicy: redirect-to-https
CachePolicyId: 4135ea2d-6df8-44a3-9df3-4b5a84be39ad
- Id: dummy-origin
DomainName: example.com
CustomOriginConfig:
HTTPPort: 80
HTTPSPort: 443
OriginProtocolPolicy: https-only
Enabled: true
Comment: "First CloudFront Distribution"
ViewerCertificate:
AcmCertificateArn: !Ref CertificateArn
SslSupportMethod: sni-only
MinimumProtocolVersion: TLSv1.2_2021
2. 移行先の CloudFront ディストリビューションを作成
以下の CloudFormation テンプレートで移行先の CloudFront ディストリビューションを作成します。
- パラメータにはバージニア北部リージョンの ACM 証明書の ARN を指定
AWSTemplateFormatVersion: "2010-09-09"
Description: "Second CloudFront Distribution for domain switching test (without alias)"
Parameters:
CertificateArn:
Type: String
Description: SSL Certificate ARN from ACM (us-east-1)
Default: your-certificate
Resources:
SecondCloudFrontDistribution:
Type: AWS::CloudFront::Distribution
Properties:
DistributionConfig:
DefaultCacheBehavior:
TargetOriginId: dummy-origin-2
ViewerProtocolPolicy: redirect-to-https
CachePolicyId: 4135ea2d-6df8-44a3-9df3-4b5a84be39ad
Origins:
- Id: dummy-origin-2
DomainName: httpbin.org
CustomOriginConfig:
HTTPPort: 80
HTTPSPort: 443
OriginProtocolPolicy: https-only
Enabled: true
Comment: "Second CloudFront Distribution (for AssociateAlias API test)"
ViewerCertificate:
AcmCertificateArn: !Ref CertificateArn
SslSupportMethod: sni-only
MinimumProtocolVersion: TLSv1.2_2021
3. Route 53 で DNS TXT レコードの作成
Route 53 で以下のように DNS TXT レコードを作成します。
- レコード名: _test1.your-domain.com
- レコードタイプ: TXT
- 値: 移行先の CloudFront ディストリビューションのデフォルトのドメイン名
4. AssociateAlias API の実行
今回は AWS CLI で実行します。
$ aws cloudfront associate-alias \
--target-distribution-id <移行先のディストリビューション ID> \
--alias test1.your-domain.com
上記コマンド成功後、移行先のディストリビューションに代替ドメイン名が移行されていれば OK です。

Route 53 のエイリアスについて
AssociateAlias API を実行後に CloudFront コンソールでは代替ドメイン名が移行されており、アクセス先についても移行先のページに変更されていました。
ただし、Route 53 コンソールで移行元に設定していたエイリアスについては変更されていませんでした。
この点についての仕様が記載された資料を特定することはできませんでした。
まとめ
今回は CloudFormation で構築した CloudFront の代替ドメイン名を移行してみました。
どなたかの参考になれば幸いです。
Discussion