📝

CloudFormation で構築した CloudFront の代替ドメイン名を移行してみた

に公開

CloudFrontのCNAMEをディストリビューション間でダウンタイム無しにアトミックに移行できるようになりました | DevelopersIO

CloudFormation で構築した CloudFront でやってみました。

前提

  • バージニア北部リージョンの ACM で証明書を発行済み

手順概要

  1. 移行元の CloudFront ディストリビューションを作成
  2. 移行先の CloudFront ディストリビューションを作成
  3. Route 53 で DNS TXT レコードの作成
  4. 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