背景
この間、運営している２つのメディアサイトを統合させたくて、AWSのCloudFrontで配信している古いサイトから外部のサイトに移行する必要があった。
-
old.example.comはCloudFrontを使ってS3に入っているコンテンツを配信しているサイト -
new.example.comはAWS外でホスティングしているサイト
古いサイトのページはアクセス数が少ないため、内容は移行せずold.example.com/*に来たアクセスを一律new.example.com/homeにリダイレクトするのが今回の要件。
なお、AWSのリソースや設定はTerraformで管理している。
やったことその① HostNameとReplaceKeyWithでURLを完全に書き換える
まずはリダイレクトの基本設定として、RoutingRulesにRedirectRuleを追加する。
ReplaceKeyWithを使ってすべてのリクエストを同じURLにリダイレクトする。そして、今回リダイレクトしたいURLはドメインも違うのでHostNameでリダイレクト先のドメインになる。（外部のドメインになるということは特に意識する必要はない。）
website {
routing_rules = jsonencode([
{
Redirect = {
HostName = "new.example.com"
HttpRedirectCode = "301"
Protocol = "https"
ReplaceKeyWith = "home"
}
}
])
}
こうするとドメインもそれ以降のURL（CloudFormationでS3オブジェクトのキーとして使われていた部分）も置き換えられる。
やったことその② IndexDocumentを追加する
すべてのリクエストをリダイレクトしているからIndexDocumentはいらないと思っていたけど、 terraform applyをしたら以下のエラーが発生した。
Error: Must specify either index_document or redirect_all_requests_to.
どうやらTerraformの使用上、redirect_all_requests_toを使っていない限り、IndexDocumentの設定が必須。
website {
index_document = "home"
routing_rules = jsonencode([
{
Redirect = {
HostName = "new.example.com"
HttpRedirectCode = "301"
Protocol = "https"
ReplaceKeyWith = "home"
}
}
])
}
ページを含めて移行していたら、redirect_all_requests_toですべてのリクエストのドメインだけを変えてリダイレクトを設定できるけど、どのリクエストでも固定したページにリダイレクトしたいのでIndexDocumentとして現在の「Default Root Object」のキーを設定することにした。
やったことその③ CloudFrontのOriginを変更する
上記のリダイレクト設定は正しいが、そもそもリダイレクトを使うためにCloudFrontが使っているS3 BucketのURLを変更する必要があるのが分かった。
NG: old-example-files.s3.amazonaws.com
OK: old-example-files.s3-website.ap-northeast-1.amazonaws.com
（CloudFrontのOrigin設定なのでブラウザに入力するURLと関係ない）
origin {
- domain_name = aws_s3_bucket.old_example_files.bucket_domain_name
+ domain_name = aws_s3_bucket.old_example_files.website_endpoint
origin_id = "S3-old-example-files"
}
Terraformの場合、aws_s3_bucketのリソースにwebsite_endpointという属性が使える。
やったことその④ Custom Origin Configを追加する
リソースの変更は成功したけど、ブラウザで古いサイトのページにアクセスしてみるとそもそも開かない…
When we want to create a CloudFront origin for a S3 static website, we must define a custom_origin_config, otherwise it won't work.
Custom Origin Configの設定も必要か。
origin {
domain_name = aws_s3_bucket.old_example_files.website_endpoint
origin_id = "S3-old-example-files"
custom_origin_config {
http_port = 80
https_port = 443
origin_protocol_policy = "https-only"
origin_ssl_protocols = ["TLSv1.2"]
}
}
やったことその⑤ 使っているAWSリージョンの正しいウェブサイトエンドポイントを使うようにする
AWSリージョンによってURLが違うよ、とAWSのドキュメンテーションに書いてあったからTerrraformがよしなにやってくれると思いきや、そうでもなかった…
NG: old-example-files.s3-website-ap-northeast-1.amazonaws.com
OK: old-example-files.s3-website.ap-northeast-1.amazonaws.com
どのリージョンでも、Terraformのwebsite_endpointが生成するのは上の方になる。
リージョンはTerraformの変数として用意して、正しいURLを生成するロジックを自前で実装した。
-domain_name = aws_s3_bucket.old_example_files.website_endpoint
+domain_name = "${aws_s3_bucket.old_example_files.bucket}.s3-website.${var.aws_region}.amazonaws.com"
※ ap-northeast-1以外のリージョンを使う予定はなかったけど、他のリージョンも使使いたい場合は適切なロジックを組めばいい。各リージョンのウェブサイトエンドポイントがこちらで確認できる。
やったことその⑥ HTTPステータスによってリダイレクトするように変更する
ここまで来てやっとリダイレクトできるようになった 
ただ、そもそもBucketの中身も消したい…と思った時、この設定ではいけない。S3にファイルがある前提の設定になるので、コンテンツがなくても対応できるように少し変える必要がある。
website {
index_document = "home"
routing_rules = jsonencode([
{
Redirect = {
HostName = "new.example.com"
HttpRedirectCode = "301"
Protocol = "https"
ReplaceKeyWith = "home"
}
+ RoutingRuleCondition = {
+ HttpErrorCodeReturnedEquals = "404"
+ }
}
])
}
RoutingRuleConditionを追加することで、リクエストされたオブジェクトが見つからない時だけリダイレクトするように変わる。S3 Bucketのすべてのオブジェクトを削除する予定なので、どのリクエストも404になる。つまり、どのリクエストもリダイレクトされる。
最後に
ここまですれば古いサイトへのリクエストはすべて新しいサイトにリダイレクトされるし、古いS3の中身を消してもOK！
1点だけ注意が必要
リダイレクトさせるためにS3のBucket自体とCloudFrontのDistributionが必要になるので、リダイレクトさせたい間はリソースを残し続けないといけない。
リダイレクトをやめて古いサイトを完全に捨てる、ということになったらもちろんこれらのリソースも削除しちゃっても問題ない。