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 desencadena la canalización cuando se carga un nuevo objeto en el bucket 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 fuente de Amazon S3, habilite el control de versiones y cargue los archivos fuente como un único archivo ZIP.
Puede crear un nuevo bucket en Amazon S3 o seleccionar un bucket de Amazon S3 existente para usarlo como ubicación de origen de los archivos de su aplicación. Para obtener más información sobre cómo habilitar el control de versiones, consulte el uso del control de versiones en la guía del usuario de Amazon S3.
Si Amazon S3 es el proveedor de código fuente de su canalización, puede comprimir el archivo o los archivos fuente en un único archivo .zip y subirlo a su bucket de código fuente. También puede cargar un único archivo descomprimido; sin embargo, las acciones posteriores que esperen un archivo .zip fallarán.
Si usa la consola para crear o editar la canalización, CodePipeline cree una EventBridge regla que inicie la canalización cuando se produzca un cambio en el bucket de origen de Amazon S3.
También puede crear una anulación de fuente utilizando la entrada de transformación de entrada EventBridge para usar la entrada revisionValue en el evento de canalización, donde revisionValue se deriva de la variable de evento de origen de su clave de objeto, confirmación o ID de imagen. Para obtener más información, consulta 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 omites
AllowOverrideForS3ObjectKey, se establece de CodePipeline forma predeterminada la posibilidad de anular el S3 ObjectKey en la acción de origen configurando este parámetro en.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 a todos CodePipeline los usuarios la posibilidad de anular la clave de objeto de S3 preconfigurada al iniciar una nueva ejecución en canalización, debe configurarla en.
AllowOverrideForS3ObjectKeytrue -
false:Si se establece, no CodePipeline permitirá anular la clave de objetos de S3 mediante anulaciones de revisión del código fuente. 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 para ver si hay cambios en el código fuente. En su lugar, le recomendamos que utilice CloudWatch Events and CloudTrail para detectar los cambios en el origen. Para obtener más información sobre la configuración de CloudWatch eventos, consulte Migre las canalizaciones de sondeo con una fuente y un CloudTrail registro (CLI) de S3 oMigre las canalizaciones de sondeo con una fuente y un CloudTrail registro de S3 (CloudFormation plantilla).importante
Si tiene intención de configurar CloudWatch eventos, debe configurarlos
PollForSourceChangesparafalseevitar que se dupliquen las ejecuciones en canalización.Los valores válidos para este parámetro son:
-
true: Si se establece, CodePipeline sondea la ubicación de origen para ver si hay cambios en el origen.nota
Si lo omites
PollForSourceChanges, de CodePipeline forma predeterminada sondea tu ubicación de origen para ver si hay cambios en el origen. Este comportamiento es el mismo que si se incluyePollForSourceChangesy se establece entrue. -
false: Si se establece, CodePipeline no sondea la ubicación de origen para ver si hay cambios en el origen. Utilice esta configuración si desea configurar una regla de CloudWatch eventos para detectar los cambios en el origen.
-
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 de Amazon S3 (ETag e ID de versión) se muestran CodePipeline como la revisión de la fuente para la ejecución del proceso desencadenado.
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 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 AppSpec archivo de ejemplo y un grupo de CodeDeploy aplicaciones y despliegues de ejemplo. Utilice este tutorial para crear una canalización con un origen de Amazon S3 que se implementa en instancias de Amazon EC2.