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 Crear una acción, etapas y acciones 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 Secciones de la plantilla de CloudFormation.

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.