Amazon S3 - AWS CodePipeline

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Amazon S3

Aciona o pipeline quando um novo objeto é carregado no bucket e na chave do objeto.

nota

Ao criar seu bucket de origem, certifique-se de ativar o versionamento no bucket. Se você quiser usar um bucket do Amazon S3 existente, consulteUsar o versionamentoPara habilitar o versionamento em um bucket existente.

Se você usar o console para criar ou editar o pipeline, o CodePipeline criará uma regra do CloudWatch Events que iniciará o pipeline quando ocorrer uma alteração no bucket de origem do S3.

Você já deve ter criado um bucket de origem do Amazon S3 e carregado os arquivos de origem como um único arquivo ZIP antes de conectar o pipeline por meio de uma ação do Amazon S3.

nota

Quando o Amazon S3 é o provedor de origem para o pipeline, é possível compactar o arquivo ou os arquivos de origem em um único .zip e fazer upload do .zip para o bucket de origem. Também é possível fazer upload de um único arquivo descompactado; no entanto, ocorrerão falha nas ações downstream que aguardam um arquivo .zip.

Tipo de ação

  • Categoria: Source

  • Proprietário: AWS

  • Fornecedor:S3

  • Versão:1

Parâmetros de configuração

S3 Bucket

: obrigatório Sim

O nome do bucket do Amazon S3 onde as alterações na origem devem ser detectadas.

S3ObjectKey

: obrigatório Sim

O nome da chave de objeto do Amazon S3 onde as alterações na origem devem ser detectadas.

PollForSourceChanges

: obrigatório Não

PollForSourceChangescontrola se o CodePipeline pesquisa o bucket de origem do Amazon S3 em busca de alterações na origem. Em vez disso, recomendamos usar o CloudWatch Events e o CloudTrail para detectar alterações na origem. Para obter mais informações sobre como configurar o CloudWatch Events, consulteAtualizar os pipelines para o envio de eventos (origem do Amazon S3) (CLI)ouAtualizar os pipelines para o envio de eventos (origem do Amazon S3) (AWS CloudFormationModelo do).

Importante

Se você pretende configurar o CloudWatch Events, deverá definirPollForSourceChangesparafalsepara evitar execuções de pipeline duplicadas.

Os valores válidos para esse parâmetro:

  • true: Se definido, o CodePipeline pesquisará seu local de origem em busca de alterações na origem.

    nota

    Se você omitirPollForSourceChanges, o padrão do CodePipeline é pesquisar seu local de origem em busca de alterações na origem. Esse comportamento será o mesmo quando o PollForSourceChanges estiver incluído e definido como true.

  • false: Se definido, o CodePipeline não pesquisará seu local de origem em busca de alterações na origem. Use essa definição se pretender configurar uma regra do CloudWatch Events para detectar alterações na origem.

Input artifacts (Artefatos de entrada)

  • Número de artefatos: 0

  • Descrição: Os artefatos de entrada não se aplicam a esse tipo de ação.

Artefatos de saída

  • Número de artefatos: 1

  • Descrição: Fornece os artefatos disponíveis no bucket de origem configurado para conectar-se ao pipeline. Os artefatos gerados no bucket são os artefatos de saída para a ação do Amazon S3. Os metadados do objeto do Amazon S3 (ETag e ID da versão) são exibidos no CodePipeline como a revisão de origem para a execução do pipeline acionado.

Variáveis de saída

Quando configurada, essa ação produz variáveis que podem ser referenciadas pela configuração de ação de uma ação downstream no pipeline. Esta ação produz variáveis que podem ser visualizadas como variáveis de saída, mesmo que a ação não tenha um namespace. Configure uma ação com um namespace a fim de disponibilizar as variáveis para a configuração de ações downstream.

Para obter mais informações sobre variáveis no CodePipeline, consulteVariables.

ETag

A tag de entidade do objeto relacionado à alteração na origem que acionou o pipeline. A ETag é um hash MD5 do objeto. A ETag reflete apenas as alterações no conteúdo de um objeto, não em seus metadados.

VersionId

O ID da versão do objeto relacionado à alteração na origem que acionou o pipeline.

Declaração de ação (exemplo do S3)

YAML
Name: Source Actions: - RunOrder: 1 OutputArtifacts: - Name: SourceArtifact ActionTypeId: Provider: S3 Owner: AWS Version: '1' Category: Source Region: us-west-2 Name: Source Configuration: S3Bucket: my-bucket-oregon S3ObjectKey: my-application.zip PollForSourceChanges: 'false' InputArtifacts: []
JSON
{ "Name": "Source", "Actions": [ { "RunOrder": 1, "OutputArtifacts": [ { "Name": "SourceArtifact" } ], "ActionTypeId": { "Provider": "S3", "Owner": "AWS", "Version": "1", "Category": "Source" }, "Region": "us-west-2", "Name": "Source", "Configuration": { "S3Bucket": "my-bucket-oregon", "S3ObjectKey": "my-application.zip", "PollForSourceChanges": "false" }, "InputArtifacts": [] } ] },

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

  • Tutorial: Criar um pipeline simples (bucket do S3)— este tutorial fornece um arquivo de especificação de aplicativo de exemplo e um grupo de aplicativos e implantações do de exemplo. Use este tutorial para criar um pipeline com uma origem do Amazon S3 que é implantado em instâncias do Amazon EC2.