Come posso usare la funzione Fn::Sub in AWS CloudFormation con Fn::FindInMap, Fn::ImportValue o altre funzioni supportate?

Breve descrizione

È possibile utilizzare la funzione intrinseca Fn::Sub per sostituire le funzioni supportate o per sostituire le variabili in una stringa di input con i valori specificati.

Per sostituire il valore delle funzioni supportate, è necessario utilizzare la mappa variabile con il nome e il valore come mostrato di seguito:

JSON:

{ "Fn::Sub" : [ String, { Var1Name: Var1Value, Var2Name: Var2Value } ] }

YAML:

!Sub
  - String
  - Var1Name: Var1Value
    Var2Name: Var2Value

Risoluzione

Utilizzo di Fn::Sub con la funzione Ref

L'esempio seguente utilizza una mappatura per sostituire la variabile Domain con il valore risultante dalla funzione Ref.

JSON:

{
  "Parameters": {
    "RootDomainName": {
      "Type": "String",
      "Default": "example123.com"
    }
  },
  "Resources": {
    "DNS": {
      "Type": "AWS::Route53::HostedZone",
      "Properties": {
        "Name": {
          "Fn::Sub": [
            "www.${Domain}",
            {
              "Domain": {
                "Ref": "RootDomainName"
              }
            }
          ]
        }
      }
    }
  }
}

YAML:

Parameters:
  RootDomainName:
    Type: String
    Default: example123.com
Resources:
  DNS:
    Type: 'AWS::Route53::HostedZone'
    Properties:
      Name: !Sub
        - 'www.${Domain}'
        - Domain: !Ref RootDomainName

Utilizzo di Fn::Sub con la funzione Fn::FindInMap

L'esempio seguente utilizza una mappatura per sostituire la variabile log_group_name con il valore risultante dalla funzione Fn::FindInMap.

JSON:

{
  "Mappings": {
    "LogGroupMapping": {
      "Test": {
        "Name": "test_log_group"
      },
      "Prod": {
        "Name": "prod_log_group"
      }
    }
  },
  "Resources": {
    "myLogGroup": {
      "Type": "AWS::Logs::LogGroup",
      "Properties": {
        "LogGroupName": {
          "Fn::Sub": [
            "cloud_watch_${log_group_name}",
            {
              "log_group_name": {
                "Fn::FindInMap": [
                  "LogGroupMapping",
                  "Test",
                  "Name"
                ]
              }
            }
          ]
        }
      }
    }
  }
}

YAML:

Mappings:
  LogGroupMapping:
    Test:
      Name: test_log_group
    Prod:
      Name: prod_log_group
Resources:
  myLogGroup:
    Type: 'AWS::Logs::LogGroup'
    Properties:
      LogGroupName: !Sub
        - 'cloud_watch_${log_group_name}'
        - log_group_name: !FindInMap
            - LogGroupMapping
            - Test
            - Name

Utilizzo di Fn::Sub con la funzione Fn::ImportValue

L'esempio seguente utilizza una mappatura per sostituire la variabile Domain con il valore risultante dalla funzione Fn::ImportValue.

Nota: DomainName è il nome dell'output esportato da un altro stack CloudFormation.

JSON:

{
  "Resources": {
    "DNS": {
      "Type": "AWS::Route53::HostedZone",
      "Properties": {
        "Name": {
          "Fn::Sub": [
            "www.${Domain}",
            {
              "Domain": {
                "Fn::ImportValue": "DomainName"
              }
            }
          ]
        }
      }
    }
  }
}

YAML:

Resources:
  DNS:
    Type: 'AWS::Route53::HostedZone'
    Properties:
      Name: !Sub
        - 'www.${Domain}'
        - Domain: !ImportValue DomainName

---