Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Informazioni sul funzionamento delle pipeline di integrazione e distribuzione Git con l'API per GraphQL in Microsoft Fabric. Questo articolo illustra come configurare una connessione al repository, gestire l'API per GraphQL e distribuirle in ambienti diversi.
Annotazioni
L'API per il controllo del codice sorgente GraphQL e la distribuzione sono attualmente in anteprima.
Prerequisiti
- È necessario avere un'API per GraphQL in Fabric. Per altre informazioni, vedere Creare un'API per GraphQL in Fabric e aggiungere dati.
Informazioni generali
Fabric offre potenti strumenti per CI/CD (integrazione continua e distribuzione continua) e la gestione del ciclo di vita di sviluppo tramite due componenti principali: Integrazione Git (CI) e pipeline di distribuzione (CD). Le aree di lavoro fungono da componenti centrali per le fasi di sincronizzazione e distribuzione git.
Integrazione Git (CI): sincronizza gli elementi dell'area di lavoro (ad esempio, codice, configurazioni, API) con repository di controllo della versione, abilitando il controllo della versione e il rilevamento delle modifiche tramite Git.
Pipeline di distribuzione (CD): consente la creazione di fasi (ad esempio, Sviluppo, Test, Produzione) con aree di lavoro collegate. Gli elementi supportati in ogni fase vengono replicati automaticamente nelle fasi successive, e le modifiche in un'area di lavoro attivano il deployment in una pipeline di rilascio. È possibile configurare la pipeline per assicurarsi che le modifiche vengano testate e distribuite in modo efficiente in ambienti diversi.
Fabric supporta diversi flussi di lavoro CI/CD personalizzati per scenari comuni. Per altri dettagli, vedere Opzioni del flusso di lavoro CI/CD in Fabric.
Annotazioni
Solo i metadati vengono copiati durante la distribuzione; e i dati non sono copiati.
Gli elementi dell'area di lavoro vengono archiviati nel repository Git associato come Infrastruttura come Codice (IaC). Le modifiche al codice nel repository possono attivare la distribuzione nelle pipeline. Questo metodo consente di replicare automaticamente le modifiche del codice tra le fasi per scopi di test e rilascio di produzione.
Metodi di autenticazione dell'origine dati
In questa sezione vengono illustrati i metodi di autenticazione per connettere le origini dati all'API per GraphQL e comprendere l'impatto sull'associazione automatica tra l'API per GraphQL e le origini dati connesse nelle pipeline di sviluppo. Altre informazioni sull'associazione automatica sono disponibili nel processo della pipeline di distribuzione.
Sono disponibili due opzioni per connettere le origini dati all'API per GraphQL:
Collegarsi alle origini dati di Fabric con autenticazione Single Sign-On (SSO)
Connettersi a un'infrastruttura o a origini dati esterne usando credenziali salvate
La prima opzione, Single Sign-On (SSO) consente le connessioni alle origini dati all'interno di Fabric. In questo caso, quando si connette un'origine dati a GraphQL usando il metodo Single Sign-On nell'area di lavoro originale (ad esempio, fase sviluppo), l'origine dati e l'elemento GraphQL verranno distribuiti nell'area di lavoro di destinazione (ad esempio, fase di test) nella pipeline e GraphQL nell'area di lavoro di destinazione verranno connessi automaticamente all'origine dati locale distribuita nell'area di lavoro di destinazione (vedere il diagramma seguente). Esistono limitazioni specifiche quando si usa l'accesso SSO e si connette a un'origine dati tramite endpoint di Analisi SQL. Per altri dettagli, vedere **Limitazioni correnti.
La seconda opzione, Credential salvata, consente connessioni a origini dati esterne a Fabric e origini dati all'interno di Fabric. Tuttavia, l'associazione automatica non è supportata per l'approccio Alle credenziali salvate. Ciò significa che se si connette un'origine dati a GraphQL usando le credenziali salvate nell'area di lavoro originale (fase sviluppo), l'origine dati verrà distribuita nell'area di lavoro di destinazione (fase di test) nella pipeline. Tuttavia, l'elemento GraphQL nell'area di lavoro di destinazione rimarrà connesso all'origine dati nell'area di lavoro originale (fase sviluppo) tramite le credenziali salvate, anziché l'associazione automatica a un'origine dati locale nell'area di lavoro di destinazione. (vedere il diagramma seguente)
Inoltre, se il metodo Saved Credential viene usato per connettersi alle origini dati, gli sviluppatori devono avere accesso alle informazioni sulle credenziali salvate per distribuire correttamente l'elemento GraphQL.
Annotazioni
Se un'API per GraphQL nell'area di lavoro originale (fase sviluppo) è connessa a un'origine dati che si trova in un'area di lavoro diversa, l'API distribuita per GraphQL nell'area di lavoro di destinazione (fase di test) rimarrà connessa all'origine dati che si trova in un'area di lavoro diversa indipendentemente dal metodo di autenticazione usato per connettere le origini dati all'API per GraphQL. (vedere il diagramma seguente)
API GraphQL per l'integrazione di Git
L'API fabric per GraphQL offre l'integrazione Git per il controllo del codice sorgente. Con l'integrazione con Git, è possibile eseguire il backup e la versione dell'API per GraphQL, ripristinare le fasi precedenti in base alle esigenze, collaborare o lavorare da soli usando i rami Git e gestire l'API per il ciclo di vita graphQL interamente all'interno di Fabric.
Configurare una connessione:
Dalle impostazioni dell'area di lavoro è possibile configurare facilmente una connessione al repository per eseguire il commit e la sincronizzazione delle modifiche. Per configurare la connessione, vedere Introduzione all'integrazione con Git. Una volta connessi, gli elementi, inclusa l'API per GraphQL, vengono visualizzati nel pannello di controllo Del codice sorgente .
Dopo aver eseguito correttamente il commit dell'API per le istanze graphQL nel repository Git, nel repository viene visualizzata la struttura di cartelle GraphQL. È ora possibile eseguire operazioni future, ad esempio Creare una richiesta pull.
Rappresentazione GraphQL in Git:
L'immagine seguente è un esempio della struttura di file di ogni api per l'elemento GraphQL nel repository Git:
Quando si esegue il commit dell'elemento API per GraphQL nel repository Git, viene archiviata l'API per la definizione GraphQL. Questo approccio supporta un ripristino preciso quando si sincronizza con un'area di lavoro Fabric.
Per altre informazioni sul formato, la sintassi e gli esempi di definizione dell'API GraphQL, vedere la documentazione sulle API del piano di controllo fabric:
API per GraphQL nella pipeline di distribuzione
Usare la procedura seguente per completare l'API per la distribuzione graphQL usando la pipeline di distribuzione.
Creare una nuova pipeline di distribuzione o aprire una pipeline di distribuzione esistente. Per altre informazioni, vedere Introduzione alle pipeline di distribuzione.
Assegnare le aree di lavoro a fasi diverse in base agli obiettivi di distribuzione.
Selezionare, visualizzare e confrontare gli elementi, inclusa l'API per GraphQL tra diverse fasi, come illustrato nell'esempio seguente. Aree evidenziate che indicano il numero di elementi modificati tra la fase precedente e la fase corrente.
- Selezionare gli elementi da distribuire. Selezionare Distribuisci per distribuire gli elementi selezionati (API per GraphQL e l'origine dati connessa) nelle fasi sviluppo, test e produzione.
Il messaggio successivo viene visualizzato per confermare gli elementi da distribuire. Selezionare Distribuisci per confermare e continuare il processo di distribuzione.
Limitazioni correnti
La CI/CD di Fabric non supporta l'associazione automatica degli elementi figlio. Ciò significa che se l'API per GraphQL si connette a un endpoint di Analisi SQL come figlio di un'origine dati nell'area di lavoro originale (ad esempio, fase di sviluppo), la derivazione non viene trasferita all'area di lavoro di destinazione (ad esempio, fase di test). Di conseguenza, l'API distribuita per GraphQL nell'area di lavoro di destinazione (ad esempio, fase di test) rimane connessa all'endpoint di Analisi SQL nell'area di lavoro originale (ad esempio, fase di sviluppo).
L'associazione automatica non è supportata quando viene usato l'approccio Credenziali salvate per le connessioni all'origine dati. Per altre informazioni, vedere la sezione relativa ai metodi di autenticazione dell'origine dati descritta in precedenza.