Créer une application Fabric avec l’interface CLI Rayfin

Ce tutoriel vous montre comment utiliser l’interface CLI Rayfin pour créer un projet, l’exécuter localement et le déployer sur Fabric. Vous utilisez le même flux de travail CLI pour les nouvelles applications et pour les mises à jour ultérieures de votre schéma ou serveur frontal.

Dans ce tutoriel, vous allez :

  • Créez un projet Fabric Apps à partir d’un modèle.
  • Démarrez l’application localement.
  • Connectez-vous à Fabric à partir de l’interface CLI.
  • Déployez l’application sur un espace de travail Fabric.
  • Vérifiez l’état du déploiement.

Prerequisites

  • Accès à Fabric.
  • Un espace de travail Fabric où vous disposez des autorisations Contributeur, Membre ou Administrateur.
  • Charge de travail Fabric Apps activée dans votre tenant.
  • Node.js et npm installés.

Créez une application avec un prompt IA

Utilisez l’invite suivante avec GitHub Copilot ou un autre agent de codage pour créer, explorer, exécuter, personnaliser et déployer une application 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

L’agent exécute les commandes de manière interactive et demande les paramètres nécessaires du projet ou de l’espace de travail. Examinez les fichiers générés et les commandes générées avant le déploiement. Si la charge de travail Fabric Apps n'est pas encore activée, demandez à un administrateur Fabric d'activer Fabric Apps (aperçu) dans le catalogue>OneLake Govern>Configurations>Workloads.

Créer une nouvelle application à partir de CLI

Pour générer une structure d’une nouvelle application à partir d’un modèle, utilisez npm create:

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

Cette commande crée un dossier de projet avec le modèle d’application, la rayfin configuration et le code source front-end.

Accédez au répertoire du projet :

cd my-app

Conseil / Astuce

Si vous disposez déjà d’un dossier de projet vide ou d’un npx rayfin initcode source existant, utilisez npm create plutôt que .

npx rayfin init .

Examinez le projet généré

Après la génération de la structure du projet, le projet inclut les fichiers dont vous avez besoin pour commencer à développer :

  • rayfin/rayfin.yml stocke les services d’application et les paramètres de déploiement.
  • rayfin/.env stocke les valeurs d’environnement utilisées par l’interface CLI.
  • rayfin/data/ contient vos fichiers de modèle de données.
  • Votre application frontale réside dans la structure de projet racine créée par le modèle sélectionné.

Pour obtenir une répartition détaillée des fichiers par fichier, consultez Comprendre la structure du projet.

Exécutez l’application localement.

Démarrez l’environnement de développement local :

npx rayfin dev

Cette commande démarre le serveur de développement du frontend pour l’application générée et déploie le backend sur Fabric. Pour confirmer que l’application démarre correctement, ouvrez l’URL locale affichée dans le terminal.

Déploie l’application sur Fabric

Générez d’autres fonctionnalités dans votre application. Après avoir testé vos modifications, déployez à nouveau sur Fabric.

npx rayfin up

Pour afficher un aperçu du déploiement sans apporter de modifications, exécutez :

npx rayfin up --dry-run

Vérifier le déploiement

Vérifiez l’état actuel du déploiement :

npx rayfin up status

Pour une réponse lisible par l’ordinateur, utilisez la sortie JSON :

npx rayfin up status --json

Une fois le déploiement réussi, l’interface CLI imprime l’URL de l’application hébergée et le lien du portail Fabric pour l’élément déployé.

Déploie uniquement du contenu statique ou de base de données

Si vous avez uniquement modifié des modèles de données, appliquez les modifications de base de données sans redéploiement complet :

npx rayfin up db apply

Si vous avez uniquement modifié le code frontal, redéployez les ressources statiques :

npx rayfin up staticapp deploy

Ajouter des fonctions

Les fonctions sont des fonctions TypeScript qui s’exécutent sur le serveur de votre application Fabric. Utilisez des fonctions logiques qui ne doivent pas s’exécuter dans le navigateur, telles que la gestion de secrets, l’accès aux données privilégiées et l’appel aux services en aval au nom de l’utilisateur connecté.

npx rayfin functions init

GitHub Copilot peut générer et mettre à jour les fichiers et composants requis. Vous pouvez aussi demander à l’agent d’exécuter l’application, de déboguer les fonctions localement, puis de déployer l’application. Par exemple, vous pouvez utiliser l’invite suivante pour créer un assistant de révision des pull requests IA en utilisant des fonctions :

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.

Résoudre les problèmes courants

La connexion échoue ou le déploiement retourne 401 ou 403

Réexécutez npx rayfin login , puis réessayez npx rayfin up.

Vous devez examiner ce que la CLI va faire

Avant de déployer des modifications, exécutez npx rayfin up --dry-run.

L’application se déploie, mais vous modifiez le schéma uniquement

Pour envoyer des modifications de schéma indépendamment, utilisez npx rayfin up db apply. Si vous effectuez des modifications destructrices telles que la modification du type d’une colonne ou la suppression d’une colonne, cette commande échoue. Pour forcer vos modifications, vous pouvez utiliser l’indicateur --force . Cette action peut être un changement cassant.

Étapes suivantes

  • Last updated on