Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Découvrez comment les pipelines d’intégration et de déploiement Git fonctionnent avec l’API pour GraphQL dans Microsoft Fabric. Cet article vous aide à comprendre comment configurer une connexion à votre référentiel, gérer votre API pour GraphQL et les déployer dans différents environnements.
Remarque
L’API pour le contrôle de code source GraphQL et le déploiement sont actuellement en préversion.
Conditions préalables
- Vous devez disposer d’une API pour GraphQL dans Fabric. Pour plus d’informations, consultez Créer une API pour GraphQL dans Fabric et ajouter des données.
Aperçu
Fabric offre de puissants outils pour CI/CD (intégration continue et déploiement continu) et la gestion du cycle de vie du développement via deux composants principaux : intégration Git (CI) et pipelines de déploiement (CD). Les espaces de travail servent de composants centraux pour les phases de synchronisation et de déploiement Git.
Intégration Git (CI) : synchronise les éléments de l’espace de travail (par exemple, le code, les configurations, les API) avec les référentiels de contrôle de version, en activant le contrôle de version et le suivi des modifications via Git.
Pipelines de déploiement (CD) : permet la création d’étapes (par exemple, développement, test, production) avec des espaces de travail liés. Les éléments pris en charge dans chaque étape sont automatiquement répliqués aux étapes suivantes, et les modifications dans un espace de travail déclenchent le déploiement dans un pipeline de publication. Vous pouvez configurer le pipeline pour vous assurer que les modifications sont testées et déployées efficacement dans les environnements.
Fabric prend en charge différents flux de travail CI/CD adaptés aux scénarios courants. Pour plus d’informations, consultez les options de flux de travail CI/CD dans Fabric.
Remarque
Seules les métadonnées sont copiées pendant le déploiement ; et les données ne sont pas copiées.
Les éléments de l’espace de travail sont stockés dans le référentiel Git associé en tant qu'Infrastructure as Code (IaC). Les modifications de code dans le référentiel peuvent déclencher le déploiement dans les pipelines. Cette méthode vous permet de répliquer automatiquement les modifications de code entre les étapes à des fins de test et de mise en production.
Méthodes d’authentification de source de données
Dans cette section, vous allez découvrir les méthodes d’authentification pour connecter des sources de données à votre API pour GraphQL et comprendre leur impact sur la liaison automatique entre l’API pour GraphQL et ses sources de données connectées dans les pipelines de développement. Vous pouvez en savoir plus sur la liaison automatique dans le processus de pipeline de déploiement.
Il existe deux options permettant de connecter des sources de données à votre API pour GraphQL :
Se connecter à des sources de données Fabric avec l’authentification unique (SSO)
Se connecter à Fabric OU à des sources de données externes à l’aide d’informations d’identification enregistrées
La première option, Single Sign-On (SSO) permet de se connecter à des sources de données dans Fabric. Dans ce cas, lorsque vous connectez une source de données à GraphQL à l’aide de la méthode d’authentification unique dans l’espace de travail d’origine (par exemple, phase de développement), la source de données et l’élément GraphQL seront déployés sur l’espace de travail cible (par exemple, phase de test) dans le pipeline, et GraphQL dans l’espace de travail cible sera automatiquement connecté à la source de données locale déployée dans l’espace de travail cible (voir le diagramme ci-dessous). Il existe des limitations spécifiques lors de l’utilisation de l’authentification unique et de la connexion à une source de données via le point de terminaison SQL Analytics. Pour plus d’informations, reportez-vous à **Limitations actuelles.
La deuxième option, Informations d’identification enregistrées, active les connexions à des sources de données externes en dehors de Fabric et à des sources de données dans Fabric. Toutefois, la liaison automatique n’est pas prise en charge par l’approche des informations d’identification sauvegardées. Cela signifie que si vous connectez une source de données à GraphQL à l’aide des informations d’identification enregistrées dans l’espace de travail d’origine (phase de développement), la source de données sera déployée sur l’espace de travail cible (phase de test) dans le pipeline. Toutefois, l’élément GraphQL de l’espace de travail cible reste connecté à la source de données de l’espace de travail d’origine (phase de développement) via les informations d’identification enregistrées, plutôt que de se connecter automatiquement à une source de données locale dans l’espace de travail cible. (voir le diagramme ci-dessous)
En outre, si la méthode d’informations d’identification enregistrées est utilisée pour se connecter à des sources de données, les développeurs doivent avoir accès aux informations d’identification enregistrées pour déployer correctement l’élément GraphQL.
Remarque
Si une API pour GraphQL dans l’espace de travail d’origine (phase de développement) est connectée à une source de données qui se trouve dans un autre espace de travail, l’API déployée pour GraphQL dans l’espace de travail cible (phase de test) reste connectée à la source de données située dans un autre espace de travail, quelle que soit la méthode d’authentification utilisée pour connecter les sources de données à votre API pour GraphQL. (voir le diagramme ci-dessous)
Intégration Git avec l’API GraphQL
L’API Fabric pour GraphQL offre une intégration Git pour le contrôle de code source. Avec l’intégration de Git, vous pouvez sauvegarder et versionr votre API pour GraphQL, revenir aux étapes précédentes en fonction des besoins, collaborer ou travailler seul à l’aide de branches Git et gérer entièrement votre API pour le cycle de vie GraphQL dans Fabric.
Configurer une connexion :
À partir des paramètres de votre espace de travail, vous pouvez facilement configurer une connexion à votre dépôt pour valider et synchroniser les modifications. Pour configurer la connexion, consultez Prise en main de l’intégration git. Une fois connectés, vos éléments, y compris l’API pour GraphQL, apparaissent dans le panneau de configuration source .
Une fois que vous avez correctement commité l’API pour les instances GraphQL dans le référentiel Git, vous voyez la structure de dossiers GraphQL dans le référentiel. Vous pouvez maintenant exécuter des opérations futures, telles que créer une pull request.
Représentation GraphQL dans Git :
L’image suivante est un exemple de la structure de fichiers de chaque élément API pour GraphQL dans le référentiel Git :
Lorsque vous validez l’API pour l’élément GraphQL dans le référentiel Git, l’API pour la définition GraphQL est stockée. Cette approche prend en charge une récupération précise quand vous resynchronisez vers un espace de travail Fabric :
Vous trouverez plus d’informations sur le format, la syntaxe et les exemples de définition de l’API GraphQL dans la documentation sur les API du plan de contrôle Fabric :
API pour GraphQL dans le pipeline de déploiement
Procédez comme suit pour effectuer votre déploiement d’API pour GraphQL à l’aide du pipeline de déploiement.
Créez un pipeline de déploiement ou ouvrez un pipeline de déploiement existant. Pour plus d’informations, consultez Prise en main des pipelines de déploiement.
Affectez des espaces de travail à différentes phases en fonction de vos objectifs de déploiement.
Sélectionnez, affichez et comparez les éléments, notamment l’API pour GraphQL entre différentes étapes, comme illustré dans l’exemple suivant. Zones en surbrillance indiquant le nombre d’éléments modifiés entre l’étape précédente et l’étape actuelle.
- Sélectionnez les éléments à déployer. Sélectionnez Déployer pour déployer vos éléments sélectionnés (API pour GraphQL et sa source de données connectées) dans les phases développement, test et production.
Le message suivant s’affiche pour confirmer les éléments que vous êtes sur le point de déployer. Sélectionnez Déployer pour confirmer et poursuivre le processus de déploiement.
Limitations actuelles
Le CI/CD de l’infrastructure ne prend pas en charge la liaison automatique des éléments enfants. Cela signifie que si l’API pour GraphQL se connecte à un point de terminaison SQL Analytics en tant que sous-composant d’une source de données dans l’espace de travail d’origine (par exemple, environnement de développement), le lignage ne se transfère pas à l’espace de travail cible (par exemple, environnement de test). Par conséquent, l’API déployée pour GraphQL dans l’espace de travail cible (par exemple, phase de test) reste connectée au point de terminaison SQL Analytics dans l’espace de travail d’origine (par exemple, phase de développement).
La liaison automatique n’est pas prise en charge lorsque l’approche d’informations d’identification enregistrées est utilisée pour les connexions de source de données. Pour plus d’informations, consultez la section méthodes d’authentification de source de données décrite ci-dessus.