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 Microsoft 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 Microsoft Fabric desde la CLI.
  • Implemente la aplicación en un área de trabajo de Fabric.
  • Compruebe el estado de implementación.

Prerequisites

  • Acceso a Microsoft 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.

Si la carga de trabajo aplicaciones de Fabric aún no está habilitada, pida a un administrador de Fabric que active Fabric Apps (versión preliminar) en el portal de administración de Fabric.

Paso 1: Creación de un proyecto

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 .

Paso 2: Revisar 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.

Paso 3: Ejecución local de la aplicación

Inicie el entorno de desarrollo local:

npm run 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.

Paso 4: Implementar la aplicación 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

Paso 5: 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.

Paso 6: Implementar solo la base de datos o el 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

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

  • Last updated on