Referência de 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 em CodePipeline 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 em CodePipeline, consulte. Referência de 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

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

nota

Os aliases são reconhecidos somente na conta que criou a KMS chave. Para ações entre contas, você só pode usar o ID da chave ou ARN a 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

CodePipeline suporta apenas KMS teclas simétricas. Não use uma KMS chave assimétrica para criptografar os dados em seu bucket do S3.

Enlatado ACL

Obrigatório: Não

O CannedACL parâmetro aplica o padrão especificado ACLaos objetos implantados no Amazon S3. Isso substitui qualquer existente ACL que tenha sido aplicado 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 Cache-Controlcabeçalho para HTTP operações. Para inserir vários valores em CacheControl, use uma vírgula entre cada valor. Você pode adicionar um espaço após cada vírgula (opcional), conforme mostrado neste exemplo para: 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 do repositório de origem, compactados e enviados por. 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. Você baixa arquivos de amostra, carrega os arquivos no seu CodeCommit repositório, cria seu bucket S3 e configura seu bucket para hospedagem. Em seguida, você usa o CodePipeline console para criar seu pipeline e especificar uma configuração de implantação do Amazon S3.

• Referência de 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 em. CodePipeline