Como trabalhar com artefatos no TeamCity

Qualquer arquivo produzido pelo seu build é um artefato em potencial, como um aplicativo empacotado num arquivo .jar ou .zip. Depois que o build terminar de ser executado no agente de build, o TeamCity pegará esses arquivos e os carregará na UI do servidor TeamCity, onde você poderá acessá-los e revisá-los.

Saiba mais sobre artefatos de build na nossa documentação.

Para obter os dados produzidos pelo seu build, acesse Edit Configuration.

Na aba General Settings, você encontrará um campo de entrada chamado Artifact Paths.

O que são caminhos de artefatos?

No TeamCity, caminhos de artefatos referem-se aos locais onde os artefatos de build são armazenados depois de um processo de build bem-sucedido. Artefatos são arquivos de saída, binários e outros resultados importantes gerados durante o build. Caminhos de artefatos especificam a estrutura de diretórios ou pastas, dentro do servidor do TeamCity, onde esses artefatos são publicados e podem ser acessados.

Neste exemplo, sabemos que nosso build cria um subdiretório de artefatos, e queremos disponibilizar todos os arquivos desse subdiretório. Especifique o caminho do artefato no campo e clique em Save.

Onde são armazenados os artefatos?

O TeamCity incorpora um local de armazenamento de artefatos. Você também pode conectar um armazenamento externo de artefatos para trabalhar com o TeamCity. No momento, o TeamCity oferece suporte ao Amazon S3, Azure Artifact Storage e Google Cloud Artifact Storage.

Agora, depois de executarmos o build, poderemos ver algumas alterações. Anteriormente, o ícone de artefato estava esmaecido, o que significa que nenhum artefato identificado pelo usuário estava nesse build.

O ícone azul claro indica que o TeamCity descobriu e armazenou com sucesso os artefatos para esse build. Quando clicamos no ícone azul, podemos ver que existem dois arquivos armazenados como artefatos: um log de aplicativo e uma gravação do Selenium.

Você também pode clicar em cada arquivo separadamente e revisá-lo.

Os dados dos agentes de build são transferidos ao servidor do TeamCity ou, mais especificamente, a um armazenamento específico. O armazenamento pode estar na nuvem, localmente ou em qualquer lugar que você especificar.

Esses dados não só estão disponíveis no servidor do TeamCity, como também estão disponíveis e prontos para serem transmitidos por uma cadeia de builds ou várias configurações de build. Por exemplo, se uma tarefa de implementação precisar de um arquivo .jar de uma tarefa de build anterior, esse arquivo poderá ser transmitido com a ajuda de artefatos.

Como posso copiar artefatos?

No TeamCity, você pode copiar artefatos de um build para outro usando o recurso "Artifact Dependency". Para isso, você precisa configurar os caminhos dos artefatos no build de origem, configurar as dependências dos artefatos no build de destino e verificar a cópia dos artefatos. Ao configurar as dependências dos artefatos, você cria uma associação entre os builds no TeamCity, permitindo a transferência transparente de artefatos de um build para outro.

Pronto para começar a configurar artefatos? Confira nossa documentação e fique à vontade para entrar em contato caso você tenha alguma dúvida.