Obtención de salidas exportadas de una pila implementada de CloudFormation

Si tiene varias pilas en la misma Cuenta de AWS y región, es posible que desee compartir información entre ellas. Esto resulta útil cuando una pila necesita usar recursos creados por otra pila.

Por ejemplo, puede tener una pila que cree recursos de red, como subredes y grupos de seguridad, para sus servidores web. Luego, otras pilas que crean los servidores web reales pueden utilizar los recursos de red creados por la primera pila. No es necesario codificar de forma rígida los IDs de recursos en la plantilla de la pila ni pasar los IDs como parámetros de entrada.

Para compartir información entre pilas, exporta los valores de salida de una pila y los importa a otra pila. Así es como funciona:

Para obtener un tutorial y plantillas de ejemplo, consulte Consulta de las salidas de recursos en otra pila de CloudFormation.

Exportación de valores de salida de pilas en comparación con el uso de pilas anidadas

Una pila anidada es un pila que crea en otra pila con el recurso AWS::CloudFormation::Stack. Con pilas anidadas, se implementan y administran todos los recursos desde una sola pila. Se pueden usar salidas desde una pila en el grupo de pilas anidadas como entradas a otra pila del grupo. Esto difiere de la exportación de valores.

Si desea que solo se intercambie información dentro de un grupo de pilas anidadas, le sugerimos que utilice pilas anidadas. Para compartir información con otras pilas (no solo dentro del grupo de pilas anidadas), exporte valores. Por ejemplo, puede crear una sola pila con una subred y, a continuación, exportar su ID. Otras pilas pueden utilizar dicha subred importando su ID. Cada pila no tiene por qué crear su propia subred. Mientras las pilas importen el ID de la subred, no se puede cambiar ni eliminar.

Para obtener más información sobre las pilas anidadas, consulte División de una plantilla en piezas reutilizables utilizando pilas anidadas.

Consideraciones

Las siguientes restricciones se aplican a las referencias cruzadas entre pilas:

Listado de valores de salida exportados

Si necesita ver los valores de las salidas exportadas de sus pilas, utilice uno de los siguientes métodos:

Para obtener una lista de los valores de salida exportados (AWS CLI)

Use el siguiente comando list-exports. Sustituya us-east-1 por su Región de AWS.

aws cloudformation list-exports --region us-east-1

A continuación, se muestra un ejemplo del resultado.

{
    "Exports": [
        {
            "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800",
            "Name": "private-vpc-subnet-a",
            "Value": "subnet-07b410xmplddcfa03"
        },
        {
            "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800",
            "Name": "private-vpc-subnet-b",
            "Value": "subnet-075ed3xmplebd2fb1"
        },
        {
            "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800",
            "Name": "private-vpc-vpcid",
            "Value": "vpc-011d7xmpl100e9841"
        }
    ]
}

CloudFormation muestra los nombres y los valores de las salidas exportadas para la región actual y la pila desde la que se esperaban. Para usar un valor de salida exportado en otra plantilla de pila, puede referenciarla con el nombre de exportación y la función Fn::ImportValue.

Enumeración de pilas que importan un valor de salida exportado

Para eliminar o cambiar los valores de salida exportados, primero debe averiguar qué pilas los importan.

Para ver las pilas que importan un valor de salida exportado, utilice uno de los siguientes métodos:

Para obtener una lista de pilas que importan un valor de salida exportado (AWS CLI)

Utilice el comando list-imports. Sustituya us-east-1 por su Región de AWS y private-vpc-vpcid por el nombre del valor de salida exportado.

aws cloudformation list-imports --region us-east-1 \
    --export-name private-vpc-vpcid

CloudFormation devuelve una lista de pilas que están importando el valor.

{
    "Imports": [
        "my-app-stack"
    ]
}

Una vez que sepa qué pilas importan un valor exportado en particular, debe modificar esas pilas para eliminar las funciones Fn::ImportValue que refieren a los valores de salida. Debe eliminar todas las importaciones que hacen referencia a valores de salida exportados antes de poder eliminar o modificar los valores de salida exportados.

Hacer referencia a las salidas sin exportaciones

Además de utilizar Export y Fn::ImportValue para referencias cruzadas entre pilas, se puede utilizar Fn::GetStackOutput para hacer referencia directamente a las salidas de las pilas. Este enfoque no requiere que la pila a la que se hace referencia declare una exportación y admita referencias entre cuentas y regiones.

En la tabla siguiente se comparan las dos opciones:

Cuándo usar cada enfoque:

Para obtener más información, consulte Fn::GetStackOutput en la Guía de referencia de plantillas de CloudFormation.