Partilhar via


Pipeline de integração e implantação do Git de ambiente

Este artigo descreve como usar pipelines de integração e implantação do Git para ambiente no Microsoft Fabric.

Integração Git para ambiente Microsoft Fabric

O Microsoft Fabric suporta integração Git, permitindo que os desenvolvedores façam backup, controlem versões, revertam para estágios anteriores e colaborem em seu trabalho usando ramificações Git.

Importante

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

Nota

  • Atualmente, o Git suporta apenas bibliotecas e computação do Spark, incluindo o tempo de execução do Spark.
  • A integração do Git gerencia o estado de preparação do ambiente, para aplicar as alterações feitas no Git ao ambiente, elas devem ser publicadas. Recomenda-se publicar após a atualização do ambiente do Git para garantir a eficácia da configuração. Você pode usar a API de publicação do ambiente para publicar alterações por meio da API REST se preferir a experiência code-first.
  • O pool personalizado anexado persiste em um ambiente quando você sincroniza do repositório para um espaço de trabalho de malha. A definição de pool está na configuração de espaço de trabalho e a referência entre espaços de trabalho não é suportada. Você deve atualizar manualmente o instance_pool_id para um pool personalizado existente no espaço de trabalho de destino ou reverter para o Pool inicial removendo essa propriedade. Você pode consultar Custom Pools - List Workspace Custom Pools para obter a lista completa do pool disponível no espaço de trabalho de destino pela API REST ou consultar Custom Pools - Create Workspace Custom Pool para criar um novo pool personalizado.
  • Cada confirmação tem como limite máximo 150 MB. Atualmente, bibliotecas personalizadas maiores que 150 MB não são suportadas pelo Git.

Conectar o espaço de trabalho Fabric a um repositório do Azure DevOps

Se você for o administrador de um espaço de trabalho, navegue até as configurações do espaço de trabalho e configure a conexão na seção Controle do código-fonte. Para saber mais, consulte Gerenciar um espaço de trabalho com o Git.

Depois de se conectar, você pode encontrar itens, incluindo os ambientes sincronizados com o repo.

Captura de tela mostrando a conexão bem-sucedida do espaço de trabalho a um repositório de DevOps do Azure.

Representação local de um ambiente no Git

Na pasta raiz do item, os ambientes são organizados com uma pasta Libraries que contém as subpastas PublicLibraries e CustomLibraries, juntamente com a pasta Setting.

Captura de tela da representação local do ambiente no Git.

Bibliotecas

Quando você confirma um ambiente no Git, a seção de biblioteca pública é transformada em sua representação YAML. Além disso, a biblioteca personalizada é confirmada junto com seu arquivo de origem.

Captura de tela da representação local do ambiente da biblioteca pública no Git.

Você pode atualizar a biblioteca pública editando a representação YAML. Assim como a experiência do portal, você pode especificar uma biblioteca do PyPI e conda. Você pode especificar a biblioteca com a versão esperada, um intervalo de versões ou sem versão. O sistema pode ajudá-lo a determinar uma versão compatível com outras dependências em seu ambiente. Para limpar todas as bibliotecas públicas existentes, exclua o arquivo YAML.

Você pode atualizar a biblioteca personalizada adicionando novos arquivos ou excluindo arquivos existentes diretamente.

Nota

Você pode trazer seu próprio arquivo YAML para gerenciar a biblioteca pública. O nome do arquivo precisa ser environment.yml para ser reconhecido corretamente pelo sistema.

Computação de faísca

A seção de computação Spark também é transformada na representação YAML. Dentro desse arquivo YAML, você pode alternar o pool anexado, ajustar as configurações de computação, gerenciar as propriedades do Spark e selecionar o tempo de execução desejado do Spark.

Captura de tela da representação local de computação do Spark do ambiente no Git.

Pipeline de implantação para ambiente

Importante

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

Os pipelines de implantação do Fabric simplificam o processo de fornecimento de conteúdo modificado em diferentes fases, como passar do desenvolvimento para o teste. O pipeline automático pode incluir os itens de ambiente para transmitir o processo de recriação.

Você pode configurar um pipeline de implantação atribuindo os espaços de trabalho com diferentes fases. Saiba mais em Introdução aos pipelines de implantação.

Captura de tela da implantação do ambiente no pipeline de implantação.

Você pode encontrar o status de implantação depois de configurar o pipeline com êxito. Depois de clicar no botão Implantar com o ambiente selecionado, todo o conteúdo do ambiente é implantado nos espaços de trabalho de destino. O status do ambiente original é preservado nesse processo, o que significa que as configurações publicadas permanecem no estado publicado e não exigem publicação extra.

Importante

  • Atualmente, não há suporte para o pool personalizado no pipeline de implantação. Se o ambiente selecionar o pool personalizado, as configurações da seção Computação no ambiente de destino serão definidas com valores padrão. Nesse caso, os ambientes continuam mostrando diff no pipeline de implantação, mesmo que a implantação seja feita com êxito.
  • O uso de regras de implantação para especificar pool diferente no novo espaço de trabalho será incluído na próxima versão.