Funciones Clave en CloudFormation: GetAtt, FindInMap, Join, Split y Select

Clase 20 de 38 • Curso de Infraestructura Como Código en AWS

Resumen

¿Qué son las funciones de laboratorio y cómo optimizan los proyectos?

En el ámbito del desarrollo de software, especialmente cuando trabajamos con infraestructuras definidas como código, las funciones juegan un papel crucial para mejorar la eficiencia y flexibilidad de los proyectos. A continuación, exploraremos varias funciones que puedes aplicar en tus futuros proyectos, específicamente en CloudFormation. Veremos las funciones GetAtt, FindInMap, Join, y las combinaciones de Split y Select.

¿Cómo podemos usar GetAtt?

La función GetAtt nos permite acceder al valor de un atributo específico de un recurso en CloudFormation. Aquí se aborda cómo funciona y cuándo es relevante utilizarla.

Composición de la función: GetAtt se escribe como el nombre del recurso seguido por un punto y el nombre del atributo. Dependiendo de si usas JSON o YAML, puedes elegir entre distintas sintaxis, pero la tercera versión en YAML suele ser la más sencilla.

!GetAtt NombreRecurso.NombreAtributo

Ejemplo práctico: Imagina que tienes un rol y una función Lambda. Primero, creas el rol y luego la función Lambda haciendo referencia a ese rol. Usarías GetAtt para acceder al ARN del rol y asignárselo a la Lambda.

¿Qué ventajas tiene usar FindInMap?

FindInMap es una función que complementa a los mappings. Permite buscar valores específicos en un mapping y es especialmente útil si se necesitan adaptar configuraciones, como imágenes de servidores, basadas en la región.

Componentes de la función: Se compone del nombre del mapping, el key (que puede ser la región, por ejemplo) y el sub-key del valor a traer.

!FindInMap [ NombreMapping, Key, Sub-Key ]

Caso de uso: Puedes tener una lista de AMIs por región. Al crear una instancia EC2, FindInMap puede buscar y retornar la AMI adecuada según la región.

¿Para qué se utiliza Join?

La función Join permite unir valores en una sola cadena de texto, definiendo un delimitador para separar cada valor.

Uso de la función: Útil cuando necesitas combinar múltiples valores en un único string, ideal para formatos o documentación.

!Join [ Delimitador, [ Valor1, Valor2, ...] ]

¿Cómo funcionan las combinaciones de Split y Select?

Las funciones Split y Select son útiles juntas para dividir una cadena de texto en componentes y luego seleccionar uno de ellos.

División con Split: Separa una cadena utilizando un delimitador determinado.
Selección con Select: Una vez dividida la cadena, selecciona un elemento específico basado en su índice.

!Select [ Índice, !Split [ Delimitador, Cadena ] ]

Escenario práctico: Supongamos que manejas identificadores de cuentas. Puedes dividirlos por un delimitador y luego seleccionar el identificador específico que necesitas.

Estas funciones amplían el poder y la lógica de tus plantillas de CloudFormation, permitiendo un control más preciso y una reutilización eficiente del código. Estudia cada función detenidamente y pruébalas para aprovechar al máximo tus recursos en la nube. Te recomendamos consultar la documentación de AWS para entender completamente sus capacidades y limitaciones. ¡Sigue aprendiendo y optimizando tu repertorio de habilidades!

Andres Alberto Ariza Mantilla

student•

creo que en el minuto 7:28 hay un error en como se explica el Join,

Examples Join a Simple String Array The following example returns: "a : b : c".

YAML !Join [ ":", [ a, b, c ] ]

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-join.html

William Alberto Estrada Escobar

student•

Si, creo que el elemento de origen y el destino quedaron invertidos

John H. Piragauta

student•

Confirmo, esta invertido. Un Lapsus... :)

Mario Alexander Vargas Celis

student•

En AWS CloudFormation, las funciones intrínsecas te permiten realizar operaciones dinámicas dentro de tus plantillas YAML o JSON. Aquí te explico las funciones clave que mencionaste: !GetAtt, !FindInMap, !Join, !Split y !Select, con ejemplos prácticos para cada una.

🔧 1. !GetAtt — Obtener atributos de recursos

Devuelve el valor de un atributo de un recurso creado en la misma plantilla.

📌 Sintaxis:

!GetAtt ResourceName.AttributeName

📦 Ejemplo: Obtener la ARN de una Lambda

Outputs: LambdaArn: Value: !GetAtt MiFuncionLambda.Arn

🗺️ 2. !FindInMap — Buscar valores en mapas de parámetros

Busca un valor en una estructura tipo mapa (Mappings), útil para valores por región, ambiente, tipo de instancia, etc.

📌 Sintaxis:

!FindInMap [ MapName, TopLevelKey, SecondLevelKey ]

📦 Ejemplo:

Mappings: RegionMap: us-east-1: AMI: ami-12345678 us-west-2: AMI: ami-87654321

Resources: MyEC2: Type: AWS::EC2::Instance Properties: ImageId: !FindInMap [RegionMap, !Ref "AWS::Region", AMI]

🔗 3. !Join — Concatenar cadenas

Une varios valores en una sola cadena, usando un delimitador.

📌 Sintaxis:

!Join [ delimiter, [ list_of_values ] ]

📦 Ejemplo:

Value: !Join [ "", [ "arn:aws:s3:::", !Ref MiBucket ] ]

🔍 Resultado si MiBucket = my-bucket: arn:aws:s3:::my-bucket

✂️ 4. !Split — Separar cadenas

Divide una cadena en una lista usando un delimitador.

📌 Sintaxis:

!Split [ delimiter, string ]

📦 Ejemplo:

!Split [ ",", "a,b,c,d" ]

🔍 Resultado: ["a", "b", "c", "d"]

🔢 5. !Select — Seleccionar un elemento de una lista

Elige un elemento de una lista por índice.

📌 Sintaxis:

!Select [ index, list ]

📦 Ejemplo:

!Select [ 1, [ "apple", "banana", "cherry" ] ]

🔍 Resultado: "banana"

💡 Usadas en conjunto:

📦 Ejemplo combinado de !Split y !Select:

Value: !Select [ 1, !Split [ ",", "ami-123,ami-456,ami-789" ] ]

🔍 Resultado: ami-456

🧪 Consejos para usar estas funciones

FunciónÚtil para...!GetAttObtener atributos como ARN o URLs!FindInMapConfiguración regional o por tipo!JoinFormar ARNs, URLs, nombres!SplitDividir entradas dinámicas!SelectTomar valores específicos de una lista

ELKIN YESID MORENO VELEZ

student•

En la función FindInMap como trae una ami en particular si se tiene en cuenta que tienen como etiqueta : HVM64 las tres.

Gracias, saludos y éxitos.

Ixcoatl Francisco Pérez

student•

Existe un error en el Return del JOIN, la correcta salida es: Join a simple string array The following example returns: "a:b:c"

Jorge David Duque Agudelo

student•

¿Cuando se utiliza la función !GetAtt apuntando a un atributo como el ARN, este genera una dependencia hacía el recurso del que se está trayendo la información?

Ejm:

ExampleAFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: src/
      Handler: app.lambda_handler
      Runtime: python3.7
      Role: !GetAtt LambdaIAMRole.Arn

  LambdaIAMRole:
    Type: AWS::IAM::Role
    Properties:
      ManagedPolicyArns:
        - !Ref CloudWatchLogsPolicy
        - !Ref SqsPolicy
        - !Ref LambdaInvokePolicy
      RoleName: !Join ['-',[!Ref 'AWS::StackName','lambda', 'role']]
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal:
              Service:
                - "lambda.amazonaws.com"
            Action:
              - "sts:AssumeRole"
      Path: /

¿En este caso se genera una dependencia implicita de la función lambda hacia el Rol IAM por acceder a un atributo que solo se tiene cuando el recurso está creado?

Jaime Andres Valencia Gaviria

student•

cuando necesitas hacer referencia a otro recurso, el arn es como el identificador unico de recursos de aws

Roger Alberto Chan Arjona

student•

Funciones Intrinsecas

Son funciones que pueden ser utilizadas dentro del archivo del stack (YAML o JSON) que nos permiten obtener atributos (informacion) de otros recursos (que se encuentran en otra parte de archivo del stack)

GetAtt: Permite obtener el atributo de un recurso.

Ejemplo:

Resources:
	ServerlessResourceName:
		Type: AWS::Serverless:Function
		...
		Role: !GetAtt LambdaRoleResourceName.Arn

	LambdaRoleResourceName:
		Type: AWS::IAM::Role
		...

FindInMap: Devuelve el valor correspondiente al map decladrado en la seccion Mappings

Ejemplo:

Mappings:
	RegionMap:
		us-east-1:
			HVM64: "ami-0000"
		us-west-1:
			HVM64: "ami-0000"
		eu-west-1:
			HVM64: "ami-0000"
Resources::
	ResourceName:
		Type: "AWS::EC2::Instance"
		Properties:
			ImageId: !FindInMap
				- RegionMap
				- !Ref: 'AWS::Region'
				- HVM64

Join: Unir valores diferentes en uno solo.

Funciona de la siguiente manera:

"a:b:c" -> !Join [":", [a,b,c]] -> [a,b,c]

Split y Select

Split: Dividir una cadena en una lista de valores Select: Selecciona un valor de una lista de valores

Se utilizan en conjunto para obtener un valor:

Ejemplo:

Origen: "OPS:XXXXXXXXX" -> De este se requiere el valor "XXXXXXX"

Funcion: !Select[1, !Split[":", !Ref Cuenta]]

Resultado: "XXXXXXXXX"

john ct

student•

interesante

john ct

student•

El modo correcto de presentacion del join se invirtio los separadores [a,b,c] > !join [":",[a:b:c]]> [a:b:c]

Usuario anónimo

user•

entendido :)

Luis Val

student•

buena clase!!

Ivan Acosta

student•

Muy interesante. De que manera se puede validar la sintaxis de una plantilla que uno elabore?. AWS tiene algún plugín para ello?

Capacitación y entrenamiento Sistemas

student•

https://github.com/aws-cloudformation/cfn-python-lint