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.
Tópicos
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 deStartPipelineExecution
podem substituir aS3ObjectKey
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 comofalse
.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
comotrue
. -
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
comofalse
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 oPollForSourceChanges
estiver incluído e definido comotrue
. -
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
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: []
Consulte também
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.