Referencia de acciones en origen de Amazon S3

Desencadena la canalización cuando se carga un nuevo objeto en el bucket y la clave de objeto configurados.

nota

En este tema de referencia se describe la acción de origen de Amazon S3 CodePipeline cuando la ubicación de origen es un bucket de Amazon S3 configurado para el control de versiones. Para obtener información de referencia sobre la acción de implementación de Amazon S3 en CodePipeline, consulteReferencia de acciones de implementación de Amazon S3.

Puede crear un bucket de Amazon S3 para usarlo como ubicación de origen de los archivos de la aplicación.

nota

Cuando cree el bucket de origen, asegúrese de habilitar el control de versiones en el bucket. Si desea utilizar un bucket de Amazon S3 existente, consulte Uso del control de versiones para habilitar el control de versiones en un bucket existente.

Si utiliza la consola para crear o editar su canalización, CodePipeline crea una regla de CloudWatch eventos que la inicie cuando se produzca un cambio en el bucket de origen de S3.

Debe haber creado ya un bucket de código fuente de Amazon S3 y cargado los archivos de origen como un solo ZIP archivo antes de conectar la canalización mediante una acción de Amazon S3.

nota

Si Amazon S3 es el proveedor de origen de la canalización, debe comprimir los archivos de origen en un solo archivo.zip y cargarlo en el bucket de origen. También puede cargar un archivo sin comprimir; sin embargo, se producirá un error en las acciones posteriores que esperan un archivo.zip.

Tipo de acción

• Categoría: Source

• Propietario: AWS

• Proveedor: S3

• Versión: 1

Parámetros de configuración

S3 Bucket

Obligatorio: sí

El nombre del bucket de Amazon S3 en el que se van a detectar los cambios de origen.

S3 ObjectKey

Obligatorio: sí

El nombre de la clave de objeto de Amazon S3 en la que se van a detectar los cambios de origen.

AllowOverrideForS3 ObjectKey

Obligatorio: no

AllowOverrideForS3ObjectKeycontrola si las anulaciones de origen StartPipelineExecution pueden anular las ya configuradas S3ObjectKey en la acción de origen. Para obtener más información sobre las anulaciones de fuentes con la clave de objeto de S3, consulte. Iniciar una canalización con una anulación de revisión de código fuente

importante

Si la omiteAllowOverrideForS3ObjectKey, CodePipeline establece este parámetro en de forma predeterminada para anular el S3 ObjectKey en la acción de origen. false

Los valores válidos para este parámetro son:

• true: Si se establece, la clave de objeto de S3 preconfigurada se puede anular mediante anulaciones de revisión de origen durante la ejecución de una canalización.

  nota

  Si quieres que todos los CodePipeline usuarios puedan anular la clave de objeto de S3 preconfigurada al iniciar una nueva ejecución de canalización, debes configurarla en. AllowOverrideForS3ObjectKey true

• false:

  Si se establece, no CodePipeline permitirá anular la clave de objeto de S3 mediante anulaciones de revisión de origen. También es el valor por defecto de este parámetro.

PollForSourceChanges

Obligatorio: no

PollForSourceChangescontrola si CodePipeline sondea el bucket de origen de Amazon S3 en busca de cambios en la fuente. Le recomendamos que utilice CloudWatch Events y CloudTrail, en su lugar, detecte los cambios en la fuente. Para obtener más información sobre la configuración de CloudWatch eventos, consulte Migre las canalizaciones de sondeo con una fuente S3 y CloudTrail trail () CLI oMigre las canalizaciones de sondeo con una fuente y un CloudTrail seguimiento (AWS CloudFormation plantilla) de S3.

importante

Si tiene intención de configurar CloudWatch los eventos, debe configurarlos PollForSourceChanges false para evitar la duplicación de ejecuciones en canalización.

Los valores válidos para este parámetro son:

• true: Si está configurado, CodePipeline sondea la ubicación de origen para ver si hay cambios en la fuente.

  nota

  Si lo omitePollForSourceChanges, de CodePipeline forma predeterminada sondea la ubicación de origen para comprobar si hay cambios en la fuente. Este comportamiento es el mismo que si se incluye PollForSourceChanges y se establece en true.

• false: Si está configurado, CodePipeline no sondea la ubicación de origen para detectar cambios en la fuente. Utilice este ajuste si pretende configurar una regla de CloudWatch eventos para detectar los cambios en la fuente.

Artefactos de entrada

• Número de artefactos: 0

• Descripción: los artefactos de entrada no se aplican a este tipo de acción.

Artefactos de salida

• Número de artefactos: 1

• Descripción: proporciona los artefactos que están disponibles en el bucket de origen configurado para conectarse a la canalización. Los artefactos generados a partir del bucket son los artefactos de salida de la acción de Amazon S3. Los metadatos del objeto Amazon S3 (ETagy el ID de versión) se muestran CodePipeline como la revisión de origen para la ejecución de la canalización activada.

Variables de salida

Cuando se configura, esta acción produce variables a las que se puede hacer referencia mediante la configuración de acción de una acción descendente en la canalización. Esta acción produce variables que se pueden ver como variables de salida, incluso si la acción no tiene un espacio de nombres. Configure una acción con un espacio de nombres para que esas variables estén disponibles para la configuración de las acciones posteriores.

Para obtener más información sobre las variables de CodePipeline, consulteReferencia de variables.

BucketName

El nombre del bucket de Amazon S3 relacionado con el cambio de fuente que activó la canalización.

ETag

La etiqueta de entidad del objeto relacionado con el cambio de código fuente que desencadenó la canalización. ETagEs un MD5 hash del objeto. ETagrefleja solo los cambios en el contenido de un objeto, no sus metadatos.

ObjectKey

El nombre de la clave de objeto de Amazon S3 relacionada con el cambio de fuente que activó la canalización.

VersionId

El ID de versión de la versión del objeto relacionada con el cambio de código fuente que desencadenó la canalización.

Declaración de acciones

YAML

Name: Source
Actions:
  - RunOrder: 1
    OutputArtifacts:
      - Name: SourceArtifact
    ActionTypeId:
      Provider: S3
      Owner: AWS
      Version: '1'
      Category: Source
    Region: us-west-2
    Name: Source
    Configuration:
      S3Bucket: amzn-s3-demo-source-bucket
      S3ObjectKey: my-application.zip
      PollForSourceChanges: 'false'
    InputArtifacts: []

JSON

{
    "Name": "Source",
    "Actions": [
        {
            "RunOrder": 1,
            "OutputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "ActionTypeId": {
                "Provider": "S3",
                "Owner": "AWS",
                "Version": "1",
                "Category": "Source"
            },
            "Region": "us-west-2",
            "Name": "Source",
            "Configuration": {
                "S3Bucket": "amzn-s3-demo-source-bucket",
                "S3ObjectKey": "my-application.zip",
                "PollForSourceChanges": "false"
            },
            "InputArtifacts": []
        }
    ]
},

Véase también

Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta acción.

• Tutorial: Crear una canalización simple (bucket de S3)— Este tutorial proporciona un ejemplo de archivo de especificaciones de la aplicación y de un grupo de implementación y CodeDeploy aplicación. Utilice este tutorial para crear una canalización con una fuente de Amazon S3 que se despliegue en las EC2 instancias de Amazon.