Artefatos de entrada e saída

CodePipeline se integra às ferramentas de desenvolvimento para verificar as alterações no código e, em seguida, criar e implantar em todas as etapas do processo de entrega contínua. Artefatos são os arquivos que são trabalhados por ações no pipeline, como arquivos ou pastas com código de aplicação, arquivos de página de índice, scripts, etc. Por exemplo, o artefato de ação de origem do Amazon S3 é um nome de arquivo (ou caminho de arquivo) em que os arquivos de código-fonte do aplicativo são fornecidos para a ação de origem do pipeline, e os arquivos geralmente são fornecidos como um arquivo ZIP, como o seguinte exemplo de nome de artefato: _Windows.zip. SampleApp O artefato de saída para a ação de origem, os arquivos de código-fonte da aplicação, são o artefato de saída da ação de origem e também o artefato de entrada para a próxima ação, como uma ação de compilação. Como outro exemplo, uma ação de compilação pode executar comandos que compilam o código-fonte da aplicação para um artefato de entrada, que são os arquivos de código-fonte da aplicação da ação de origem. Consulte a página de referência da configuração da ação para uma ação específica para obter detalhes sobre os parâmetros do artefato, como AWS CodeBuild para a CodeBuild ação.

As ações usam artefatos de entrada e saída que são armazenados no bucket de artefatos do Amazon S3 que você escolheu ao criar o pipeline. CodePipeline compacta e transfere os arquivos para artefatos de entrada ou saída, conforme apropriado para o tipo de ação no estágio.

nota

O bucket de artefatos não é o mesmo usado como local do arquivo de origem de um pipeline em que a ação de origem escolhida é o S3.

Por exemplo: .

1. CodePipeline aciona a execução do pipeline quando há uma confirmação no repositório de origem, fornecendo o artefato de saída (quaisquer arquivos a serem criados) do estágio Fonte.

2. O artefato de saída (todos os arquivos a serem compilados) do estágio anterior é processado como um artefato de entrada para o estágio de Compilação. Um artefato de saída (o aplicativo compilado) do estágio de Compilação pode ser um aplicativo atualizado ou uma imagem do Docker atualizada criada para um contêiner.

3. O artefato de saída do estágio anterior (a aplicação criada) é processado como um artefato de entrada para o estágio de Implantação, como ambientes de preparação ou de produção na Nuvem AWS. Você pode implantar aplicativos para uma frota de implantação ou pode implantar aplicativos baseados em contêiner para tarefas em execução nos clusters do ECS.

Ao criar ou editar uma ação, você designa o artefato ou os artefatos de entrada e de saída para a ação. Neste exemplo de um pipeline de dois estágios, com um estágio de Origem e de Implantação, em Editar ação, escolha o nome do artefato da ação de origem para o artefato de entrada da ação de implantação.

• Quando você usa o console para criar seu primeiro pipeline, CodePipeline cria um bucket Amazon S3 no mesmo Conta da AWS e armazena itens Região da AWS para todos os pipelines. Toda vez que você usa o console para criar outro pipeline nessa região, CodePipeline cria uma pasta para esse pipeline no bucket. Ele usará essa pasta para armazenar os artefatos do pipeline conforme a execução do processo de lançamento automatizado. Esse bucket é chamado de codepipeline-region-12345EXAMPLE, em que region é a região da AWS em que o pipeline foi criado e 12345EXAMPLE é um número aleatório de 12 dígitos que garante que o nome do bucket seja exclusivo.

  nota

  Se você já tem um bucket começando com codepipeline- region - na região em que você está criando o pipeline, use-o CodePipeline como o bucket padrão. Também segue a ordem lexicográfica; por exemplo, codepipeline-region-abcexample é escolhido antes de codepipeline-region-defexample.

  CodePipeline trunca os nomes dos artefatos, o que pode fazer com que alguns nomes de buckets pareçam semelhantes. Mesmo que o nome do artefato pareça estar truncado, CodePipeline mapeia para o compartimento de artefatos de uma forma que não seja afetada por artefatos com nomes truncados. O pipeline pode funcionar normalmente. Isso não é um problema com a pasta ou os artefatos. Há um limite de 100 caracteres para nomes de pipelines. Embora o nome da pasta do artefato possa parecer reduzido, ele ainda é exclusivo para o pipeline.

  Ao criar ou editar um pipeline, é necessário ter um bucket de artefato na Conta da AWS e Região da AWS do pipeline e ter um bucket de artefato por região em que você planeja executar uma ação. Se você usar o console para criar um pipeline ou ações entre regiões, buckets de artefatos padrão serão configurados pelo CodePipeline nas regiões em que se encontram as ações.

  Se usar a AWS CLI para criar um pipeline, você poderá armazenar os artefatos desse pipeline em qualquer bucket do Amazon S3, desde que esse bucket esteja na mesma Conta da AWS e Região da AWS que o pipeline. É possível fazer isso caso se preocupe em não exceder os limites dos buckets do Amazon S3 permitidos para a conta. Se você usar a AWS CLI para criar ou editar um pipeline e adicionar uma ação entre regiões (uma ação com um provedor da AWS em uma região diferente da região do pipeline), será necessário fornecer um bucket de artefato para cada região adicional onde você pretende executar uma ação.

• Cada ação tem um tipo. Dependendo do tipo, a ação poderá ter um destes itens ou os dois:

  • Um artefato de entrada, que é o que ele utiliza ou no qual trabalha durante o curso de execução da ação.

  • Um artefato de saída, que é o resultado da ação.

  Todos os artefatos de saída no pipeline devem ter um nome exclusivo. Cada artefato de entrada de uma ação deve corresponder ao artefato de saída de uma ação anterior no pipeline, não importa se essa ação for imediatamente anterior à ação em um estágio ou for executada em um estágio que ocorreu vários estágios antes.

  Mais de uma ação pode trabalhar em um artefato.