Artefactos de AWS CloudFormation

CodePipeline realiza tareas en artefactos mientras CodePipeline ejecuta una canalización. Para AWS CloudFormation, los artefactos pueden incluir un archivo de plantilla de pila, un archivo de configuración de plantilla o ambos. CodePipeline utiliza estos artefactos para trabajar con pilas y conjuntos de cambios de AWS CloudFormation.

Si utiliza Amazon Simple Storage Service (Amazon S3) como un repositorio de origen, deberá comprimir la plantilla y los archivos de configuración de la plantilla en un solo archivo antes de cargarlos en un bucket de S3. Para otros repositorios, como GitHub y AWS CodeCommit, cargue los artefactos sin comprimirlos. Para obtener más información, consulte Create a pipeline in CodePipeline (Creación de una canalización en CodePipeline) en la Guía del usuario de AWS CodePipeline.

Puede añadir tantos archivos como necesite a su repositorio. Por ejemplo, es posible que desee incluir dos configuraciones diferentes para la misma plantilla: una para la configuración de prueba y otra para una configuración de producción.

Este tema describe cada tipo de artefacto.

Archivo de plantilla de pila

Un archivo de plantilla de pila define los recursos que aprovisiona y configura AWS CloudFormation. Estos archivos son los mismos archivos de plantillas que utiliza al crear o actualizar pilas mediante AWS CloudFormation. Puede utilizar plantillas con formato YAML o JSON. Para obtener más información acerca de las plantillas, consulte Anatomía de la plantilla.

Archivo de configuración de plantillas

Un archivo de configuración de plantillas es un archivo de texto con formato JSON que puede especificar los valores de los parámetros de plantilla, una política de pila y etiquetas. Utilice estos archivos de configuración para especificar valores de parámetros o una política para una pila. Todos los valores de los parámetros que especifique se deben declarar en la plantilla asociada.

Si incluye información confidencial, como contraseñas, en este archivo, restrinja el acceso a este archivo. Por ejemplo, si carga el artefacto en un bucket de S3, utilice políticas de bucket de S3 o políticas de usuario para restringir el acceso.

Para crear un archivo de configuración, utilice el siguiente formato:

{
  "Parameters" : {
    "NameOfTemplateParameter" : "ValueOfParameter",
    ...
  },
  "Tags" : {
    "TagKey" : "TagValue",
    ...
  }, 
  "StackPolicy" : {
    "Statement" : [
      StackPolicyStatement
    ]
  }
}

El siguiente ejemplo especifica TestEC2Key para el parámetro KeyName, añade una etiqueta Department cuyo valor es Marketing y añade una política de pila que permite todas las acciones de actualización, excepto una actualización que elimine un recurso.

{
  "Parameters" : {
    "KeyName" : "TestEC2Key"
  },
  "Tags" : {
    "Department" : "Marketing"
  },
  "StackPolicy" : {
    "Statement" : [
      {
        "Effect" : "Allow",
        "NotAction" : "Update:Delete",
        "Principal": "*",
        "Resource" : "*"
      }
    ]
  }
}

Véase también

Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con estos parámetros.

• Para obtener más información sobre los parámetros de acción de AWS CloudFormation en CodePipeline, consulte la referencia de configuración de acciones de AWS CloudFormation en la Guía del usuario de AWS CodePipeline.

• Para ver valores de plantilla de ejemplo según el proveedor de acción, como para el campo Owner o los campos configuration, consulte la Action structure reference (Referencia de estructura de acciones) en la Guía del usuario de AWS CodePipeline.

• Para descargar las plantillas de la pila de canalización de ejemplo en formato YAML o JSON, consulte los tutoriales que se encuentran en Creación de una canalización con AWS CloudFormation en la Guía del usuario de AWS CodePipeline.