Déployer une application Fabric sur Fabric

Déployez une application Fabric sur Fabric en vous connectant, en exécutant le flux de déploiement CLI et en examinant ce que npx rayfin up configure pour votre application. Cet article décrit le concept de ce qui se passe pendant le déploiement.

Prerequisites

  • Projet Fabric Apps avec un fichier de configuration rayfin/rayfin.yml. Si vous n'avez pas encore de projet, consultez Créer votre premier projet Fabric Apps.
  • Un compte Microsoft Entra ID ayant accès à un espace de travail Fabric.

Déployer votre application

Exécutez la commande suivante à partir de la racine de votre projet :

npx rayfin up

Si vous n’êtes pas connecté, l’interface CLI lance automatiquement un flux de connexion interactif.

Ce que fait le déploiement

La rayfin up commande effectue ces étapes dans l’ordre :

  1. Crée un élément Fabric Apps dans votre espace de travail Fabric (ou réutilise celui existant lors des déploiements suivants).
  2. Récupère la clé pouvant être publiée à partir du service distant.
  3. Synchronise les paramètres d’exécution depuis votre rayfin.yml vers le service distant, y compris la configuration d’authentification et les indicateurs du service.
  4. Applique le schéma de base de données généré à partir de vos décorateurs de modèle de données TypeScript.
  5. Génère et déploie du contenu statique s’il staticHosting est activé dans rayfin.yml: exécute votre commande de build, empaquette le dossier de sortie dans un fichier ZIP et le charge.
  6. Enregistre les détails du déploiement dans les fichiers rayfin.yml et .env.fabric-* pour les déploiements ultérieurs.

Après le déploiement, l’interface CLI imprime :

  • URL d’hébergement où votre application est active
  • Lien du portail Fabric pour gérer le déploiement
  • ID de déploiement pour référence

Configurer l’authentification

Seule l’authentification négociée Fabric (Entra SSO) est prise en charge pour les applications déployées. L'authentification par e-mail et mot de passe est disponible pendant le développement local, mais ne fonctionne pas après le déploiement sur Fabric.

Vérifiez que l’authentification de votre rayfin.yml Fabric est activée avant d’exécuter rayfin up :

services:
  auth:
    enabled: true
    fabric:
      enabled: true

Aperçu du déploiement sans modification

Utilisez --dry-run cette option pour voir ce que l’interface CLI ferait sans créer ou modifier des ressources :

npx rayfin up --dry-run

Appliquer des modifications de base de données

Après avoir mis à jour vos modèles de données, envoyez des modifications de schéma à la base de données distante sans redéployer la pile complète :

npx rayfin up db apply

Si le changement de schéma implique des opérations potentiellement destructrices (suppression de colonnes, renommage des tables), l’interface CLI vous avertit et refuse de continuer. Permet --force de remplacer le contrôle de sécurité :

npx rayfin up db apply --force

Avertissement

L’utilisation --force peut entraîner une perte de données. Passez en revue attentivement les opérations répertoriées et confirmez que vous acceptez les conséquences avant de continuer.

Redéployer du contenu statique

Lorsque vous avez uniquement modifié le code frontal, redéployez le contenu statique indépendamment pour un cycle d’itération plus rapide :

npx rayfin up staticapp deploy

Cette commande exécute votre fichier configuré buildCommand, empaquette la sortie et le charge sur le service distant.

Pour ignorer l’étape de génération et déployer la sortie existante :

npx rayfin up staticapp deploy --skip-build

Vérifier l’état du déploiement

Affichez l’état actuel de votre déploiement Fabric :

npx rayfin up status

Ajouter --json pour la sortie lisible par l’ordinateur :

npx rayfin up status --json

Mettre à jour les déploiements existants

Après le premier déploiement, rayfin.yml stocke les détails du déploiement (rayfinItemIdet fabricWorkspaceIdle point de terminaison de l’élément). L’exécution npx rayfin up met à jour le même déploiement plutôt que de en créer une nouvelle.

Pour les mises à jour ciblées, utilisez les sous-commandes :

Command Ce qu’il met à jour
npx rayfin up Tout : paramètres, base de données et contenu statique.
npx rayfin up db apply Schéma de base de données uniquement.
npx rayfin up staticapp deploy Contenu statique uniquement.

Résoudre les problèmes de déploiement

Échec du déploiement avec l’erreur 401 ou 403

Votre session a peut-être expiré. Exécutez npx rayfin login pour réauthentifier, puis réessayez npx rayfin up.

La base de données applique des rapports de modifications destructrices

L’interface CLI Rayfin bloque les modifications de schéma susceptibles d’entraîner une perte de données. Passez en revue les opérations répertoriées et utilisez npx rayfin up db apply --force uniquement après avoir confirmé que vous acceptez la perte de données.

Le déploiement statique dépasse la limite de taille

L’archive compressée ne doit pas dépasser 100 Mo. Optimisez votre sortie de build en excluant les cartes sources et les ressources de développement volumineuses, ou déplacez des fichiers binaires vers le stockage Fabric Apps.

Gérer votre application dans le portail Fabric

Après le déploiement, vous pouvez gérer votre application Fabric directement dans le portail Fabric.

Afficher les propriétés de l’élément

Ouvrez l’application Fabric dans le portail Fabric pour afficher :

  • URL de l’application : URL publique où votre contenu statique est hébergé.
  • URL du back-end d’application : URL de base pour tous les services principaux.

Gérer les services enfants

Sélectionnez l’application Fabric pour afficher ses services enfants :

  • SQL Database : ouvre l’éditeur de requête SQL Fabric. Vous pouvez exécuter des requêtes de lecture sur vos données. Les modifications de schéma apportées directement dans le portail Fabric sont remplacées sur le déploiement suivant rayfin up.
  • Authentification : affichez et gérez les utilisateurs authentifiés dans la table Users dans la base de données SQL enfant.

Autorisations d’application

Pour tous les contributeurs de l’application Fabric, afin de déployer une application Fabric, ils ont besoin d’une autorisation minimale Edit sur l’élément.

Contenu connexe

  • Last updated on