Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Saiba como os pipelines de integração e implantação do Git funcionam com a API para GraphQL no Microsoft Fabric. Este artigo ajuda você a entender como configurar uma conexão com seu repositório, gerenciar sua API para GraphQL e implantá-las em ambientes diferentes.
Observação
A API para o controle do código-fonte e a implantação do GraphQL estão atualmente em versão prévia.
Pré-requisitos
- Você deve ter uma API para GraphQL no Fabric. Para obter mais informações, consulte Criar uma API para GraphQL no Fabric e adicionar dados.
Visão geral
O Fabric oferece ferramentas avançadas para CI/CD (integração contínua e implantação contínua) e gerenciamento do ciclo de vida de desenvolvimento por meio de dois componentes principais: CI ( integração git ) e CD (pipelines de implantação ). Os workspaces servem como componentes centrais para os estágios de sincronização e implantação do Git.
Integração do Git (CI): sincroniza itens de workspace (por exemplo, código, configurações, APIs) com repositórios de controle de versão, habilitando o controle de versão e o controle de alterações por meio do Git.
Pipelines de implantação (CD): habilita a criação de estágios (por exemplo, Desenvolvimento, Teste, Produção) com workspaces vinculados. Itens com suporte em cada estágio são replicados automaticamente para os estágios subsequentes, e alterações em um espaço de trabalho disparam a implantação em um pipeline de lançamento. Você pode configurar o pipeline para garantir que as alterações sejam testadas e implantadas com eficiência em ambientes.
O Fabric dá suporte a vários fluxos de trabalho de CI/CD adaptados a cenários comuns. Para obter mais detalhes, consulte as opções de fluxo de trabalho de CI/CD no Fabric.
Observação
Somente metadados são copiados durante a implantação; e os dados não são copiados.
Itens do espaço de trabalho são armazenados no repositório Git associado como Infraestrutura como Código (IaC). Alterações de código no repositório podem disparar a implantação em pipelines. Esse método permite que você tenha alterações de código replicadas automaticamente entre estágios para fins de teste e versão de produção.
Métodos de autenticação da fonte de dados
Nesta seção, você aprenderá sobre métodos de autenticação para conectar fontes de dados à sua API para GraphQL e entender seu impacto na vinculação automática entre a API para GraphQL e suas fontes de dados conectadas em pipelines de desenvolvimento. Você pode aprender mais sobre a associação automática no processo de pipeline de implantação.
Há duas opções disponíveis para conectar fontes de dados à sua API para GraphQL:
Conectar-se a fontes de dados do Fabric com SSO (autenticação de logon único)
Conectar-se a fontes de dados externos OU ao Fabric usando uma Credencial Salva
A primeira opção, Logon Único (SSO), habilita conexões com fontes de dados no Fabric. Nesse caso, quando você conecta uma fonte de dados ao GraphQL usando o método de logon único no workspace original (por exemplo, estágio Dev), a fonte de dados e o item GraphQL serão implantados no workspace de destino (por exemplo, estágio de teste) no pipeline e o GraphQL no workspace de destino será conectado automaticamente à fonte de dados local implantada no workspace de destino (consulte o diagrama abaixo). Há limitações específicas ao usar o SSO e conectar-se a uma fonte de dados por meio do Ponto de Extremidade da Análise de SQL, para obter mais detalhes, consulte **Limitações atuais.
A segunda opção, Saved Credential, permite conexões com fontes de dados externas fora do Fabric e fontes de dados no Fabric. No entanto, não há suporte para associação automática na abordagem de Credencial Salva. Isso significa que, se você conectar uma fonte de dados ao GraphQL usando a credencial salva no workspace original (estágio de desenvolvimento), a fonte de dados será implantada no workspace de destino (estágio de teste) no pipeline. No entanto, o item GraphQL no espaço de trabalho de destino permanecerá conectado à fonte de dados no espaço de trabalho original (estágio Dev) por meio das Credenciais Salvas, em vez de se associar automaticamente a uma fonte de dados local no espaço de trabalho de destino. (confira o diagrama abaixo)
Além disso, se o método de Credencial Salva for usado para se conectar a fontes de dados, os desenvolvedores deverão ter acesso às informações da Credencial Salva para implantar com êxito o item GraphQL.
Observação
Se uma API para GraphQL no workspace original (estágio de desenvolvimento) estiver conectada a uma fonte de dados que esteja em um workspace diferente, a API implantada para GraphQL no workspace de destino (estágio de teste) permanecerá conectada à fonte de dados localizada em um workspace diferente, independentemente de qual método de autenticação é usado para conectar as fontes de dados à sua API para GraphQL. (confira o diagrama abaixo)
API para integração do Git com GraphQL
A API do Fabric para GraphQL oferece integração do Git para controle do código-fonte. Com a integração do Git, você pode fazer backup e versão da API para GraphQL, reverter para estágios anteriores conforme necessário, colaborar ou trabalhar sozinho usando branches do Git e gerenciar seu ciclo de vida da API para GraphQL inteiramente dentro do Fabric.
Configurar uma conexão:
Nas configurações do Workspace, você pode configurar facilmente uma conexão com seu repositório para confirmar e sincronizar alterações. Para configurar a conexão , confira Introdução à integração do Git. Uma vez conectados, seus itens, incluindo a API para GraphQL, aparecem no painel de controle de origem .
Depois que você enviar com êxito as instâncias da API para GraphQL para o repositório Git, você verá a estrutura de pastas do GraphQL no repositório. Agora você pode executar operações futuras, como Criar solicitação de pull.
Representação do GraphQL no Git:
A imagem a seguir é um exemplo da estrutura de arquivos de cada item da API para GraphQL no repositório Git:
Quando você confirma a API do item GraphQL no repositório Git, a definição da API para GraphQL é armazenada. Essa abordagem dá suporte a uma recuperação precisa ao sincronizar novamente com um workspace do Fabric:
Você pode encontrar mais informações sobre o formato de definição da API do GraphQL, sintaxe e exemplos na documentação de APIs do painel de controle do Fabric:
API para GraphQL no fluxo de implantação
Use as etapas a seguir para concluir a implantação da API para GraphQL usando o pipeline de implantação.
Crie um novo pipeline de implantação ou abra um existente. Para obter mais informações, confira Introdução aos pipelines de implantação.
Atribua espaços de trabalho a diferentes fases de acordo com suas metas de implantação.
Selecione, visualize e compare itens, incluindo a API para GraphQL entre diferentes estágios, conforme mostrado no exemplo a seguir. As áreas realçadas indicam a contagem de itens alterada entre o estágio anterior e o estágio atual.
- Selecione os itens que precisam ser implantados. Selecione Implantar para implantar seus itens selecionados (API para GraphQL e sua fonte de dados conectada) nos estágios de desenvolvimento, teste e produção.
A próxima mensagem aparece confirmando os itens que você está prestes a implantar. Selecione Implantar para confirmar e continuar o processo de implantação.
Limitações atuais
O CI/CD do Fabric não dá suporte à associação automática dos itens filhos. Isso significa que, se a API para GraphQL estiver conectada a um Ponto de Extremidade de Análise SQL como filho de uma fonte de dados no espaço de trabalho original (por exemplo, estágio Dev), a linhagem não será transferida para o espaço de trabalho de destino (por exemplo, estágio de Teste). Como resultado, a API implantada para GraphQL no workspace de destino (por exemplo, estágio de teste) permanece conectada ao Endpoint de Análise SQL no workspace original (por exemplo, estágio de desenvolvimento).
Não há suporte para associação automática quando a abordagem de Credencial Salva é usada para conexões de fonte de dados. Para obter mais informações, consulte a seção de métodos de autenticação da fonte de dados descrita acima.