Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. 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á-los em diferentes ambientes.
Observação
A API para controlo e implantação do código-fonte do GraphQL está atualmente em pré-visualização.
Pré-requisitos
- Você deve ter uma API para GraphQL no Fabric. Para obter mais informações, consulte Criar uma API para o GraphQL na malha e adicionar dados.
Visão geral
O Fabric oferece ferramentas poderosas 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: integração Git (CI) e pipelines de implantação (CD). Os espaços de trabalho servem como componentes centrais para os estágios de sincronização e implantação do Git.
Integração com Git (CI): sincroniza itens do espaço de trabalho (por exemplo, código, configurações, APIs) com repositórios de controle de versão, permitindo o controle de versão e o controle de alterações via Git.
Pipelines de implantação (CD): Permite a criação de estágios (por exemplo, desenvolvimento, teste, produção) com espaços de trabalho vinculados. Os itens suportados em cada estágio são replicados automaticamente para os estágios subsequentes, e as alterações num espaço de trabalho acionam a implantação num pipeline de lançamento. Você pode configurar o pipeline para garantir que as alterações sejam testadas e implantadas de forma eficiente em todos os ambientes.
O Fabric suporta vários fluxos de trabalho de CI/CD adaptados a cenários comuns. Para obter mais detalhes, consulte Opções de fluxo de trabalho de CI/CD no Fabric.
Observação
Somente os metadados são copiados durante a implantação; e os dados não são copiados.
Os itens do espaço de trabalho são armazenados no repositório Git associado como Infraestrutura como Código (IaC). As alterações de código no repositório podem desencadear a implantação nos fluxos de trabalho. Esse método permite que as alterações de código sejam replicadas automaticamente entre os estágios para fins de teste e liberação de produção.
Métodos de autenticação da fonte de dados
Nesta seção, você aprenderá sobre os 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. Pode descobrir mais sobre a vinculação automática no fluxo de implantação.
Há duas opções disponíveis para conectar fontes de dados à sua API para GraphQL:
Conectar-se a fontes de dados Fabric com autenticação única (SSO)
Conectar-se ao Fabric OU a fontes de dados externas usando uma credencial guardada
A primeira opção, Single Sign-On (SSO), permite conexões com fontes de dados dentro da malha. Nesse caso, quando você conecta uma fonte de dados ao GraphQL usando o método de logon único no espaço de trabalho original (por exemplo, estágio de desenvolvimento), a fonte de dados e o item GraphQL serão implantados no espaço de trabalho de destino (por exemplo, estágio de teste) no pipeline, e o GraphQL no espaço de trabalho de destino será automaticamente conectado à fonte de dados local implantada no espaço de trabalho 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 SQL Analytics Endpoint, para obter mais detalhes, consulte **Limitações atuais.
A segunda opção, Credencial Salva, permite conexões com fontes de dados externas fora do Fabric e fontes de dados dentro do Fabric. No entanto, a vinculação automática não é suportada para a abordagem de credenciais salvas. Isso significa que, se tu conectares uma fonte de dados ao GraphQL usando as Credenciais Guardadas no espaço de trabalho original (fase de desenvolvimento), a fonte de dados será desencadeada no espaço de trabalho de destino (fase 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 de desenvolvimento) por meio das credenciais salvas, em vez de vinculação automática a uma fonte de dados local no espaço de trabalho de destino. (veja 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 de credenciais salvas para implantar com êxito o item GraphQL.
Observação
Se uma API para GraphQL no espaço de trabalho original (estágio de desenvolvimento) estiver conectada a uma fonte de dados que esteja em um espaço de trabalho diferente, a API implantada para GraphQL no espaço de trabalho de destino (estágio de teste) permanecerá conectada à fonte de dados localizada em espaço de trabalho diferente, independentemente do método de autenticação usado para conectar as fontes de dados à sua API para GraphQL. (veja o diagrama abaixo)
API para integração com GraphQL Git
A API de malha para GraphQL oferece integração Git para controle de código-fonte. Com a integração do Git, você pode fazer backup e fazer a versão de sua API para o GraphQL, reverter para estágios anteriores conforme necessário, colaborar ou trabalhar sozinho usando ramificações do Git e gerenciar sua API para o ciclo de vida do GraphQL inteiramente dentro do Fabric.
Configure uma conexão:
Nas configurações do espaço de trabalho, você pode facilmente configurar uma conexão com o repositório para confirmar e sincronizar alterações. Para configurar a conexão , consulte Introdução à integração com o Git. Uma vez conectados, seus itens, incluindo a API para GraphQL, aparecem no painel de controle Origem .
Depois de confirmar com êxito a API para instâncias do GraphQL no 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 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 o item API para GraphQL no repositório Git, a definição de API para GraphQL é armazenada. Esta abordagem oferece suporte a uma recuperação precisa quando sincroniza de volta com um espaço de trabalho Fabric:
Você pode encontrar mais informações sobre o formato de definição da API GraphQL, sintaxe e exemplos na documentação das APIs do plano de controle Fabric:
API para GraphQL no pipeline de implantação
Use as etapas a seguir para concluir sua API para implantação do GraphQL usando o pipeline de implantação.
Crie um novo pipeline de implantação ou abra um pipeline de implantação existente. Para obter mais informações, consulte Introdução aos pipelines de implantação.
Atribua espaços de trabalho a diferentes estágios de acordo com suas metas de implantação.
Selecione, veja e compare itens, incluindo a API para GraphQL, entre diferentes estágios, conforme mostrado no exemplo a seguir. As áreas destacadas 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 os itens selecionados (API para GraphQL e sua fonte de dados conectados) 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 Fabric não oferece suporte à vinculação automática dos itens filho. Isso significa que, se a API do GraphQL se conectar a um Endpoint do SQL Analytics como subjacente a uma fonte de dados no workspace original (por exemplo, estágio de desenvolvimento), a linhagem não será transferida para o workspace de destino (por exemplo, estágio de teste). Como resultado, a API implantada para GraphQL no espaço de trabalho de destino (por exemplo, estágio de teste) permanece conectada ao ponto de extremidade do SQL Analytics no espaço de trabalho original (por exemplo, estágio de desenvolvimento).
A vinculação automática não é suportada quando a abordagem de Credenciais Salvas é 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.