Quero usar a função intrínseca Fn::Sub no AWS CloudFormation com Fn::FindInMap, Fn::ImportValue ou outras funções suportadas.
Breve descrição
Você pode usar a função intrínseca Fn::Sub para substituir funções suportadas ou para substituir variáveis em uma string de entrada por valores que você especifica.
Para substituir o valor das funções suportadas, você deve usar o mapa de variáveis com o nome e o valor, conforme mostrado abaixo:
JSON:
{ "Fn::Sub" : [ String, { Var1Name: Var1Value, Var2Name: Var2Value } ] }
YAML:
!Sub
- String
- Var1Name: Var1Value
Var2Name: Var2Value
Resolução
Uso de Fn::Sub com a função Ref
O exemplo a seguir usa um mapeamento para substituir a variável Domínio pelo valor resultante da função 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
Uso de Fn::Sub com a função Fn::FindInMap
O exemplo a seguir usa um mapeamento para substituir a variável log_group_name pelo valor resultante da função 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
Uso de Fn::Sub com a função Fn::ImportValue
O exemplo a seguir usa um mapeamento para substituir a variável Domínio pelo valor resultante da função Fn::ImportValue.
Observação: “DomainName” é o nome da Saída exportada por outra pilha do 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