Ação de implantação do Amazon S3

Você usa uma ação de implantação do Amazon S3 para implantar arquivos em um bucket do Amazon S3 para hospedagem ou arquivamento de sites estáticos. Você pode especificar se deseja extrair os arquivos de implantação antes de fazer upload para seu bucket.

nota

Este tópico de referência descreve a ação de implantação do Amazon S3 para CodePipeline, em que a plataforma de implantação é um bucket do Amazon S3 configurado para hospedagem. Para obter informações de referência sobre a ação de origem do Amazon S3 no CodePipeline, consulte Ação de origem do Amazon S3.

Tipo de ação

• Categoria: Deploy

• Proprietário: AWS

• Fornecedor: S3

• Versão: 1

Parâmetros de configuração

BucketName

Obrigatório: Sim

O nome do bucket do Amazon S3 em que os arquivos serão implantados.

Extract

Obrigatório: Sim

Se for true, especifica que os arquivos serão extraídos antes do upload. Caso contrário, os arquivos da aplicação permanecerão compactados para upload, como acontece no caso de um site estático hospedado. Se for false, ObjectKey será obrigatório.

ObjectKey

Condicional. Obrigatório se Extract = falso

O nome da chave de objeto do Amazon S3 que identifica exclusivamente o objeto no bucket do S3.

KMSEncryptionKeyARN

Obrigatório: não

O ARN da chave de criptografia do AWS KMS para o bucket do host. O parâmetro KMSEncryptionKeyARN criptografa os artefatos carregados com a AWS KMS key fornecida. Para uma chave do KMS, você pode usar o ID da chave, o ARN da chave ou o ARN do alias.

nota

Os aliases são reconhecidos apenas na conta que criou a chave do KMS. Para ações entre contas, você só pode usar o ID ou o ARN da chave para identificar a chave. As ações entre contas envolvem o uso do perfil da outra conta (AccountB), portanto, a especificação do ID da chave usará a chave da outra conta (AccountB).

Importante

O CodePipeline só oferece suporte a chaves simétricas do KMS. Não use uma chave assimétrica do KMS para criptografar os dados no bucket do S3.

CannedACL

Obrigatório: não

O parâmetro CannedACL aplica a ACL pré-configurada especificada aos objetos implantados no Amazon S3. Isso substitui todas as ACLs existentes que foram aplicadas ao objeto.

CacheControl

Obrigatório: não

O parâmetro CacheControl controla o comportamento do armazenamento em cache de solicitações/respostas de objetos no bucket. Para obter uma lista de valores válidos, consulte o campo de cabeçalho Cache-Control para operações HTTP. Para inserir vários valores em CacheControl, use uma vírgula entre cada valor. É possível adicionar um espaço após cada vírgula (opcional), conforme mostrado neste exemplo para a CLI:

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

Input artifacts (Artefatos de entrada)

• Número de artefatos: 1

• Descrição: os arquivos para implantação ou arquivamento são obtidos no repositório de origem, compactados e carregados pelo CodePipeline.

Artefatos de saída

• Número de artefatos: 0

• Descrição: os artefatos de saída não se aplicam a esse tipo de ação.

Exemplo de configuração da ação

O exemplo a seguir mostra exemplos da configuração da ação.

Exemplo de configuração quando Extract é definido como false

O exemplo a seguir mostra a configuração de ação padrão quando a ação é criada com o campo Extract definido como 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"
        }
    ]
},

Exemplo de configuração quando Extract é definido como true

O exemplo a seguir mostra a configuração de ação padrão quando a ação é criada com o campo Extract definido como 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"
        }
    ]
},

Consulte também

Os recursos relacionados a seguir podem ajudar você à medida que trabalha com esta ação.

• Tutorial: Criar um pipeline que usa o Amazon S3 como um provedor de implantação: este tutorial mostra dois exemplos de criação de um pipeline com uma ação de implantação do S3. Faça download dos arquivos de exemplo, carregue os arquivos no repositório do CodeCommit, crie o bucket do S3 e configure o bucket para hospedagem. Depois, use o console do CodePipeline para criar o pipeline e especificar uma configuração de implantação do Amazon S3.

• Ação de origem do Amazon S3: essa referência de ação fornece informações de referência e exemplos para ações de origem do Amazon S3 no CodePipeline.