Terraformのmodule cloudfront を利用し CloudFront Functionを設定する場合・しない場合をtfvarsで切り変えたい

Question

実現したいこと

現在、TerraformにてAWSに環境を作成しています。
複数の環境を用意する必要があるのですが、なるべくTerraform側のソースを共通化したいと考えております。

• 環境はディレクトリ単位で切り替える
• ディレクトリ単位でterraform initでterraformの環境を準備する
• CloudFrontなどのAWSリソースを定義するTerraformのソースは別ディレクトリに置いて、環境ごとのディレクトリにはそのファイルをシンボリックリンクを貼る
• 各ディレクトリにterraform.tfvarsファイルを置き、環境ごとの差異がある分を定義する
• Terraformのソース内では、できるだけTerraform Registroyで公開されているModuleを利用して、resource文で定義する箇所を減らしたい
  • 質問したいモジュールとしてはこちらになります https://registry.terraform.io/modules/terraform-aws-modules/cloudfront/aws/latest

CloudFrontそのものを作成する・しないは、create_distribution の true / falseにteraform.tfvars内で定義したvaliable変数を渡して制御しています。

環境ごとにCloudFront Functionが必要な場合と不要な場合があります。

発生している問題・分からないこと

以下のように記述してCloudFront Functionが必要な場合は問題なく

    function_association = {
      viewer-request = {
        function_arn = var.cloudfront_viewer_request_arn
      }
    }

function_arn の部分を function_arn = "" にすると、以下のようなエラーになります。

module.cloudfront[0].aws_cloudfront_distribution.this[0]: Modifying... [id=E19I5NMMR4CRHM]
╷
│ Error: updating CloudFront Distribution (〓ディストリビューションID〓): operation error CloudFront: UpdateDistribution, https response error StatusCode: 400, RequestID: 〓リクエストID〓, api error MalformedXML: 1 validation error detected: Value '' at 'distributionConfig.defaultCacheBehavior.functionAssociations.items.1.member.functionARN' failed to satisfy constraint: Member must satisfy regular expression pattern: arn:aws:cloudfront::[0-9]{12}:function\/[a-zA-Z0-9-_]{1,64}
│
│   with module.cloudfront[0].aws_cloudfront_distribution.this[0],
│   on .terraform\modules\cloudfront\main.tf line 27, in resource "aws_cloudfront_distribution" "this":
│   27: resource "aws_cloudfront_distribution" "this" {
│

function_arn の部分を function_arn = false にすると、以下のようなエラーになります。

Planning failed. Terraform encountered an error while generating this plan.

╷
│ Error: "default_cache_behavior.0.function_association.0.function_arn" (false) is an invalid ARN: arn: invalid prefix
│
│   with module.cloudfront[0].aws_cloudfront_distribution.this[0],
│   on .terraform\modules\cloudfront\main.tf line 27, in resource "aws_cloudfront_distribution" "this":
│   27: resource "aws_cloudfront_distribution" "this" {
│
╵

function_arn の部分を function_arn = null にすると、以下のようなエラーになります。

Planning failed. Terraform encountered an error while generating this plan.

╷
│ Error: Missing required argument
│
│   with module.cloudfront[0].aws_cloudfront_distribution.this[0],
│   on .terraform\modules\cloudfront\main.tf line 27, in resource "aws_cloudfront_distribution" "this":
│   27: resource "aws_cloudfront_distribution" "this" {
│
│ The argument "default_cache_behavior.0.function_association.0.function_arn" is required, but no definition was found.
╵

こういった動作をさせることは可能でしょうか。
可能な場合、どのように記述すべきでしょうか。
以上、よろしくお願いいたします。

該当のソースコード

特になし

試したこと・調べたこと

• teratailやGoogle等で検索した
• ソースコードを自分なりに変更した
• 知人に聞いた
• その他

上記の詳細・結果

Webを検索してもマッチした情報を見つけることができませんでした。

補足

環境は以下の通りです。
Terraform v1.9.2
provider registry.terraform.io/hashicorp/aws v5.58.0
CoudFrontモジュール terraform-aws-modules/cloudfront/aws 3.4.0

Comments

[68user]

CloudFront Function を使ったことも作ったこともないですが、https://dev.classmethod.jp/articles/cloudfront-functions-per-env-terraform/ ですかね?

[GotHokLin]

68userさん、コメントありがとうございました。
別件で忙殺状態でお礼もお伝えしておりませんでいた。大変失礼いたしました。
挙げていただいた内容でうまくいきそうです。
私自身がDynamic Blockを使ったことがないので、まだピンときていないところがありますが、まさにやろうとしていたことがここに記載されておりました。
頂いた記事・Dynamic Block自体も理解して利用してみたいと思います。

Answer 1

すっかり遅くなってしまいましたが、こちらの件は以下のように実現しました。
以下のように記述し、うまくいっております。
どなたかの参考になれば幸いです。
なお、こちらはモジュールのバージョンを3.4.0に固定しています。
2025年8月10日現在、CloudFrontのモジュールは5.0.0となっているようです。
新規に構築する場合は、新しいバージョンを利用する方がよいかと思いますので、その辺ご留意ください。

terraform.tfvars内

create_cloudfront = true

CloudFront作成moduleの記述

module "cloudfront" {
  count                        = var.create_cloudfront ? 1 : 0
  create_distribution          = var.create_cloudfront
  create_origin_access_control = var.create_cloudfront
  source                       = "terraform-aws-modules/cloudfront/aws"
  version                      = "3.4.0"
……

Answer 2

なお、上記の記述が、モジュールのバージョンを3.4.0に固定しています。
2025年8月10日現在、CloudFrontのモジュールは5.0.0となっているようです。
新たに作成する場合は、新しいバージョンを利用する方がよいかと思いますので、ご留意ください。

上記、ここに記述すると分かりにくかったため、削除したかったですが、削除ができませんでした。
取り消し線で消して、自己解決欄のコメントに追記しておきます。