Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Obtenga información sobre cómo funcionan las canalizaciones de implementación e integración de Git con API para GraphQL en Microsoft Fabric. Este artículo le ayuda a comprender cómo configurar una conexión al repositorio, administrar la API para GraphQL e implementarlas en distintos entornos.
Nota:
La API para el control de código fuente y la implementación de GraphQL se encuentran actualmente en versión preliminar.
Prerrequisitos
- Debe tener una API para GraphQL en Fabric. Para obtener más información, consulte Creación de una API para GraphQL en Fabric y adición de datos.
Información general
Fabric ofrece herramientas eficaces para CI/CD (integración continua e implementación continua) y administración del ciclo de vida de desarrollo a través de dos componentes principales: Integración de Git (CI) e canalizaciones de implementación (CD). Las áreas de trabajo sirven como componentes centrales para las fases de sincronización e implementación de Git.
Integración de Git (CI): sincroniza los elementos del área de trabajo (por ejemplo, código, configuraciones, API) con repositorios de control de versiones, habilitando el control de versiones y el seguimiento de cambios a través de Git.
Canalizaciones de implementación (CD):habilita la creación de fases (por ejemplo, desarrollo, prueba, producción) con áreas de trabajo vinculadas. Los elementos admitidos en cada fase se replican automáticamente en las fases posteriores y los cambios en una implementación de desencadenador de área de trabajo en una canalización de versión. Puede configurar la canalización para asegurarse de que los cambios se prueban e implementan de forma eficaz en todos los entornos.
Fabric admite varios flujos de trabajo de CI/CD adaptados a escenarios comunes. Para obtener más información, consulte Opciones de flujo de trabajo de CI/CD en Fabric.
Nota:
Solo se copian los metadatos durante la implementación; y los datos no se copian.
Los elementos del área de trabajo se almacenan en el repositorio Git asociado como Infraestructura como Código (IaC). Los cambios de código en el repositorio pueden desencadenar la implementación en canalizaciones. Este método permite que los cambios de código se repliquen automáticamente entre fases con fines de prueba y versión de producción.
Métodos de autenticación del origen de datos
En esta sección, obtendrá información sobre los métodos de autenticación para conectar orígenes de datos a la API para GraphQL y comprenderá su impacto en el enlace automático entre la API para GraphQL y sus orígenes de datos conectados en las canalizaciones de desarrollo. Puede obtener más información sobre el enlace automático en el proceso de canalización de implementación.
Hay dos opciones disponibles para conectar orígenes de datos a la API para GraphQL:
Conexión a orígenes de datos de Fabric con autenticación de inicio de sesión único (SSO)
Conexión a orígenes de datos externos de Fabric O mediante una credencial guardada
La primera opción, Single Sign-On (SSO) permite conexiones a orígenes de datos dentro de Fabric. En este caso, al conectar un origen de datos a GraphQL mediante el método de inicio de sesión único en el área de trabajo original (por ejemplo, fase de desarrollo), el origen de datos y el elemento GraphQL se implementarán en el área de trabajo de destino (por ejemplo, fase de prueba) en la canalización y GraphQL en el área de trabajo de destino se conectarán automáticamente al origen de datos local implementado en el área de trabajo de destino (consulte el diagrama siguiente). Existen limitaciones específicas al usar el inicio de sesión único y conectarse a un origen de datos a través de un punto de conexión de SQL Analytics. Para obtener más información, consulte **Limitaciones actuales.
La segunda opción, Credencial guardada, permite conexiones a orígenes de datos externos fuera de Fabric y orígenes de datos dentro de Fabric. Sin embargo, no se admite el enlace automático para el enfoque credenciales guardadas. Esto significa que si conectas un origen de datos a GraphQL mediante credenciales guardadas en el área de trabajo original (etapa de desarrollo), el origen de datos se implementará en el área de trabajo de destino (etapa de prueba) del pipeline. Sin embargo, el elemento GraphQL del área de trabajo de destino permanecerá conectado al origen de datos del área de trabajo original (fase de desarrollo) a través de las credenciales guardadas, en lugar de enlazar automáticamente a un origen de datos local en el área de trabajo de destino. (consulte el diagrama siguiente)
Además, si el método Credencial guardada se usa para conectarse a orígenes de datos, los desarrolladores deben tener acceso a la información de credenciales guardadas para implementar correctamente el elemento GraphQL.
Nota:
Si una API para GraphQL en el área de trabajo original (fase de desarrollo) está conectada a un origen de datos que se encuentra en un área de trabajo diferente, la API implementada para GraphQL en el área de trabajo de destino (fase de prueba) permanecerá conectada al origen de datos que se encuentra en un área de trabajo diferente, independientemente del método de autenticación que se use para conectar los orígenes de datos a la API para GraphQL. (consulte el diagrama siguiente)
API para la integración de GraphQL con Git
Fabric API for GraphQL ofrece integración de Git para el control de código fuente. Con la integración de Git, puede realizar copias de seguridad y crear una versión de la API para GraphQL, revertir a las fases anteriores según sea necesario, colaborar o trabajar solo con ramas de Git y administrar su ciclo de vida de API para GraphQL completamente dentro de Fabric.
Configurar una conexión:
Desde la configuración del área de trabajo, puede configurar fácilmente una conexión al repositorio para confirmar y sincronizar los cambios. Para configurar la conexión, consulte Introducción a la integración de Git. Una vez conectados, los elementos, incluida la API para GraphQL, aparecen en el panel De control de código fuente .
Después de completar con éxito las instancias de la API para GraphQL en el repositorio de Git, verá la estructura de carpetas de GraphQL en el repositorio. Ahora puede ejecutar operaciones futuras, como Crear Pull Request.
Representación de GraphQL en Git:
La imagen siguiente es un ejemplo de la estructura de archivos de cada elemento de API para GraphQL en el repositorio de Git:
Al confirmar el elemento de la API de GraphQL en el repositorio de Git, se almacena la definición de la API de GraphQL. Este enfoque admite una recuperación precisa cuando se vuelve a sincronizar con un área de trabajo de Fabric:
Puede encontrar más información sobre el formato de definición de GraphQL API, la sintaxis y ejemplos en la documentación de las API del plano de control de Fabric:
API para GraphQL en la canalización de implementación
Siga estos pasos para completar el despliegue de la API de GraphQL mediante la canalización de despliegue.
Cree una nueva canalización de implementación o abra una canalización de implementación existente. Para más información, consulte Introducción a las canalizaciones de implementación.
Asigne áreas de trabajo a distintas fases según los objetivos de implementación.
Seleccione, vea y compare elementos, incluida la API para GraphQL entre distintas fases, como se muestra en el ejemplo siguiente. Las áreas resaltadas que indican el recuento de elementos modificados entre la fase anterior y la fase actual.
- Seleccione los elementos que deben implementarse. Seleccione Implementar para implementar los elementos seleccionados (API para GraphQL y su origen de datos conectados) en las fases desarrollo, prueba y producción.
El siguiente mensaje aparece confirmando los elementos que está a punto de implementar. Seleccione Implementar para confirmar y continuar el proceso de implementación.
Limitaciones actuales
Fabric CI/CD no admite el enlace automático de los elementos secundarios. Esto significa que si la API para GraphQL se conecta a un punto de conexión de SQL Analytics como elemento secundario de un origen de datos en el área de trabajo original (por ejemplo, fase de desarrollo), el linaje no se transfiere al área de trabajo de destino (por ejemplo, fase de prueba). Como resultado, la API implementada para GraphQL en el área de trabajo de destino (por ejemplo, fase de prueba) permanece conectada al punto de conexión de SQL Analytics en el área de trabajo original (por ejemplo, fase de desarrollo).
No se admite el enlace automático cuando se usa el enfoque de credenciales guardadas para las conexiones de origen de datos. Para obtener más información, consulte la sección Métodos de autenticación de orígenes de datos descritos anteriormente.