O que é um plano de implantação no Microsoft Fabric? (pré-visualização)

Um plano de implantação Microsoft Fabric é um item de espaço de trabalho que adiciona a ordem explícita dos itens e ações automatizadas a uma operação de implantação. Use um plano para posicionar os itens em uma sequência específica. Você também pode usá-lo para rodar um notebook, pipeline de dados ou outro item suportado antes ou depois de um item ser implantado.

Um plano de implantação funciona com as seguintes ferramentas:

• Integração do Git
• Pipelines de implantação
• APIs REST suportadas

Neste artigo, ferramenta de implantação refere-se a qualquer uma dessas ferramentas suportadas. Você não executa um plano por si só. Você o conecta quando inicia uma operação com uma ferramenta de implantação.

Quando usar um plano de implantação

Use um plano de implantação quando:

Você não precisa de um plano de implantação quando a ordem padrão da ferramenta de implantação é suficiente e nenhuma ação é necessária.

Componentes do plano de implantação

Um plano de implantação contém os seguintes componentes:

Para tipos de ações suportadas e comportamento de ação, veja Ações do plano de implantação.

Como funciona um plano de implantação

Cada operação de implantação combina três entradas:

• Itens selecionados: Os itens selecionados para a operação.
• Plano de implantação: A ordem explícita e as ações associadas a esses itens.
• Linhagem Fabric: As dependências que Fabric detecta entre os itens.

Determinar o escopo de implantação

A ferramenta de implantação determina a origem, o alvo e os itens da operação. Anexar um plano não substitui essa escolha. Itens selecionados que não estão em um grupo de implantação ainda assim são implantados usando o comportamento padrão da ferramenta.

Anexar um plano não seleciona automaticamente os itens que ele referencia. Em uma superfície de implantação seletiva, selecione os itens que deseja implantar e certifique-se de que os itens exigidos pelas ações do plano estejam disponíveis no workspace alvo quando essas ações sejam executadas.

Um plano de implantação controla a implantação e as ações dos itens. Ele não implanta configurações em nível de workspace, como identidades de workspace, conexões, vinculações de gateway ou configurações do Spark. Configure o espaço de trabalho de destino antes que uma ação dependa dessas configurações.

Corrigir a ordem de implantação

Fabric combina dependências explícitas entre grupos de implantação com dependências detectadas pela linhagem. Um plano pode adicionar uma ordem que a linhagem não representa, mas não remove dependências que o Fabric detecta.

Para um cenário detalhado que mostra como os itens selecionados, dependências do plano, linhagem e ações em tempo de execução funcionam juntos, veja exemplos de planos de implantação.

Executar grupos de implantação e ações

Para cada grupo de implantação, o Fabric executa suas ações pré-implantação, implanta o item do grupo e então executa suas ações pós-implantação. Dependências entre grupos e ações determinam sua ordem. A posição de um item no arquivo do plano não define sua ordem.

Anexar um plano é opcional. Sem um plano, a ferramenta de implantação selecionada utiliza seu comportamento padrão.

Anexe um plano de implantação

Você pode anexar um plano quando usa uma operação de integração Git suportada, implanta conteúdo por meio de um pipeline de implantação ou chama uma API REST suportada. O anexo aplica-se apenas a essa operação. Para as superfícies suportadas e o comportamento de seleção de planos, veja Anexar um plano de implantação.

Criar e versionar um plano de implantação

Crie um plano no canvas do plano de implantação, onde você adiciona grupos de implantação, define sua ordem e configura ações. Para instruções, veja Criar um plano de implantação.

Um plano de implantação é um item de espaço de trabalho. Quando o workspace estiver conectado ao Git, faça commit do plano com os itens aos quais ele faz referência, para que o plano possa avançar pelo seu processo de CI/CD.

Se uma operação falhar

A operação para quando um item ou ação falha e não reverte o trabalho concluído. Para comportamentos de falha e etapas de resolução, veja Planos de implantação para solucionar problemas.

Considerações e limitações

Limitações do plano geral de implantação

• Você não pode usar um plano para implantar em mais de um workspace em uma única execução.
• Você pode anexar apenas um plano de implantação a uma operação de implantação.

Limitações para anexar um plano

• Um anexo de plano aplica-se apenas à operação atual. Você não pode configurar um plano como padrão para implantações futuras ou agendar o plano em si. Se uma ferramenta de implantação agenda uma operação, a operação deve anexar o plano toda vez que é executada.
• Você não pode anexar um plano a uma operação de importação de item único.
• A fabric-cicd biblioteca não suporta planos de implantação.

Limitações durante uma implantação

• Você não pode implantar grupos de implantação independentes em paralelo.
• Uma implantação fracassada não é revertida. Itens que já foram implantados permanecem no workspace de destino, e itens posteriores não são implantados.

Limitações para ações do plano

• Apenas combinações suportadas de itens e tipos de trabalho podem ser executadas como ações pré-implantação ou pós-implantação. Veja Tipos de itens que você pode usar como uma ação.
• Você não pode usar o mesmo item Dataflow Gen2 em mais de uma ação de um plano. O trabalho de atualização não pode ser executado mais de uma vez ao mesmo tempo, portanto a tela avisa você quando adiciona a segunda ocorrência, e essa segunda ocorrência é bloqueada durante a implantação.
• Você não pode retornar mais de 512 KB de uma ação da função de dados do usuário. Saídas maiores são truncadas. A ação ainda assim é bem sucedida.
• Você não pode fazer com que uma ação espere até que os serviços que ela alimenta a acompanhem. Uma ação é concluída quando a ação termina, então a próxima ação pode começar antes que os dados produzidos possam ser consultados.
• Você não pode usar um plano de implantação para alterar o conjunto de valores ativos de uma Biblioteca de Variáveis durante a implantação. As referências de variáveis são resolvidas com base no conjunto de valores que já está ativo no espaço de trabalho de destino. Em um workspace de destino recém-criado, Default permanece ativo até que você selecione e salve outro conjunto de valores. Para mais informações, veja Biblioteca de variáveis CI/CD.

Limitações para a autoria de planos

• Você não pode adicionar mais de um item a um grupo de implantação.
• A tela suporta apenas layout automático.

Limites de tamanho do plano de implantação

Um plano que ultrapassa qualquer um desses limites é rejeitado ao ser salvo. Os limites são aplicados sempre que um plano é salvo, então eles se aplicam ao canvas, à API REST, a uma chamada do Git e a ferramentas externas.

Conteúdo relacionado

• Criar um plano de implementação
• Exemplos de planos de implantação
• Introdução ao CI/CD no Microsoft Fabric
• Introdução à integração do Git
• Introdução aos pipelines de implantação
• Escolha um fluxo de trabalho Fabric CI/CD
• Entenda a vinculação de dependências na implantação entre espaços de trabalho