Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Referência da ação de origem do Amazon S3

Modo de foco
Referência da ação de origem do 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á.

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á.

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

nota

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

Você pode criar um bucket do Amazon S3 para usar como local de origem dos arquivos da sua aplicação.

nota

Ao criar seu bucket de origem, certifique-se de ativar o versionamento no bucket. Para usar um bucket existente do Amazon S3, consulte Usar o versionamento para 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 do pipeline, é possível compactar o(s) arquivo(s) 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 em que as alterações na origem devem ser detectadas.

S3ObjectKey

Obrigatório: Sim

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

AllowOverrideForS3ObjectKey

Obrigatório: Não

AllowOverrideForS3ObjectKey controla se as substituições de origem de StartPipelineExecution podem substituir a S3ObjectKey que já está configurada na ação de origem. Para ter mais informações sobre substituições de origem com a chave de objeto do S3, consulte Iniciar um pipeline com uma substituição da revisão de origem.

Importante

Se você omitir AllowOverrideForS3ObjectKey, o CodePipeline usará como padrão a capacidade de substituir S3 ObjectKey na ação de origem definindo esse parâmetro como false.

Os valores válidos para esse parâmetro:

  • true: se definido, a chave de objeto do S3 pré-configurada poderá ser substituída por revisões de origem durante a execução de um pipeline.

    nota

    Se você pretende permitir que todos os usuários do CodePipeline substituam a chave de objeto do S3 pré-configurada ao iniciar uma nova execução de pipeline, defina AllowOverrideForS3ObjectKey como true.

  • false:

    Se definido, o CodePipeline não permitirá que a chave de objeto do S3 seja substituída por revisões de origem. Esse também é o valor padrão para este parâmetro.

PollForSourceChanges

Obrigatório: Não

PollForSourceChanges determina se o CodePipeline pesquisará o bucket de origem do Amazon S3 em busca de alterações na origem. Em vez disso, recomendamos o uso do CloudWatch Events e do CloudTrail para detectar alterações na origem. Para obter mais informações sobre a configuração do CloudWatch Events, consulte Migre os pipelines de votação com uma fonte e trilha CloudTrail (CLI) do S3 ou Migre os pipelines de votação com uma fonte e CloudTrail uma trilha do S3 (modelo)AWS CloudFormation.

Importante

Se você pretende configurar o CloudWatch Events, defina PollForSourceChanges como false para evitar execuções duplicadas do pipeline.

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ê omitir PollForSourceChanges, o CodePipeline assume como padrão a pesquisa do 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á o local de origem em busca de alterações na origem. Use essa configuração caso pretenda 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 de 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, consulte Referência de variáveis.

BucketName

O nome do bucket do Amazon S3 relacionado à alteração de origem que acionou o pipeline.

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.

ObjectKey

O nome da chave de objeto do Amazon S3 relacionada à alteração de origem que acionou o pipeline.

VersionId

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

Declaração de ação

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: amzn-s3-demo-source-bucket 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": "amzn-s3-demo-source-bucket", "S3ObjectKey": "my-application.zip", "PollForSourceChanges": "false" }, "InputArtifacts": [] } ] },
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: amzn-s3-demo-source-bucket 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 aplicação de exemplo e um grupo de aplicação e implantação de exemplo do CodeDeploy. Use este tutorial para criar um pipeline com uma origem do Amazon S3 implantada em instâncias do Amazon EC2.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.