AWS CDK公式の機能でACMとCloudFrontのクロスリージョン参照を実装する

AWS CDKでクロスリージョン参照できなくて、悔しい思いをしたことはありませんか？ 私はよくあります。

そんなときはcdk-remote-stackパッケージを利用すると解決できており、以前ブログも書きました。

• AWS CDK（cdk-remote-stack）でACMとCloudFrontのクロスリージョン参照を実装する | DevelopersIO

ところが、いつの間にかAWS CDK公式でクロスリージョン参照できるようになっていました！（2023/10/05時点では、まだexperimentalな機能です）

• aws-cdk-lib module · AWS CDK

以前のブログ同様、次の図のようなCloudFront+S3の環境を東京（ap-northeast-1）リージョンで構築して、 CloudFrontにカスタムドメインをつける場合、CloudFrontの仕様上バージニア（us-east-1）リージョンでACMを構築する必要があります。

今回、公式の機能を使ってクロスリージョン参照ができるようになっていたので、実際にこの環境をAWS CDKで作ってみました。

サンプルコード

今回cdkで構築する環境のサンプルコードは以下に保存しています。細部が気になる方はこちらを御覧ください。

前提条件

AWS CDKはv2を使用しています。

$ cdk --version
2.99.1 (build b2a895e)

Version 2.50.0で追加された機能なので、それより新しければ動くと思います。

• aws-cdk/CHANGELOG.v2.md at main · aws/aws-cdk

Route 53のパブリックホストゾーンを事前に作成しています。

解説

主なファイル構成はこんな感じです。

• bin/
  • cdk-cloudfront-cross-region-sample.ts
• lib/
  • acm-for-cloudfront-stack.ts
  • cloudfront-stack.ts
  • s3/
    • index.html

#!/usr/bin/env node
import "source-map-support/register"
import * as cdk from "aws-cdk-lib"
import { AcmForCloudfrontStack } from "../lib/acm-for-cloudfront-stack"
import { CloudfrontStack } from "../lib/cloudfront-stack"

const account = "<<YOUR_AWS_ACCOUNT_NO>>"
const domainName = "<<YOUR_PUBLIC_DOMAIN_NAME>>"
const hostName = "cf-cross"

const envJP: cdk.Environment = {
  account,
  region: "ap-northeast-1",
}

const envUS: cdk.Environment = {
  account,
  region: "us-east-1",
}

const app = new cdk.App()

const acmForCloudfront = new AcmForCloudfrontStack(
  app,
  "AcmForCloudfrontStack",
  {
    env: envUS,
    crossRegionReferences: true,
    domainName,
    hostName,
  },
)

const cloudfront = new CloudfrontStack(app, "CloudFrontStack", {
  env: envJP,
  crossRegionReferences: true,
  domainName,
  hostName,
  certificate: acmForCloudfront.certificate,
})

自分で使用するときは、環境に合わせて <<YOUR_AWS_ACCOUNT_NO>> と <<YOUR_PUBLIC_DOMAIN_NAME>> を書き換えてください。

まず最初に23行目でバージニアリージョンのACMを作成しています。

この時、スタックプロパティに crossRegionReferences: true を設定することで、異なるリージョン間であっても リソースの受け渡しができるようになります。

34行目でバージニアリージョンのACMを受け渡しつつ、東京リージョンでCloudFront+S3を作成しています。

同様に、スタックプロパティに crossRegionReferences: true を設定しています。

たったこれだけで、クロスリージョン参照ができるようになります。簡単ですね！

受け渡しさえできれば、あとは普通にCloudFrontを構築するだけです。

CloudFrontのAWS CDKでの書き方は、こちらのブログをご覧ください。

実際のプログラムはこちらです。

cdk-cloudfront-cross-region-sample/cloudfront-stack.ts at main · rednes/cdk-cloudfront-cross-region-sample

このcdkをデプロイすると、S3を東京リージョンに配置しながらカスタムドメインのCloudFrontが構築できます。

終わりに

AWS CDKでのクロスリージョンの参照が更に簡単になりました。 現時点ではexprementalな機能ですが、正式に取り入れられると良いですね。 いろいろなパターンで使えそうなので、クロスリージョン参照で困っている方はぜひ試してみてください。