Creación de una aplicación Fabric con la CLI de Rayfin

En este tutorial se muestra cómo usar la CLI de Rayfin para crear un proyecto, ejecutarlo localmente e implementarlo en Fabric. Use el mismo flujo de trabajo de la CLI para las nuevas aplicaciones y para las actualizaciones posteriores del esquema o el front-end.

En este tutorial, usted hará lo siguiente:

  • Cree un proyecto de Fabric Apps a partir de una plantilla.
  • Inicie la aplicación localmente.
  • Inicie sesión en Fabric desde la CLI.
  • Implemente la aplicación en un área de trabajo de Fabric.
  • Compruebe el estado de implementación.

Prerequisites

  • Acceso a Fabric.
  • Un área de trabajo de Fabric en la que tiene permisos de colaborador, miembro o administrador.
  • La carga de trabajo de Fabric Apps habilitada en su inquilino.
  • Node.js y npm instalados.

Crea una app con un prompt de IA

Utiliza el siguiente prompt con GitHub Copilot u otro agente de programación para crear, explorar, ejecutar, personalizar y desplegar una app Fabric:

Set up a new Fabric App project called "rayfin-app-ws".

1. Run: npm create @microsoft/rayfin@latest
2. Open the scaffolded project directory.
3. Explore the project structure and understand the Rayfin app framework.
4. Run: npm run dev
5. Make changes to the app based on my instructions.
6. When ready, deploy with: npx rayfin up

El agente ejecuta los comandos de forma interactiva y solicita cualquier configuración necesaria del proyecto o espacio de trabajo. Revisa los archivos generados y la salida de comandos antes del despliegue. Si la carga de trabajo de Fabric Apps aún no está habilitada, pide a un administrador de Fabric que active Fabric Apps (vista previa) en catálogo de OneLake>Gobernar>Configuraciones>Cargas de trabajo.

Crear una nueva app desde CLI

Para crear una nueva aplicación a partir de una plantilla, use npm create:

npm create @microsoft/rayfin@latest -- my-app --workspace <workspacename>

Este comando crea una nueva carpeta de proyecto con la plantilla de aplicación, la rayfin configuración y el código fuente de front-end.

Vaya al directorio del proyecto:

cd my-app

Sugerencia

Si ya tiene una carpeta de proyecto vacía o código fuente existente, use npx rayfin init en lugar de npm create.

npx rayfin init .

Revisa el proyecto generado

Después de generar la estructura del proyecto, el proyecto incluye los archivos necesarios para empezar a desarrollar:

  • rayfin/rayfin.yml almacena los servicios de aplicaciones y la configuración de implementación.
  • rayfin/.env almacena los valores de entorno usados por la CLI.
  • rayfin/data/ contiene los archivos del modelo de datos.
  • La aplicación de front-end reside en la estructura del proyecto raíz creada por la plantilla seleccionada.

Para obtener un desglose detallado de archivos por archivo, consulte Descripción de la estructura del proyecto.

Ejecución local de la aplicación

Inicie el entorno de desarrollo local:

npx rayfin dev

Este comando inicia el servidor de desarrollo del frontend para la aplicación generada y despliega el backend en Fabric. Para confirmar que la aplicación se inicia correctamente, abra la dirección URL local que se muestra en el terminal.

Despliega la app en Fabric

Cree más características en la aplicación. Después de probar los cambios, vuelva a implementar en Fabric.

npx rayfin up

Para obtener una vista previa de la implementación sin realizar cambios, ejecute:

npx rayfin up --dry-run

Comprobación de la implementación

Compruebe el estado de implementación actual:

npx rayfin up status

Para una respuesta legible por máquina, use la salida JSON:

npx rayfin up status --json

Después de realizar una implementación correcta, la CLI imprime la dirección URL de la aplicación hospedada y el vínculo del portal de Fabric para el elemento implementado.

Implementar solo contenido de base de datos o contenido estático

Si solo ha cambiado los modelos de datos, aplique los cambios de la base de datos sin volver a implementarlo:

npx rayfin up db apply

Si solo ha cambiado el código de front-end, vuelva a implementar los recursos estáticos:

npx rayfin up staticapp deploy

Añadir funciones

Las funciones son funciones TypeScript que se ejecutan en el servidor dentro de tu aplicación Fabric. Utiliza funciones lógicas que no deben ejecutarse en el navegador, como trabajar con secretos, acceder a datos privilegiados y llamar a servicios posteriores en nombre del usuario iniciado sesión.

npx rayfin functions init

GitHub Copilot puede generar y actualizar los archivos y componentes necesarios. También puedes pedirle al agente que ejecute la app, depure funciones localmente y despliegue la app. Por ejemplo, puedes usar el siguiente prompt para crear un asistente de revisión de pull requests de IA utilizando funciones:

Build an app that lets me view all pull requests for the repository
<repoURL>, chat with my Azure AI Foundry agent <agentName> to review
pull requests, and post review comments. Use functions with delegated
authentication to connect to Azure AI Foundry and Azure DevOps.

Solucionar problemas comunes

Error al iniciar sesión o el despliegue devuelve 401 o 403

Vuelva a ejecutar npx rayfin login y vuelva a intentar npx rayfin up.

Necesita comprobar qué hará la CLI.

Antes de implementar los cambios, ejecute npx rayfin up --dry-run.

La aplicación se implementa, pero solo se cambia el esquema.

Para insertar cambios de esquema de forma independiente, use npx rayfin up db apply. Si realiza cambios destructivos como modificar el tipo de una columna o quitar una columna, se produce un error en este comando. Para forzar los cambios, puede usar la --force marca . Esta acción puede ser un cambio importante.

Pasos siguientes

  • Última actualización el