Atribuir um workspace a um pipeline de implantação

Os pipelines de implantação permitem atribuir e cancelar a atribuição de workspaces em qualquer estágio em um pipeline. Essa capacidade é importante para as organizações que já têm espaços de trabalho que são utilizados como ambientes diferentes de uma versão gerenciada. Nesses casos, é possível atribuir cada workspace ao estágio de pipeline correspondente e continuar trabalhando em seu fluxo habitual.

Atribuir um workspace a qualquer estágio de pipeline vago

Para atribuir um workspace a um pipeline, o estágio do pipeline ao qual você deseja atribuir o workspace precisa estar vazio. Se você desejar atribuir um espaço de trabalho a uma fase do pipeline que já tenha outro espaço de trabalho atribuído a ela, desatribua o espaço de trabalho atual dessa fase e, em seguida, atribua o novo espaço de trabalho.

Antes de atribuir um workspace a um estágio de pipeline, avalie a seção limitações e verifique se o workspace atende às condições necessárias.

Observação

Antes de atribuir ou cancelar a atribuição de um workspace a um pipeline, considere que sempre após a implantação em um estágio vago, um novo workspace é criado.

Siga estas etapas para atribuir um workspace a um estágio do pipeline:

  1. Abra o pipeline.

    Uma captura de tela exibindo um novo workspace de pipeline de implantação, com todas as etapas do pipeline não atribuídas.

  2. No estágio ao qual você deseja atribuir um workspace, expanda o menu suspenso intitulado Escolher um workspace para atribuir a esse pipeline.

  3. No menu suspenso, selecione o workspace que você deseja atribuir a esse estágio. Caso não veja o espaço de trabalho desejado, revise a seção Limitações e certifique-se de que o espaço de trabalho atenda às condições necessárias.

    Captura de tela exibindo a lista suspensa de atribuir workspace em um estágio vazio de pipelines de implantação.

  4. Selecione Atribuir um workspace.

    Captura de tela exibindo o botão para atribuir workspace em um estágio vazio de pipelines de implantação.

Cancelar a atribuição de um workspace de um estágio do pipeline

Você pode cancelar a atribuição de um workspace de qualquer estágio de pipeline. Para atribuir um workspace diferente a um estágio de pipeline, primeiro cancele a atribuição do workspace atual desse estágio.

Siga estas etapas para cancelar a atribuição de um workspace de um estágio do pipeline:

  1. Abra o pipeline.

  2. No estágio em que você deseja cancelar a atribuição do workspace, selecione configurações.

  3. No menu configurações, selecione Cancelar a atribuição do workspace.

    Captura de tela exibindo a opção cancelar a atribuição do workspace em pipelines de implantação, disponível no menu de configurações do estágio do pipeline.

  4. Na caixa de diálogo Cancelar a atribuição do workspace, selecione Cancelar a atribuição.

    Uma captura de tela que mostra a janela pop-up Cancelar a atribuição do espaço de trabalho nos pipelines de implantação, com o botão Cancelar a atribuição realçado.

Emparelhamento de itens

O emparelhamento é o processo pelo qual um item em um estágio do pipeline de implantação é associado ao mesmo item no estágio adjacente. O emparelhamento é vital para obter implantações corretas. Quando os itens não estão emparelhados, mesmo que pareçam ser os mesmos, eles não são substituídos em uma implantação subsequente.

O emparelhamento pode ocorrer de duas maneiras:

  • Implantação: quando um item não emparelhado é copiado de um estágio para outro usando o botão Implantar, o item que não foi emparelhado anteriormente é emparelhado com a cópia automaticamente.

  • Por meio da atribuição de um espaço de trabalho a um estágio de implantação: quando um espaço de trabalho é atribuído a um estágio de implantação, o pipeline de implantação tenta emparelhar os itens. Os critérios de emparelhamento são:

    • Nome do Item
    • Tipo de Item
    • Localização da pasta

Se for possível identificar um item que corresponda a todos esses três critérios, ocorrerá o emparelhamento. Se mais de um item no mesmo estágio corresponder a um item em um estágio adjacente, ocorrerá falha do emparelhamento.

Depois que os itens são emparelhados, renomeá-los não desemparelha os itens. Portanto, é possível que existam itens emparelhados com nomes diferentes.

Ver quais itens estão emparelhados

Os itens emparelhados aparecem na mesma linha na lista de conteúdo do pipeline. Os itens não emparelhados aparecem em uma linha sozinhos:

Captura de tela que mostra estágios adjacentes com itens emparelhados listados na mesma linha e um item que está somente no segundo estágio.

Criar itens não emparelhados com o mesmo nome

Não há como emparelhar itens manualmente, exceto ao seguir as regras de emparelhamento descritas na seção anterior. A adição de um novo item a um espaço de trabalho que faz parte de um pipeline não o emparelha automaticamente a um item idêntico em um estágio adjacente. Portanto, é possível ter itens idênticos e com o mesmo nome em espaços de trabalho adjacentes que não estejam emparelhados.

Veja um exemplo de itens que foram adicionados ao pipeline de Teste depois da atribuição e que, portanto, não foram emparelhados com o item idêntico no pipeline de Desenvolvimento:

Captura de tela que mostra estágios adjacentes com itens não emparelhados com nomes e tipos idênticos listados em linhas diferentes.

Vários itens com o mesmo nome e tipo em um espaço de trabalho

Se dois ou mais itens no espaço de trabalho a ser emparelhado tiverem o mesmo nome, tipo e pasta, ocorrerá a falha do emparelhamento. Mova um item para uma pasta diferente ou altere seu nome para que não haja mais dois itens que correspondam ao item existente no outro estágio.

Captura de tela de uma atribuição de espaço de trabalho apresentando falha porque há mais de um item com o mesmo nome e tipo.

Considerações e limitações

Comparar conteúdo em diferentes estágios.