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 Microsoft 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 à Microsoft 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 à Microsoft 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.

Si la charge de travail Fabric Apps n'est pas encore activée, demandez à un administrateur Fabric d'activer Fabric Apps (préversion) dans le portail d'administration Fabric.

Étape 1 : Créer un projet

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 .

Étape 2 : Passer en revue 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.

Étape 3 : Exécuter l’application localement

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

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

Étape 4 : Déployer 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

Étape 5 : 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é.

Étape 6 : Déployer uniquement la base de données ou le contenu statique

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

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