Referencia de acciones de implementación de Amazon S3 - AWS CodePipeline

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 de acciones de implementación de Amazon S3

Utilice una acción de implementación de Amazon S3 para implementar archivos en un bucket de Amazon S3 para alojar o archivar sitios web estáticos. Puede especificar si desea extraer los archivos de implementación antes de subirlos a su bucket.

nota

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

Tipo de acción

  • Categoría: Deploy

  • Propietario: AWS

  • Proveedor: S3

  • Versión: 1

Parámetros de configuración

BucketName

Obligatorio: sí

El nombre del bucket de Amazon S3 en el que se implementan los archivos.

Extract

Obligatorio: sí

Si es verdadero, especifica que los archivos se deben extraer antes de cargarlos. De lo contrario, los archivos de la aplicación permanecen comprimidos para su carga, como en el caso de un sitio web estático alojado. Si es falso, entonces ObjectKey es obligatoria.

ObjectKey

Condicional. Obligatorio si Extract = false

El nombre de la clave del objeto de Amazon S3 que identifica de forma exclusiva el objeto en el bucket de S3.

KMSEncryptionKeyARN

Obligatorio: no

La ARN de la clave de AWS KMS cifrado del bucket de hosts. El parámetro KMSEncryptionKeyARN cifra los artefactos cargados con la AWS KMS key proporcionada. Para una KMS clave, puede usar el ID de la clave, la clave ARN o el aliasARN.

nota

Los alias solo se reconocen en la cuenta que creó la KMS clave. Para las acciones entre cuentas, solo puedes usar el ID de la clave o la clave ARN para identificar la clave. Las acciones entre cuentas implican el uso del rol de la otra cuenta (AccountB), por lo que al especificar el ID de clave se utilizará la clave de la otra cuenta (AccountB).

importante

CodePipeline solo admite claves simétricasKMS. No utilice una KMS clave asimétrica para cifrar los datos de su bucket de S3.

Enlatado ACL

Obligatorio: no

El CannedACL parámetro aplica el valor enlatado especificado ACL a los objetos implementados en Amazon S3. Esto sobrescribe cualquier elemento existente ACL que se haya aplicado al objeto.

CacheControl

Obligatorio: no

El parámetro CacheControl controla el comportamiento del caché de las solicitudes/respuestas para objetos del bucket. Para obtener una lista de valores válidos, consulte el campo de Cache-Controlencabezado para ver HTTP las operaciones. Para introducir varios valores en CacheControl, utilice una coma entre cada valor. Puede añadir un espacio después de cada coma (opcional), como se muestra en este ejemplo para: CLI

"CacheControl": "public, max-age=0, no-transform"

Artefactos de entrada

  • Número de artefactos: 1

  • Descripción: Los archivos para su despliegue o archivado se obtienen del repositorio de origen, se comprimen en un zip y se cargan en él. CodePipeline

Artefactos de salida

  • Número de artefactos: 0

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

Ejemplo de configuración de una acción

En el siguiente ejemplo se muestra la configuración de la acción.

Ejemplo de configuración cuando Extract está establecido en false

En el siguiente ejemplo se muestra la configuración de acción predeterminada cuando la acción se crea con el campo Extract establecido en false.

YAML
Name: Deploy Actions: - Name: Deploy ActionTypeId: Category: Deploy Owner: AWS Provider: S3 Version: '1' RunOrder: 1 Configuration: BucketName: website-bucket Extract: 'false' OutputArtifacts: [] InputArtifacts: - Name: SourceArtifact Region: us-west-2 Namespace: DeployVariables
JSON
{ "Name": "Deploy", "Actions": [ { "Name": "Deploy", "ActionTypeId": { "Category": "Deploy", "Owner": "AWS", "Provider": "S3", "Version": "1" }, "RunOrder": 1, "Configuration": { "BucketName": "website-bucket", "Extract": "false" }, "OutputArtifacts": [], "InputArtifacts": [ { "Name": "SourceArtifact" } ], "Region": "us-west-2", "Namespace": "DeployVariables" } ] },

Ejemplo de configuración cuando Extract está establecido en true

En el siguiente ejemplo se muestra la configuración de acción predeterminada cuando la acción se crea con el campo Extract establecido en true.

YAML
Name: Deploy Actions: - Name: Deploy ActionTypeId: Category: Deploy Owner: AWS Provider: S3 Version: '1' RunOrder: 1 Configuration: BucketName: website-bucket Extract: 'true' ObjectKey: MyWebsite OutputArtifacts: [] InputArtifacts: - Name: SourceArtifact Region: us-west-2 Namespace: DeployVariables
JSON
{ "Name": "Deploy", "Actions": [ { "Name": "Deploy", "ActionTypeId": { "Category": "Deploy", "Owner": "AWS", "Provider": "S3", "Version": "1" }, "RunOrder": 1, "Configuration": { "BucketName": "website-bucket", "Extract": "true", "ObjectKey": "MyWebsite" }, "OutputArtifacts": [], "InputArtifacts": [ { "Name": "SourceArtifact" } ], "Region": "us-west-2", "Namespace": "DeployVariables" } ] },

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