Liberar artefatos e fontes de artefato

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Observação

Em Microsoft Team Foundation Server (TFS) 2018 e versões anteriores, pipelines de build e versão são chamados de definições, execuções são chamadas de builds, conexões de serviço são chamadas de pontos de extremidade de serviço, estágios são chamados de ambientes e trabalhos são chamados de fases.

Observação

Este tópico aborda pipelines de lançamento clássicos. Para entender artefatos em pipelines YAML, consulte artefatos.

Uma versão é uma coleção de artefatos em seus processos de CI/CD DevOps. Um artefato é um componente implantável de seu aplicativo. Azure Pipelines pode implantar artefatos produzidos por uma ampla gama de fontes de artefatos e armazenados em diferentes tipos de repositórios de artefatos.

Ao criar um pipeline de lançamento, você vincula as fontes de artefato apropriadas ao pipeline de lançamento. Por exemplo, você pode vincular um pipeline de build Azure Pipelines ou um projeto Jenkins ao pipeline de lançamento.

Ao criar uma versão, especifique a versão exata dessas fontes de artefato; por exemplo, o número de um build proveniente de Azure Pipelines ou a versão de um build proveniente de um projeto Jenkins.

Depois que uma versão é criada, você não pode alterar essas versões. Uma versão é fundamentalmente definida pelos artefatos com versão que compõem a versão. Ao implantar a versão em vários estágios, você implantará e validará os mesmos artefatos em todos os estágios.

Um único pipeline de versão pode ser vinculado a várias fontes de artefato, das quais uma é a fonte primária. Nesse caso, ao criar uma versão, você especifica versões individuais para cada uma dessas fontes.

Artifacts in a pipeline and release

Artifacts são centrais para vários recursos no Azure Pipelines. Alguns dos recursos que dependem da vinculação de artefatos a um pipeline de lançamento são:

  • Liberações de gatilho automático. Você pode configurar novas versões a serem criadas automaticamente sempre que uma nova versão de um artefato for produzida. Para obter mais informações, consulte gatilhos de implantação contínua. Observe que a capacidade de criar versões automaticamente está disponível apenas para algumas fontes de artefato.

  • Condições de gatilho. Você pode configurar uma versão a ser criada automaticamente ou a implantação de uma versão em um estágio a ser disparada automaticamente, quando apenas condições específicas nos artefatos forem atendidas. Por exemplo, você pode configurar versões a serem criadas automaticamente somente quando um novo build é produzido de um determinado branch.

  • Versões do artefato. Você pode configurar uma versão para usar automaticamente uma versão específica dos artefatos de build, para sempre usar a versão mais recente ou para permitir que você especifique a versão quando a versão for criada.

  • Variáveis de artefato. Cada artefato que faz parte de uma versão tem metadados associados a ele, expostos a tarefas por meio de variáveis. Esses metadados incluem o número de versão do artefato, o branch de código do qual o artefato foi produzido (no caso de artefatos de código-fonte ou build), o pipeline que produziu o artefato (no caso de artefatos de build) e muito mais. Essas informações podem ser acessadas nas tarefas de implantação. Para obter mais informações, consulte variáveis artifact.

  • Itens de trabalho e confirmações. Os itens de trabalho ou confirmações que fazem parte de uma versão são computados a partir das versões dos artefatos. Por exemplo, cada build em Azure Pipelines está associado a um conjunto de itens de trabalho e confirmações. Os itens de trabalho ou confirmações em uma versão são calculados como a união de todos os itens de trabalho e confirmações de todos os builds entre a versão atual e a versão anterior. Observe que Azure Pipelines atualmente é capaz de calcular itens de trabalho e confirmações para apenas determinadas fontes de artefato.

  • Download do artefato. Sempre que uma versão é implantada em um estágio, por padrão, Azure Pipelines baixa automaticamente todos os artefatos nessa versão para o agente em que o trabalho de implantação é executado. O procedimento para baixar artefatos depende do tipo de artefato. Por exemplo, Azure Pipelines artefatos são baixados usando um algoritmo que baixa vários arquivos em paralelo. Os artefatos git são baixados usando a funcionalidade da biblioteca Git. Para obter mais informações, consulte o download do Artefato.

Fontes de artefato

Há vários tipos de ferramentas que você pode usar no processo de ciclo de vida do aplicativo para produzir ou armazenar artefatos. Por exemplo, você pode usar sistemas de integração contínua, como Azure Pipelines, Jenkins ou TeamCity, para produzir artefatos. Você também pode usar sistemas de controle de versão, como Git ou TFVC, para armazenar seus artefatos. Ou você pode usar repositórios como Azure Artifacts ou um repositório NuGet para armazenar seus artefatos. Você pode configurar Azure Pipelines para implantar artefatos de todas essas fontes.

Por padrão, uma versão criada a partir do pipeline de lançamento usará a versão mais recente dos artefatos. No momento da vinculação de uma fonte de artefato a um pipeline de lançamento, você pode alterar esse comportamento selecionando uma das opções para usar o build mais recente de um branch específico especificando as marcas, uma versão específica ou permitir que o usuário especifique a versão quando a versão for criada a partir do pipeline.

Adding an artifact

Se você vincular mais de um conjunto de artefatos, poderá especificar qual é o primário (padrão).

Selecting a default version option

Importante

Os itens de lista suspensa Artifacts Default version dependem da repository type definição de build vinculada.

  • As seguintes opções são compatíveis com todos os tipos de repositório: Specify at the time of release creation, Specific versione Latest.

  • Latest from a specific branch with tagse Latest from the build pipeline default branch with tags as opções são compatíveis com os seguintes tipos de repositório: TfsGit, GitHub, e BitbucketGitHubEnterprise.

  • Latest from the build pipeline default branch with tags não há suporte para XAML definições de build.

As seções a seguir descrevem como trabalhar com os diferentes tipos de fontes de artefato.

Fontes de artefato – Azure Pipelines

Você pode vincular um pipeline de lançamento a qualquer um dos pipelines de build na coleção de projetos Azure Pipelines ou TFS.

Observação

Você deve incluir uma tarefa Publicar Artifacts no pipeline de build. Para pipelines de build yaml, um artefato com a queda de nome é publicado implicitamente.

Algumas das diferenças nos recursos entre diferentes versões do TFS e Azure Pipelines são:

  • TFS 2015: você pode vincular pipelines de build somente do mesmo projeto de sua coleção. Você pode vincular várias definições, mas não pode especificar versões padrão. Você pode configurar um gatilho de implantação contínua em apenas uma das definições. Quando vários pipelines de build são vinculados, os builds mais recentes de todas as outras definições são usados, juntamente com o build que desencadeou a criação da versão.

  • TFS 2017 e mais recente e Azure Pipelines: você pode vincular pipelines de build de qualquer um dos projetos em Azure Pipelines ou TFS. Você pode vincular vários pipelines de build e especificar valores padrão para cada um deles. Você pode configurar gatilhos de implantação contínua em várias fontes de build. Quando qualquer um dos builds for concluído, ele disparará a criação de uma versão.

Os seguintes recursos estão disponíveis ao usar Azure Pipelines fontes:

Recurso Comportamento com fontes Azure Pipelines
Versões de gatilho automático Novas versões podem ser criadas automaticamente quando novos builds (incluindo builds XAML) são produzidos. Consulte a Implantação Contínua para obter detalhes. Você não precisa configurar nada dentro do pipeline de build. Consulte as anotações acima para obter diferenças entre a versão do TFS.
Variáveis de artefato Há suporte para várias variáveis de artefato para builds de Azure Pipelines.
Itens de trabalho e confirmações Azure Pipelines integra-se a itens de trabalho no TFS e Azure Pipelines. Esses itens de trabalho também são mostrados nos detalhes das versões. Azure Pipelines integra-se a vários sistemas de controle de versão, como TFVC e Git, GitHub, Subversion e outros repositórios Git. Azure Pipelines mostra as confirmações somente quando o build é produzido a partir do código-fonte no TFVC ou git.
Download do artefato Por padrão, os artefatos de build são baixados para o agente. Você pode configurar uma opção no estágio para ignorar o download de artefatos.
Seção de implantação no build O resumo da compilação inclui uma seção Implantação , que lista todos os estágios para os quais o build foi implantado.

Por padrão, as versões são executadas com um escopo de autorização de trabalho no nível da coleção. Isso significa que as versões podem acessar recursos em todos os projetos da organização (ou coleção para Azure DevOps Server). Isso é útil ao vincular artefatos de build de outros projetos. Você pode habilitar o escopo de autorização de trabalho limite para o projeto atual para pipelines de lançamento nas configurações do projeto para restringir o acesso a artefatos para versões em um projeto.

Para definir o escopo de autorização de trabalho para a organização:

  • Navegue até a página de configurações da organização no Azure DevOps interface do usuário.
  • Selecione Configurações em Pipelines.
  • Ative o escopo de autorização de trabalho limite de alternância para o projeto atual para pipelines de lançamento para limitar o escopo ao projeto atual. Essa é a configuração recomendada, pois melhora a segurança para seus pipelines.

Para definir o escopo de autorização de trabalho para um projeto específico:

  • Navegue até a página de configurações do projeto na interface do usuário Azure DevOps.
  • Selecione Configurações em Pipelines.
  • Ative o escopo de autorização de limite de alternância para o projeto atual para limitar o escopo ao projeto. Essa é a configuração recomendada, pois melhora a segurança para seus pipelines.

Observação

Se o escopo estiver definido como projeto no nível da organização, você não poderá alterar o escopo em cada projeto.

Todos os trabalhos em versões são executados com o escopo de autorização de trabalho definido como coleção. Em outras palavras, esses trabalhos têm acesso a recursos em todos os projetos em sua coleção de projetos.

Fontes de artefato – controle de versão

Há cenários em que talvez você queira consumir artefatos armazenados em um sistema de controle de versão diretamente, sem passá-los por um pipeline de build. Por exemplo:

  • Você está desenvolvendo um PHP ou um aplicativo JavaScript que não requer um pipeline de build explícito.

  • Você gerencia configurações para vários estágios em repositórios de controle de versão diferentes e deseja consumir esses arquivos de configuração diretamente do controle de versão como parte do pipeline de implantação.

  • Você gerencia sua infraestrutura e configuração como código (como modelos de Resource Manager do Azure) e deseja gerenciar esses arquivos em um repositório de controle de versão.

Como você pode configurar várias fontes de artefato em um único pipeline de lançamento, você pode vincular um pipeline de build que produz os binários do aplicativo, bem como um repositório de controle de versão que armazena os arquivos de configuração no mesmo pipeline e usar os dois conjuntos de artefatos juntos durante a implantação.

Azure Pipelines integra-se com repositórios TFVC (Controle de Versão do Team Foundation), repositórios Git e repositórios GitHub.

Você pode vincular um pipeline de lançamento a qualquer um dos repositórios Git ou TFVC em qualquer um dos projetos em sua coleção (você precisará de acesso de leitura a esses repositórios). Nenhuma configuração adicional é necessária ao implantar artefatos de controle de versão na mesma coleção.

Ao vincular um repositório Git ou GitHub e selecionar um branch, você pode editar as propriedades padrão dos tipos de artefato depois que o artefato for salvo. Isso é particularmente útil em cenários em que o branch para a versão estável do artefato é alterado e as versões de entrega contínuas devem usar esse branch para obter versões mais recentes do artefato. Você também pode especificar detalhes do check-out, como se submódulos de checkout e arquivos rastreados por LFS e a profundidade superficial de busca.

Ao vincular uma ramificação do TFVC, você pode especificar o conjunto de alterações a ser implantado ao criar uma versão.

Os seguintes recursos estão disponíveis ao usar fontes de TFVC, Git e GitHub:

Recurso Comportamento com fontes de TFVC, Git e GitHub
Versões de gatilho automático Você pode configurar um gatilho de implantação contínua para envios por push para o repositório em um pipeline de lançamento. Isso pode disparar automaticamente uma versão quando uma nova confirmação é feita em um repositório. Consulte Gatilhos.
Variáveis de artefato Há suporte para várias variáveis de artefato para fontes de controle de versão.
Itens de trabalho e confirmações Azure Pipelines não pode mostrar itens de trabalho ou confirmações associadas a versões ao usar artefatos de controle de versão.
Download do artefato Por padrão, os artefatos de controle de versão são baixados para o agente. Você pode configurar uma opção no estágio para ignorar o download de artefatos.

Por padrão, as versões são executadas com um escopo de autorização de trabalho no nível da coleção. Isso significa que as versões podem acessar todos os repositórios na organização (ou coleção para Azure DevOps Server). Você pode habilitar o escopo de autorização de trabalho limite para o projeto atual para pipelines de lançamento nas configurações do projeto para restringir o acesso a artefatos para versões em um projeto.

Fontes de artefato - Jenkins

Para consumir artefatos jenkins, você deve criar uma conexão de serviço com credenciais para se conectar ao servidor Jenkins. Para obter mais informações, consulte conexões de serviço e conexão de serviço jenkins. Em seguida, você pode vincular um projeto jenkins a um pipeline de lançamento. O projeto Jenkins deve ser configurado com uma ação pós-build para publicar os artefatos.

Os seguintes recursos estão disponíveis ao usar fontes jenkins:

Recurso Comportamento com fontes jenkins
Versões de gatilho automático Você pode configurar um gatilho de implantação contínua para envios por push para o repositório em um pipeline de lançamento. Isso pode disparar automaticamente uma versão quando uma nova confirmação é feita em um repositório. Consulte Gatilhos.
Variáveis de artefato Há suporte para várias variáveis de artefato para builds do Jenkins.
Itens de trabalho e confirmações Azure Pipelines não pode mostrar itens de trabalho ou confirmações para builds do Jenkins.
Download do artefato Por padrão, os builds do Jenkins são baixados para o agente. Você pode configurar uma opção no estágio para ignorar o download de artefatos.

Artifacts gerados por builds jenkins normalmente são propagados para repositórios de armazenamento para arquivamento e compartilhamento. O armazenamento de blobs do Azure é um dos repositórios com suporte, permitindo que você consuma projetos jenkins que publicam no armazenamento do Azure como fontes de artefato em um pipeline de lançamento. As implantações baixam os artefatos automaticamente do Azure para os agentes. Nessa configuração, a conectividade entre o agente e o servidor Jenkins não é necessária. Os agentes hospedados pela Microsoft podem ser usados sem expor o servidor à Internet.

Observação

Azure Pipelines talvez não consiga entrar em contato com seu servidor Jenkins se, por exemplo, ele estiver dentro da sua rede corporativa. Nesse caso, você pode integrar Azure Pipelines ao Jenkins configurando um agente local que pode acessar o servidor Jenkins. Você não poderá ver o nome dos projetos do Jenkins ao vincular a um build, mas pode digitá-lo no campo de diálogo de link.

Para obter mais informações sobre os recursos de integração do Jenkins, consulte Azure Pipelines Integração com Trabalhos do Jenkins, Pipelines e Artifacts.

Fontes de artefato – contêineres

Ao implantar aplicativos em contêineres, a imagem de contêiner é enviada pela primeira vez para um registro de contêiner. Depois que o push for concluído, a imagem do contêiner poderá ser implantada no serviço aplicativo Web para contêineres ou em um cluster do Docker/Kubernetes. Você deve criar uma conexão de serviço com credenciais para se conectar ao serviço para implantar imagens localizadas lá ou no Azure. Para mais informações, consulte as conexões de serviço.

Os seguintes recursos estão disponíveis ao usar Registro de Contêiner do Azure, Docker, fontes do Kubernetes:

Recurso Comportamento com fontes do Docker
Versões de gatilho automático Você pode configurar um gatilho de implantação contínua para imagens. Isso pode disparar automaticamente uma versão quando uma nova confirmação é feita em um repositório. Consulte Gatilhos.
Variáveis de artefato Há suporte para várias variáveis de artefato para builds.
Itens de trabalho e confirmações Azure Pipelines não pode mostrar itens de trabalho ou confirmações.
Download do artefato Por padrão, os builds são baixados para o agente. Você pode configurar uma opção no estágio para ignorar o download de artefatos.

Observação

No caso da implantação contínua de várias fontes de artefato (vários registros/repositórios), não é possível mapear fontes de artefato para disparar estágios específicos. Uma versão será criada sempre que houver um push para qualquer uma das fontes de artefato. Se você quiser mapear uma fonte de artefato para disparar um estágio específico, a maneira recomendada é decompor o pipeline de lançamento em vários pipelines de lançamento.

Fontes de artefato - Azure Artifacts

Cenários em que você pode querer consumir esses artefatos são:

  1. Você tem seu build de aplicativo (como TFS, Azure Pipelines, TeamCity, Jenkins) publicado como um pacote para Azure Artifacts e deseja consumir o artefato em uma versão.
  2. Como parte da implantação do aplicativo, você precisa de pacotes adicionais armazenados em Azure Artifacts.

Ao vincular esse artefato ao pipeline de lançamento, você deve selecionar o Feed, o Pacote e a versão padrão do pacote. Você pode optar por pegar a versão mais recente do pacote, usar uma versão específica ou selecionar a versão no momento da criação da versão. Durante a implantação, o pacote é baixado para a pasta do agente e o conteúdo é extraído como parte da execução do trabalho.

Os seguintes recursos estão disponíveis ao usar Azure Artifacts fontes:

Recurso Comportamento com fontes Azure Artifacts
Versões de gatilho automático Você pode configurar um gatilho de implantação contínua para pacotes. Isso pode disparar automaticamente uma versão quando um pacote é atualizado. Consulte Gatilhos.
Variáveis de artefato Há suporte para várias variáveis de artefato para pacotes.
Itens de trabalho e confirmações Azure Pipelines não pode mostrar itens de trabalho ou confirmações.
Download do artefato Por padrão, os pacotes são baixados para o agente. Você pode configurar uma opção no estágio para ignorar o download de artefatos.

Manipulando instantâneos do Maven

Para instantâneos do Maven, várias versões podem ser baixadas ao mesmo tempo (exemplomyApplication-2.1.0.BUILD-20190920.220048-3.jar, myApplication-2.1.0.BUILD-20190820.221046-2.jar, ). myApplication-2.1.0.BUILD-20190820.220331-1.jar Talvez seja necessário remover as cópias antigas e manter apenas o artefato mais recente antes da implantação. Execute o seguinte comando do PowerShell em um prompt de comando com privilégios elevados para remover todas as cópias, exceto aquela com o valor lexicográfico mais alto:

Get-Item "myApplication*.jar" | Sort-Object -Descending Name | Select-Object -SkipIndex 0 | Remove-Item

Observação

Você pode armazenar até 30 instantâneos do Maven no feed. Depois de atingir o limite máximo, Azure Artifacts excluirá automaticamente instantâneos para 25. Esse processo será disparado automaticamente sempre que mais de 30 instantâneos forem publicados no feed.

Fontes de artefato – servidor TFS

Você pode usar Azure Pipelines para implantar artefatos publicados por um servidor TFS local. Você não precisa tornar o servidor TFS visível na Internet; você acabou de configurar um agente de automação local. Os builds de um servidor TFS local são baixados diretamente no agente local e, em seguida, implantados nos servidores de destino especificados. Eles não sairão da rede corporativa. Isso permite que você aproveite todos os seus investimentos em seu servidor TFS local e aproveite os recursos de versão em Azure Pipelines.

Dica

Usando esse mecanismo, você também pode implantar artefatos publicados em uma assinatura Azure Pipelines em outro Azure Pipelines ou implantar artefatos publicados em um Team Foundation Server de outro Team Foundation Server.

Para habilitar esses cenários, você deve instalar os artefatos TFS para Azure Pipelines extensão do Visual Studio Marketplace. Em seguida, crie uma conexão de serviço com credenciais para se conectar ao servidor TFS (consulte as conexões de serviço para obter detalhes).

Em seguida, você pode vincular um pipeline de build do TFS ao pipeline de lançamento. Escolha Build TFS externo na lista de tipos .

Os seguintes recursos estão disponíveis ao usar fontes TFS externas:

Recurso Comportamento com fontes externas do TFS
Versões de gatilho automático Você não pode configurar um gatilho de implantação contínua para fontes TFS externas em um pipeline de lançamento. Para criar automaticamente uma nova versão quando um build for concluído, você precisará adicionar um script ao pipeline de build no servidor TFS externo para invocar Azure Pipelines APIs REST e criar uma nova versão.
Variáveis de artefato Há suporte para várias variáveis de artefato para fontes TFS externas.
Itens de trabalho e confirmações Azure Pipelines não pode mostrar itens de trabalho ou confirmações para fontes TFS externas.
Download do artefato Por padrão, artefatos TFS externos são baixados para o agente. Você pode configurar uma opção no estágio para ignorar o download de artefatos.

Observação

Azure Pipelines talvez não consiga entrar em contato com um servidor TFS local caso esteja dentro de sua rede corporativa. Nesse caso, você pode integrar Azure Pipelines ao TFS configurando um agente local que pode acessar o servidor TFS. Você não poderá ver o nome de seus projetos do TFS ou criar pipelines ao vincular a um build, mas pode incluir essas variáveis nos campos de diálogo de link. Além disso, quando você cria uma versão, Azure Pipelines pode não ser capaz de consultar o servidor TFS para obter os números de build. Em vez disso, insira a ID de Build (não o número de build) do build desejado no campo apropriado ou selecione o build mais recente .

Fontes de artefato – TeamCity

Para integrar ao TeamCity, primeiro você deve instalar os artefatos do TeamCity para Azure Pipelines extensão do Marketplace.

Para consumir artefatos do TeamCity, comece criando uma conexão de serviço com credenciais para se conectar ao servidor TeamCity (consulte as conexões de serviço para obter detalhes).

Em seguida, você pode vincular uma configuração de build do TeamCity a um pipeline de lançamento. A configuração de build do TeamCity deve ser configurada com uma ação para publicar os artefatos.

Os seguintes recursos estão disponíveis ao usar fontes do TeamCity:

Recurso Comportamento com fontes do TeamCity
Versões de gatilho automático Não é possível configurar um gatilho de implantação contínua para fontes do TeamCity em um pipeline de lançamento. Para criar uma nova versão automaticamente quando um build for concluído, adicione um script ao projeto teamcity que invoca as APIs REST Azure Pipelines para criar uma nova versão.
Variáveis de artefato Há suporte para várias variáveis de artefato para builds do TeamCity.
Itens de trabalho e confirmações Azure Pipelines não pode mostrar itens de trabalho ou confirmações para builds do TeamCity.
Download do artefato Por padrão, os builds do TeamCity são baixados para o agente. Você pode configurar uma opção no estágio para ignorar o download de artefatos.

Observação

Azure Pipelines talvez não consiga entrar em contato com o servidor TeamCity se, por exemplo, ele estiver na rede corporativa. Nesse caso, você pode integrar Azure Pipelines ao TeamCity configurando um agente local que pode acessar o servidor TeamCity. Você não poderá ver o nome de seus projetos do TeamCity ao vincular a um build, mas pode digitá-lo no campo de diálogo do link.

Fontes de artefato – Artefatos personalizados

Além de fontes de artefatos internas, Azure Artifacts dá suporte à integração de qualquer fonte de artefato personalizada com o modelo de extensibilidade do artefato. Você pode conectar qualquer fonte de artefato personalizada e Azure DevOps fornecerá uma experiência de usuário de primeira classe e uma integração perfeita.

Para obter mais informações, consulte Azure DevOps modelo de extensibilidade de artefato.

Fontes de artefato – Outras fontes

Seus artefatos podem ser criados e expostos por outros tipos de fontes, como um repositório NuGet. Enquanto continuamos a expandir os tipos de fontes de artefato com suporte no Azure Pipelines, você pode começar a usá-lo sem aguardar o suporte para um tipo de origem específico. Basta ignorar a vinculação de fontes de artefato em um pipeline de lançamento e adicionar tarefas personalizadas aos estágios que baixam os artefatos diretamente da sua origem.

Alias de origem do artefato

Para garantir a exclusividade de cada download de artefato, cada fonte de artefato vinculada a um pipeline de lançamento é fornecida automaticamente com um local de download específico conhecido como alias de origem. Esse local pode ser acessado por meio da variável:

$(System.DefaultWorkingDirectory)\[source alias]

Essa exclusividade também garante que, se você renomear posteriormente uma fonte de artefato vinculada em seu local original (por exemplo, renomear um pipeline de build em Azure Pipelines ou um projeto no Jenkins), não será necessário editar as propriedades da tarefa porque o local de download definido no agente não é alterado.

O alias de origem é, por padrão, o nome da origem selecionada quando você vincula a origem do artefato, prefixada com um sublinhado; dependendo do tipo da origem do artefato, esse será o nome do pipeline de build, trabalho, projeto ou repositório. Você pode editar o alias de origem na guia artefatos de um pipeline de lançamento; por exemplo, quando você altera o nome do pipeline de build e deseja usar um alias de origem que reflita o nome do pipeline de build.

Fonte primária

Quando você vincula várias fontes de artefato a um pipeline de lançamento, uma delas é designada como a fonte de artefato primária. A origem do artefato primário é usada para definir um número de variáveis predefinidas. Ele também pode ser usado em versões de nomenclatura.

Download do artefato

Quando você implanta uma versão em um estágio, os artefatos com versão de cada uma das fontes são baixados, por padrão, para o agente de automação para que as tarefas em execução nesse estágio possam implantar esses artefatos. Os artefatos baixados para o agente não são excluídos quando uma versão é concluída. No entanto, quando você inicia a próxima versão, os artefatos baixados são excluídos e substituídos pelo novo conjunto de artefatos.

Uma nova pasta exclusiva no agente é criada para cada pipeline de lançamento quando você inicia uma versão e os artefatos são baixados nessa pasta. A $(System.DefaultWorkingDirectory) variável é mapeada para esta pasta.

Azure Pipelines atualmente não executa nenhuma otimização para evitar o download dos artefatos inalterados se a mesma versão for implantada novamente. Além disso, como o conteúdo baixado anteriormente sempre é excluído quando você inicia uma nova versão, Azure Pipelines não pode executar downloads incrementais para o agente.

No entanto, você pode instruir Azure Pipelines a ignorar o download automático de artefatos para o agente para um trabalho específico e estágio da implantação, se desejar. Normalmente, você fará isso quando as tarefas nesse trabalho não exigirem nenhum artefato ou se você implementar um código personalizado em uma tarefa para baixar os artefatos necessários.

No Azure Pipelines, no entanto, você pode selecionar quais artefatos deseja baixar para o agente para um trabalho específico e estágio da implantação. Normalmente, você fará isso para melhorar a eficiência do pipeline de implantação quando as tarefas nesse trabalho não exigirem todos ou nenhum dos artefatos, ou se você implementar o código personalizado em uma tarefa para baixar os artefatos necessários.

Selecting the artifacts to download

Variáveis de artefato

Azure Pipelines expõe um conjunto de variáveis predefinidas que você pode acessar e usar em tarefas e scripts; por exemplo, ao executar scripts do PowerShell em trabalhos de implantação. Quando há várias fontes de artefato vinculadas a um pipeline de lançamento, você pode acessar informações sobre cada uma delas. Para obter uma lista de todas as variáveis de artefato predefinidas, consulte variáveis.

Informações adicionais

Ajuda e suporte