Compartilhar via


Ambiente de integração Git e pipeline de implantação

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

Integração do Git para o ambiente Microsoft Fabric

O Microsoft Fabric oferece suporte à integração do Git, permitindo que os desenvolvedores façam backup, controlem versões, revertam para estágios anteriores e colaborem em seus trabalhos usando GIT branches.

Importante

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

Observação

  • Atualmente, o Git oferece suporte a apenas bibliotecas e computação do Spark, incluindo o runtime Spark.
  • A integração do Git gerencia o estado de preparo do ambiente, para aplicar as alterações feitas no Git ao ambiente. Elas devem ser publicadas. É recomendável publicar após atualizar o ambiente do Git para garantir a eficácia da configuração. Você pode usar a API de publicação de 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 do Fabric. A definição do pool está situada na configuração do espaço de trabalho e não há suporte para a referência ao pool entre espaços de trabalho. 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 ao remover essa propriedade. Você pode ver Pools personalizados: Listar pools personalizados do espaço de trabalho para obter a lista completa do pool disponível no espaço de trabalho de destino pela API REST ou ver Pools personalizados: Criar pool personalizado do espaço de trabalho para criar um pool personalizado.
  • Cada confirmação tem como limite superior 150 MB. Bibliotecas personalizadas maiores que 150 MB não têm suporte atualmente pelo Git.

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

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 repositório.

Captura de tela da 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 Bibliotecas 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 do conda. Você pode especificar a biblioteca com a versão esperada, um intervalo de versões ou sem versão. O sistema pode ajudar 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.

Observação

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 do Spark

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

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

Pipeline de implantação para ambiente

Importante

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

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 aos espaços de trabalho diferentes fases. Saiba mais em Introdução aos pipelines de implantação.

Captura de tela do ambiente de implantação 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

  • No momento, 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 comparação no pipeline de implantação, mesmo que a implantação seja feita com êxito.
  • O uso de regras de implantação para especificar um pool diferente no novo espaço de trabalho será incluído na próxima versão.