Implantar conteúdo usando pipelines de implantação

Qualquer usuário licenciado que seja pelo menos um colaborador no estágio de origem, pode implantar conteúdo em um estágio de destino não atribuído. Para implantar num ambiente de destino existente, o utilizador também deve ser pelo menos um colaborador no ambiente de destino.

Você também pode usar as APIs REST dos pipelines de implantação para executar implantações programaticamente. Para obter mais informações, consulte Automatizar seu pipeline de implantação usando APIs e DevOps.

Nota

A nova interface de utilizador do pipeline de implantação está atualmente em pré-visualização. Para ativar ou usar a nova interface do usuário, consulte Começar a usar a nova interface do usuário.

Implementar num ambiente vazio

Se você já tiver um espaço de trabalho que gostaria de usar com um estágio específico, em vez de implantá-lo, poderá atribuir esse espaço de trabalho ao estágio apropriado.

Quando você implanta conteúdo em um estágio vazio, as relações entre os itens são mantidas. Por exemplo, um relatório vinculado a um modelo semântico no estágio de origem é clonado junto com seu modelo semântico e os clones são vinculados de forma semelhante no espaço de trabalho de destino. A estrutura de pastas também é mantida. Se você tiver itens em uma pasta no estágio de origem, uma pasta será criada no estágio de destino. Como uma pasta é implantada somente se um de seus itens for implantado, uma pasta vazia não pode ser implantada.

Quando a implantação estiver concluída, atualize o modelo semântico. Para obter mais informações, consulte implementar conteúdo para um ambiente de teste vazio.

Opções de implementação

Os pipelines de implementação oferecem três opções para implementar o seu conteúdo do Fabric:

Depois de escolher como implantar seu conteúdo, você pode revisar sua implantação e deixar uma nota.

Implementar todo o conteúdo

  1. Selecione o estágio de destino.
  2. No menu pendente, escolha um estágio adjacente a partir do qual implementar.
  3. Selecione os itens que deseja implantar.
  4. Selecione o botão Implantar .

Uma captura de tela mostrando como implantar conteúdo do estágio de desenvolvimento para teste na nova interface de pipeline de implantação.

O processo de implantação cria um espaço de trabalho duplicado no estágio de destino. Este espaço de trabalho inclui todo o conteúdo selecionado do estágio de origem.

Implantação seletiva

Se você não quiser implantar tudo a partir desse estágio, poderá selecionar itens específicos para implantação. Selecione o link Mostrar mais e, em seguida, selecione os itens que deseja implantar. Quando você seleciona o botão Implantar , somente os itens selecionados são implantados para a próxima etapa.

Nota

Os itens não podem ser selecionados para implantação em pastas de espaço de trabalho no modo de exibição de estágio padrão. No entanto, alternar para o modo de exibição de lista simples permite que você selecione itens para implantação em pastas de espaço de trabalho.

Os itens de tecido são frequentemente relacionados ou dependentes de outros itens. Painéis, relatórios, modelos semânticos, fluxos de dados, lakehouses e armazéns são exemplos de itens que podem estar relacionados com outros itens ou depender deles. Para incluir todos os itens relacionados com o item que pretende implementar, utilize o botão “Selecionar relacionados”. Por exemplo, se quiser implementar um relatório para a próxima fase, selecione o botão Selecionar relacionado para marcar o modelo semântico ao qual o relatório está ligado, para que ambos sejam implementados em conjunto e o relatório não se quebre.

Se você não quiser implantar tudo a partir desse estágio, poderá selecionar apenas itens específicos para implantação. Como painéis, relatórios, modelos semânticos e fluxos de dados podem ter dependências, você pode usar o botão selecionar relacionado para ver todos os itens dos quais o item selecionado depende. Por exemplo, se você quiser implantar um relatório para a próxima etapa, selecione o botão Selecionar relacionado para marcar o modelo semântico ao qual o relatório está conectado, para que ambos sejam implantados juntos e o relatório não seja interrompido.

O botão implantar mostra o número de itens selecionados para implantação.

Os itens não suportados também são mostrados nesta lista. Os itens sem suporte não podem ser implantados, mas podem ser filtrados.

Uma captura de ecrã que mostra a opção de implementação seletiva em pipelines de implementação.

Nota

  • Não é possível implementar um item do Fabric na fase seguinte se os itens de que depende não existirem na fase para a qual está a implementar. Por exemplo, a implantação de um relatório sem um modelo semântico falhará, a menos que o modelo semântico já exista no estágio de destino.
  • Você pode obter resultados inesperados se optar por implantar um item sem o item do qual ele depende. Isso pode acontecer quando um modelo semântico ou um fluxo de dados no estágio de destino foi alterado e não é mais idêntico ao do estágio a partir do qual você está implantando.

Ao implantar espaços de trabalho que contêm pastas, as seguintes regras se aplicam:

  • Itens do mesmo nome e tipo são emparelhados. Se houver dois itens com o mesmo nome e tipo em um espaço de trabalho, os itens serão emparelhados com itens no estágio de destino somente se o caminho for o mesmo (eles estão na mesma pasta).
  • Como uma pasta é implantada somente se um ou mais de seus itens forem implantados, uma pasta vazia não pode ser implantada.
  • As pastas individuais não podem ser implementadas manualmente numa implementação. Sua implantação é acionada automaticamente quando um ou mais de seus itens são implantados.
  • Implantar apenas alguns itens em uma pasta atualiza a estrutura de todos os itens na pasta no estágio em que está sendo implantado, mesmo que os itens em si não sejam implantados.
  • A hierarquia de pastas de itens emparelhados é atualizada somente durante a implantação. Durante a atribuição, após o processo de emparelhamento, a hierarquia de itens emparelhados ainda não é atualizada.

Visualização de lista simples

Com a exibição atual da hierarquia de pastas, você pode selecionar para implantação, apenas itens no mesmo nível de pasta. Não é possível selecionar itens entre pastas.

A vista de lista plana é uma funcionalidade adicional dos pipelines de implementação que lhe permite selecionar itens independentemente da sua localização. Com o modo de exibição de lista simples, agora você pode selecionar itens entre pastas, em relação à sua localização no espaço de trabalho.

Os itens a seguir são importantes para ter em mente ao usar o modo de exibição de lista simples.

  • Para ativar o recurso, há uma alternância na parte superior da área de conteúdo do palco.
  • Uma vez no modo de exibição de lista simples, uma coluna de local adicional é mostrada e contém o caminho completo de um item.
  • O botão selecionar relacionado funciona apenas em uma exibição de lista simples (ele é ativado quando pelo menos um item é selecionado). Portanto, se você estiver no modo de exibição de pastas e clicar nesse botão, o modo de exibição será automaticamente movido para o modo de exibição de lista simples.
  • Se você estiver no modo de exibição de lista simples, selecionou alguns itens para implantação e, em seguida, voltou para o modo de exibição de pasta, a seleção será redefinida para nenhum. Esse comportamento também se aplica à filtragem de itens.

Captura de ecrã da vista de lista plana num pipeline de implementação.

Implantação retroativa

Às vezes, você pode querer implantar o conteúdo em um estágio anterior.

Nota

Lembre-se de que a implantação retroativa só é possível ao implantar todos os itens. Isso significa que você não pode implantar seletivamente itens para trás, você deve implantar todos os itens para fazer a implantação para trás.

Por exemplo, se atribuir uma área de trabalho existente a uma fase de produção e, em seguida, a implementar em sentido inverso, primeiro na fase de teste e depois na fase de desenvolvimento. A implantação em um estágio anterior funciona somente se o estágio anterior estiver vazio.

Uma captura de ecrã que mostra como alterar o ambiente para o qual faz a implementação.

Revise sua implantação e deixe uma nota

Depois de selecionar qual conteúdo implantar, uma janela pop-up lista todos os itens que você está prestes a implantar. Você pode revisar a lista e adicionar uma nota ou comentário à implantação. Adicionar uma nota é opcional, mas é altamente recomendável, pois as notas são adicionadas ao histórico de implementação. Com uma nota para cada implementação, consultar o histórico dos seus pipelines torna-se mais útil.

Para deixar uma nota, expanda a opção Adicionar uma nota e escreva a sua nota na caixa de texto. Quando estiver pronto para implantar, selecione Implantar.

Uma captura de tela mostrando a janela pop-up de implantação, com a opção Adicionar uma nota expandida.

Implantar conteúdo de um estágio para outro

Assim que tiver conteúdo numa fase da pipeline, pode promovê-lo para a fase seguinte. A implantação de conteúdo em outro estágio geralmente é feita depois que você executa algumas ações no pipeline. Por exemplo, fez alterações de desenvolvimento em seu conteúdo no estágio de desenvolvimento ou testou seu conteúdo no estágio de teste. Embora você possa ter até 10 estágios diferentes no pipeline, um fluxo de trabalho típico para mover conteúdo é o desenvolvimento para o estágio de teste e, em seguida, o teste para a produção. Você pode saber mais sobre esse processo na seção implantar conteúdo em um espaço de trabalho existente.

Ao implantar conteúdo em um estágio que já tenha outro conteúdo, selecione os itens que deseja implantar. Um item que é emparelhado com outro item no estágio de origem (o nome do item emparelhado aparece na última coluna) é substituído por ele.

As relações entre os itens não são preservadas. Portanto, se você implantar um relatório vinculado a um modelo semântico no estágio de origem, somente o relatório será implantado. Se quiser implementar tudo o que está relacionado com o relatório, use o botão Selecionar relacionado.

Para implantar conteúdo no próximo estágio do pipeline de implantação, selecione os itens e, em seguida, selecione o botão implantar.

Ao revisar os cartões de estágio de teste e produção, você pode ver a data e a hora da última implantação. Isso indica a última vez que o conteúdo foi implantado no palco.

O tempo de implantação é útil para estabelecer quando um estágio foi atualizado pela última vez. Também pode ser útil se quiser acompanhar o tempo decorrido entre as implementações de teste e de produção.