如何在Crossplane组合中遍历输入数组创建多区域AWS资源？

问题描述 #

我有一个Crossplane XRD，希望在多个AWS区域中创建同一组资源，对应的XRD实例YAML配置如下：

apiVersion: aws.example.com/v1alpha1
kind: XFoo
metadata: 
  name: green-foo
spec: 
  clusters: 
    regions: 
      - us-east-1
      - us-east-2
      - us-west-2

请问在Crossplane组合中，如何为clusters.regions数组内的每个区域创建对应资源？是否存在遍历输入并为每个条目生成资源的方法？

解决方案：使用Crossplane Composition的for-each遍历数组 #

Crossplane支持通过**for-each字段**遍历输入数组，为每个条目生成对应的资源实例，完全满足多区域批量创建资源的需求。

核心实现思路 #

在Composition的resources块中，通过Go模板语法遍历spec.clusters.regions数组，将每个区域值作为独立项传入资源模板，再在模板中引用当前遍历项来生成对应区域的资源配置。

示例Composition配置 #

以下是创建多区域S3存储桶的示例，你可以基于这个模式扩展到EC2、RDS等其他AWS资源：

apiVersion: apiextensions.crossplane.io/v1
kind: Composition
metadata:
  name: xfoos.aws.example.com
  labels:
    crossplane.io/xrd: xfoos.aws.example.com
spec:
  compositeTypeRef:
    apiVersion: aws.example.com/v1alpha1
    kind: XFoo
  resources:
    - name: regional-s3-bucket
      # 遍历regions数组，将每个区域作为遍历项
      for-each: "{{ range .spec.clusters.regions }}{{ . }} {{ end }}"
      base:
        apiVersion: s3.aws.crossplane.io/v1beta1
        kind: Bucket
        metadata:
          # 用当前区域名区分资源名称
          name: "green-foo-bucket-{{ index .for-each.item }}"
        spec:
          forProvider:
            # 引用当前遍历的区域值
            region: "{{ index .for-each.item }}"
            acl: private
          providerConfigRef:
            name: aws-provider

关键细节说明 #

• 遍历语法：for-each字段使用Go模板的range循环遍历数组，将每个区域值传入资源模板上下文。
• 引用遍历项：通过{{ index .for-each.item }}获取当前遍历到的区域名称，确保每个区域的资源名称、部署区域等配置唯一。
• 资源自动生成：只需定义一套资源模板，Crossplane会自动为数组中的每个区域创建独立的资源实例，无需重复编写资源配置。

内容的提问来源于stack exchange，提问作者ams