Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Referencia sobre la acción de origen de Amazon S3
Una acción de origen activa la canalización cuando se carga un objeto nuevo en el depósito y la clave de objeto configurados.
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 acción de implementación de Amazon S3.
Antes de conectar la canalización, cree un bucket de código fuente de Amazon S3, active el control de versiones y cargue los archivos fuente como un único archivo ZIP.
Puede crear un depósito nuevo en Amazon S3 o seleccionar un depósito de Amazon S3 existente para utilizarlo como ubicación de origen de los archivos de la aplicación. Para obtener más información sobre cómo habilitar el control de versiones, consulte Uso del control de versiones en la Guía del usuario de Amazon S3.
Cuando Amazon S3 es el proveedor de origen de su canalización, puede comprimir el archivo o los archivos fuente en un solo archivo.zip y cargar el .zip en su bucket de código fuente. También puede cargar un único archivo descomprimido; sin embargo, las acciones posteriores que prevean un archivo.zip fallarán.
Si usa la consola para crear o editar su canalización, CodePipeline crea una EventBridge regla que la inicie cuando se produzca un cambio en el bucket de código fuente de Amazon S3.
También puede crear una anulación de fuente mediante la entrada de transformación de entrada EventBridge para utilizar la entrada revisionValue in en su evento de canalización, donde revisionValue se deriva de la variable del evento de origen para su clave de objeto, confirmación o ID de imagen. Para obtener más información, consulte el paso opcional para la entrada de transformación de entrada que se incluye en los procedimientos que se indican a continuación. Conexión a acciones de origen de Amazon S3 con un origen habilitado para eventos
Temas
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.
- S3ObjectKey
-
Obligatorio: sí
El nombre de la clave de objeto de Amazon S3 en la que se van a detectar los cambios de origen.
- AllowOverrideForS3ObjectKey
-
Obligatorio: no
AllowOverrideForS3ObjectKeycontrola si las anulaciones de origen deStartPipelineExecutionpueden anular lasS3ObjectKeyya configuradas en la acción de origen. Para obtener más información sobre las anulaciones de origen con la clave del objeto de S3, consulte Iniciar una canalización con una anulación de revisión de código fuente.importante
Si lo omite
AllowOverrideForS3ObjectKey, CodePipeline establece este parámetro en de forma predeterminada para anular el S3 ObjectKey en la acción de origen.falseLos valores válidos para este parámetro son:
-
true: si se establece, la clave del objeto de S3 preconfigurada se puede anular mediante anulaciones de revisiones de origen durante la ejecución de una canalización.nota
Si quiere permitir que todos CodePipeline los usuarios puedan anular la clave de objeto de S3 preconfigurada al iniciar una nueva ejecución de canalización, debe configurarla en.
AllowOverrideForS3ObjectKeytrue -
false:Si se establece, no CodePipeline permitirá anular la clave de objeto de S3 mediante anulaciones de revisión de origen. Este también es el valor predeterminado para 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 los canales de sondeo con una fuente y un CloudTrail seguimiento (CLI) de S3 oMigre los canales de sondeo con una fuente y un seguimiento de CloudTrail S3 (CloudFormation plantilla).importante
Si tiene intención de configurar CloudWatch eventos, debe configurarlo
PollForSourceChangesfalsepara 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 omite
PollForSourceChanges, 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 incluyePollForSourceChangesy se establece entrue. -
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 (ETag e 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 incluidas en CodePipeline, consulteReferencia de variables.
- BucketName
-
El nombre del bucket de Amazon S3 relacionado con el cambio de origen que desencadenó la canalización.
- ETag
-
La etiqueta de entidad del objeto relacionado con el cambio de código fuente que desencadenó la canalización. El ETag es un hash MD5 del objeto. ETag solo refleja los cambios en el contenido de un objeto, no los metadatos.
- ObjectKey
-
El nombre de la clave del objeto de Amazon S3 relacionado con el cambio de origen que desencadenó 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.
Permisos del rol de servicio: acción de origen de S3
Para la compatibilidad con la acción de origen de S3, agregue lo siguiente a su declaración de política:
Declaración de acciones
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 CodeDeploy aplicación y de un grupo de implementación. Utilice este tutorial para crear una canalización con un origen de Amazon S3 que se implementa en instancias de Amazon EC2.