Partilhar via

Automatize seu pipeline de implantação com APIs de malha

  • Artigo

A ferramenta de pipelines de implantação do Microsoft Fabric permite que as equipes criem um processo de liberação eficiente e reutilizável para seu conteúdo de malha.

Importante

Este recurso está em pré-visualização.

Use os pipelines de implantação Fabric REST APIs 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:

  • Integre o Fabric em ferramentas familiares de DevOps, como Azure DevOps ou GitHub Actions.

  • Agende implantações de pipeline para acontecer automaticamente em um horário específico.

  • Implante 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, você precisa dos seguintes pré-requisitos:

  • Os mesmos pré-requisitos necessários para usar pipelines de implantação.
  • Um token 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 de malha.

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

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

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

  • Obter pipeline de implantação: retorna informações sobre o pipeline de implantação especificado.

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

  • Obter estágios do pipeline de implantação: retorna os estágios da implantação especificada, incluindo sua ID, nome para exibição, descrição e se o estágio é público ou não.

  • Obter itens de estágio do pipeline de implantação: retorna os itens suportados do espaço de trabalho atribuído ao estágio especificado do pipeline de implantação especificado.

  • Implantar conteúdo do palco: implanta itens do estágio especificado do pipeline de implantação especificado.

    • Use essa API para implantar todos os itens ou para selecionar itens específicos para implantar. Se nenhum item específico for selecionado, todos os itens serão implantados.

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

    • Essa API é integrada com as APIs de Operações de Longa Execução para monitorar o status da implantação.

Você também pode usar outras chamadas de API REST de malha para concluir operações relacionadas.

Exemplos do PowerShell

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

  • Implantar tudo

    Forneça as seguintes informações:

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

  • Implantação seletiva

    Forneça as seguintes informações:

    • Nome do pipeline
    • Nome do estágio de origem
    • Nome do estágio de destino
    • Itens a serem implantados (nome para 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 seguintes limitações:

  • Todas as limitações que se aplicam ao pipeline de implantação se aplicam ao usar as APIs. Para obter mais informações, consulte Práticas recomendadas de pipelines de implantação.

  • Atualmente, não há suporte para fluxos de dados. 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 na Malha. As APIs a seguir não estão disponíveis na API de conteúdo do estágio Deploy do Fabric:

    • allowPurgeData
    • permitirTakeOver
    • allowSkipTilesWithMissingPrerequisites

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

Conteúdos relacionados