Utilización de Application Manager para gestionar plantillas de AWS CloudFormation

Application Manager, una capacidad de AWS Systems Manager, incluye una biblioteca de plantillas y otras herramientas para ayudarlo a administrar plantillas de AWS CloudFormation. Esta sección incluye la siguiente información.

Trabajar con la biblioteca de plantillas

La biblioteca de plantillas de Application Manager proporciona herramientas para ayudarlo a ver, crear, editar, eliminar y clonar plantillas. También puede aprovisionar pilas directamente desde la biblioteca de plantillas. Las plantillas se almacenan como documentos de Systems Manager (SSM) de tipo CloudFormation. Cuando almacena plantillas como documentos de SSM, puede utilizar controles de versión para trabajar con diferentes versiones de una plantilla. También puede establecer permisos y compartir plantillas. Después de aprovisionar correctamente una pila, la pila y la plantilla están disponibles en Application Manager y en CloudFormation.

Antes de empezar

Le recomendamos que lea los siguientes temas para obtener más información acerca de los documentos de SSM antes de comenzar a trabajar con plantillas de CloudFormation en Application Manager.

Creación de una plantilla

El siguiente procedimiento describe cómo crear una plantilla de CloudFormation en Application Manager. Cuando crea una plantilla, ingresa los detalles de la pila de la plantilla en JSON o YAML. Si no está familiarizado con JSON o YAML, puede utilizar AWS CloudFormation Designer, una herramienta para crear y modificar plantillas visualmente. Para obtener más información, consulte ¿Qué es un diseñador de AWS CloudFormation? en la guía del usuario de AWS CloudFormation. Para obtener información acerca de la estructura y la sintaxis de una plantilla, consulte Anatomía de la plantilla.

También puede construir una plantilla a partir de varios fragmentos de plantillas. Los fragmentos de plantillan son ejemplos que demuestran cómo escribir plantillas para un recurso en concreto. Por ejemplo, puede ver fragmentos de instancias de Amazon Elastic Compute Cloud (Amazon EC2), dominios de Amazon Simple Storage Service (Amazon S3), mapeos de AWS CloudFormation y mucho más. Los fragmentos se agrupan por recurso. Puede encontrar fragmentos de AWS CloudFormation de propósito general en la sección Fragmentos generales de plantillas en la Guía del usuario de AWS CloudFormation.

Creación de una plantilla de CloudFormation enApplication Manager (consola)

Utilice el siguiente procedimiento para crear una plantilla de CloudFormation en Application Manager mediante la AWS Management Console.

Creación de una plantilla de CloudFormation en Application Manager (línea de comandos)

Después de crear el contenido de su plantilla de CloudFormation en JSON o YAML, puede utilizar AWS Command Line Interface (AWS CLI) o AWS Tools for PowerShell para guardar la plantilla como documento de SSM. Reemplace cada example resource placeholder con su propia información.

Antes de empezar

Si aún no lo ha hecho, instale y configure la AWS CLI o AWS Tools for PowerShell. Para obtener información, consulte Instalación o actualización de la última versión de la AWS CLI e Instalación de AWS Tools for PowerShell.

Linux & macOS

aws ssm create-document \
    --content file://path/to/template_in_json_or_yaml \
    --name "a_name_for_the_template" \
    --document-type "CloudFormation" \
    --document-format "JSON_or_YAML" \
    --tags "Key=tag-key,Value=tag-value"

Windows

aws ssm create-document ^
    --content file://C:\path\to\template_in_json_or_yaml ^
    --name "a_name_for_the_template" ^
    --document-type "CloudFormation" ^
    --document-format "JSON_or_YAML" ^
    --tags "Key=tag-key,Value=tag-value"

PowerShell

$json = Get-Content -Path "C:\path\to\template_in_json_or_yaml | Out-String
New-SSMDocument `
    -Content $json `
    -Name "a_name_for_the_template" `
    -DocumentType "CloudFormation" `
    -DocumentFormat "JSON_or_YAML" `
    -Tags "Key=tag-key,Value=tag-value"

Si se ejecuta correctamente, el comando devolverá una respuesta similar a la siguiente.

{
    "DocumentDescription": {
        "Hash": "c1d9640f15fbdba6deb41af6471d6ace0acc22f213bdd1449f03980358c2d4fb",
        "HashType": "Sha256",
        "Name": "MyTestCFTemplate",
        "Owner": "428427166869",
        "CreatedDate": "2021-06-04T09:44:18.931000-07:00",
        "Status": "Creating",
        "DocumentVersion": "1",
        "Description": "My test template",
        "PlatformTypes": [],
        "DocumentType": "CloudFormation",
        "SchemaVersion": "1.0",
        "LatestVersion": "1",
        "DefaultVersion": "1",
        "DocumentFormat": "YAML",
        "Tags": [
            {
                "Key": "Templates",
                "Value": "Test"
            }
        ]
    }

Edición de una plantilla

Utilice el siguiente procedimiento para crear una plantilla de CloudFormation en Application Manager. Los cambios de plantilla están disponibles en CloudFormation después de aprovisionar una pila que utiliza la plantilla actualizada.