Automatizar o pipeline de implantação com as APIs do Fabric

A ferramenta de pipelines de implantação do Microsoft Fabric permite que as equipes criem um processo de versão eficiente e reutilizável nos próprios conteúdos do Microsoft Fabric.

Importante

Esse recurso está na versão prévia.

Você pode usar as APIs REST do Fabric de pipelines de implantação para integrar o Fabric ao processo de automação da sua organização. Aqui estão alguns exemplos do que pode ser feito usando as APIs:

• Integrar o Fabric nas ferramentas DevOps conhecidas, como Azure DevOps ou GitHub Actions.

• Agendar implantações de pipeline para que ocorram automaticamente em um momento específico.

• Implantar vários pipelines ao mesmo tempo.

• Cascata dependendo das implantações de pipeline. Se você tiver conteúdo conectado entre pipelines, poderá garantir que alguns pipelines sejam implantados antes de outros.

Pré-requisitos

Para trabalhar com APIs de pipeline de implantação, os seguintes pré-requisitos são necessários:

• Os mesmos pré-requisitos necessários para usar pipelines de implantação.
• Um token do Microsoft Entra para o serviço Fabric. Use esse token no cabeçalho de autorização da chamada de API. Para obter informações sobre como obter um token, consulte Guia de início rápido da API do Fabric.

Você pode usar as APIs REST sem o PowerShell, mas os scripts deste artigo usam o PowerShell. Para executar os scripts, você precisa instalar os seguintes programas:

• PowerShell
• O módulo Az do Azure PowerShell

Funções de API de pipelines de implantação

Os pipelines de implantação das APIs REST do Fabric permitem que você execute as seguintes funções:

• Get Deployment Pipeline: retorna informações sobre o pipeline de implantação especificado.

• List Deployment Pipelines: retorna uma lista de pipelines de implantação aos quais o usuário tem acesso.

• Get Deployment Pipeline Stages: retorna os estágios da implantação especificada, incluindo sua ID, nome de exibição, descrição e se o estágio é público ou não.

• Get Deployment Pipeline Stage Items: retorna os itens com suporte do espaço de trabalho atribuído ao estágio especificado do pipeline de implantação especificado.

• Deploy Stage Content: implanta itens do estágio especificado do pipeline de implantação especificado.

  • Use essa API para implantar todos os itens ou para selecionar os itens específicos a serem implantados. Quando nenhum item específico é selecionado, todos os itens são implantados.

  • Para localizar a ID de estágio relevante a ser implantada, use a API Get Deployment Pipeline Stages.

  • Essa API é integrada às APIs de operações de execução prolongada para monitorar o status da implantação.

    • Obtenha o estado da operação para ver se a operação foi concluída com a API Get Long Running - Get Operation state.
    • Por 24 horas após a conclusão da implantação, as informações de implantação estendida ficam disponíveis naAPI Get Operation Result.

Você também pode usar outras chamadas à API REST do Fabric para concluir operações relacionadas.

Exemplos do PowerShell

Você pode usar os scripts do PowerShell a seguir para entender como executar vários processos de automação. Para exibir ou copiar o texto em um exemplo do PowerShell, use os links desta seção.

• Implantar tudo

  Insira as seguintes informações:

  • Nome do pipeline
  • Nome do estágio da origem
  • Nome do estágio de destino
  • Notas de implantação (opcional)

• Implantação seletiva

  Insira as seguintes informações:

  • Nome do pipeline
  • Nome do estágio da origem
  • Nome do estágio de destino
  • Itens a serem implantados (nome de exibição dos itens e tipo de item)
  • Notas de implantação (opcional)

Considerações e limitações

Ao usar as APIs de pipelines de implantação, considere as limitações a seguir:

• Todas as limitações que se aplicam ao pipeline de implantação se aplicam ao uso das APIs. Para obter mais informações, confira Melhores práticas para pipelines de implantação.

• Não há suporte para Fluxo de dados no momento. Os clientes que usam fluxos de dados podem usar as APIs do Power BI.

• As entidades de serviço só têm suporte para itens do Power BI.

• Nem todas as opções de implantação disponíveis nas APIs do Power BI estão disponíveis no Fabric. As seguintes APIs não estão disponíveis na API de conteúdo do estágio de implantação do Fabric:

  • allowPurgeData
  • allowTakeOver
  • allowSkipTilesWithMissingPrerequisites

  Se você precisar de uma dessas APIs, use a API do Power BI para a implantação. No entanto, essas APIs só funcionam para itens do Power BI.

Conteúdo relacionado

• Introdução aos pipelines de implantação
• Melhores práticas para pipelines de implantação
• Solução de problemas dos pipelines de implantação