Ανάπτυξη εφαρμογής Fabric στο Fabric

Αναπτύξτε μια εφαρμογή Fabric για να Fabric πραγματοποιώντας είσοδο, εκτελώντας τη ροή ανάπτυξης CLI και εξετάζοντας τις παραμέτρους του npx rayfin up για την εφαρμογή σας. Αυτό το άρθρο περιγράφει την έννοια του τι συμβαίνει κατά την ανάπτυξη.

Προϋποθέσεις

Αναπτύξτε την εφαρμογή σας

Εκτελέστε την ακόλουθη εντολή από τη ρίζα του έργου σας:

npx rayfin up

Εάν δεν έχετε εισέλθει, το CLI εκκινεί αυτόματα μια αλληλεπιδραστική ροή εισόδου.

Τι κάνει η ανάπτυξη

Η rayfin up εντολή εκτελεί αυτά τα βήματα με τη σειρά:

  1. Δημιουργεί ένα στοιχείο Fabric Apps στον χώρο εργασίας σας Fabric (ή επαναχρησιμοποιεί το υπάρχον σε επόμενες αναπτύξεις).
  2. Ανακτά το κλειδί με δυνατότητα δημοσίευσης από την απομακρυσμένη υπηρεσία.
  3. Συγχρονίζει τις ρυθμίσεις χρόνου εκτέλεσης από τη δική σας rayfin.yml στην απομακρυσμένη υπηρεσία, συμπεριλαμβανομένης της διαμόρφωσης ελέγχου ταυτότητας και των σημαιών υπηρεσίας.
  4. Εφαρμόζει το σχήμα βάσης δεδομένων που δημιουργείται από τους διακοσμητές μοντέλων δεδομένων TypeScript.
  5. Δημιουργεί και αναπτύσσει στατικό περιεχόμενο εάν staticHosting είναι ενεργοποιημένο στο rayfin.yml—εκτελεί την εντολή build, συσκευάζει τον φάκελο εξόδου σε ένα ZIP και τον αποστέλλει.
  6. Διατηρεί τις λεπτομέρειες ανάπτυξης και rayfin.yml.env.fabric-* τα αρχεία για τις επόμενες αναπτύξεις.

Μετά την ανάπτυξη, το CLI εκτυπώνει:

  • Το URL φιλοξενίας όπου είναι διαθέσιμη η εφαρμογή σας
  • Μια σύνδεση πύλης Fabric για τη διαχείριση της ανάπτυξης
  • Το αναγνωριστικό ανάπτυξης για αναφορά

Ρύθμιση παραμέτρων ελέγχου ταυτότητας

Μόνο ο έλεγχος ταυτότητας με μεσολάβηση Fabric (Entra SSO) υποστηρίζεται σε αναπτυγμένες εφαρμογές. Ο έλεγχος ταυτότητας ηλεκτρονικού ταχυδρομείου και κωδικού πρόσβασης είναι διαθέσιμος κατά την τοπική ανάπτυξη, αλλά δεν λειτουργεί μετά την ανάπτυξη στο Fabric.

Βεβαιωθείτε ότι το rayfin.yml έχει ενεργοποιημένη Fabric έλεγχο ταυτότητας πριν εκτελέσετε το rayfin up:

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

Προεπισκόπηση ανάπτυξης χωρίς αλλαγές

Χρησιμοποιήστε το --dry-run για να δείτε τι θα έκανε το CLI χωρίς να δημιουργήσετε ή να τροποποιήσετε πόρους:

npx rayfin up --dry-run

Εφαρμογή αλλαγών βάσης δεδομένων

Μετά την ενημέρωση των μοντέλων δεδομένων σας, προωθήστε τις αλλαγές σχήματος στην απομακρυσμένη βάση δεδομένων χωρίς να αναπτύξετε ξανά την πλήρη στοίβα:

npx rayfin up db apply

Εάν η αλλαγή σχήματος περιλαμβάνει δυνητικά καταστροφικές λειτουργίες (απόρριψη στηλών, μετονομασία πινάκων), το CLI σας προειδοποιεί και αρνείται να προχωρήσει. Χρησιμοποιήστε το --force για να παρακάμψετε τον έλεγχο ασφαλείας:

npx rayfin up db apply --force

Προσοχή

Η χρήση --force μπορεί να προκαλέσει απώλεια δεδομένων. Ελέγξτε προσεκτικά τις λειτουργίες που αναφέρονται και επιβεβαιώστε ότι αποδέχεστε τις συνέπειες πριν συνεχίσετε.

Αναδιάταξη στατικού περιεχομένου

Όταν αλλάξατε μόνο τον κώδικα διεπαφής, αναπτύξτε ξανά το στατικό περιεχόμενο ανεξάρτητα για έναν ταχύτερο κύκλο επανάληψης:

npx rayfin up staticapp deploy

Αυτή η εντολή εκτελεί το διαμορφωμένο buildCommand, συσκευάζει την έξοδο και την ανεβάζει στην απομακρυσμένη υπηρεσία.

Για να παραλείψετε το βήμα δόμησης και να αναπτύξετε την υπάρχουσα έξοδο:

npx rayfin up staticapp deploy --skip-build

Ελέγξτε την κατάσταση ανάπτυξης

Δείτε την τρέχουσα κατάσταση της ανάπτυξης του Fabric:

npx rayfin up status

Προσθήκη --json για έξοδο αναγνώσιμη από μηχανή:

npx rayfin up status --json

Ενημέρωση υπαρχουσών αναπτύξεων

Μετά την πρώτη ανάπτυξη, rayfin.yml αποθηκεύει τις λεπτομέρειες ανάπτυξης (rayfinItemId, fabricWorkspaceId, και το τελικό σημείο του στοιχείου). Η εκ νέου εκτέλεση npx rayfin up ενημερώνει την ίδια ανάπτυξη αντί να δημιουργεί μια νέα.

Για στοχευμένες ενημερώσεις, χρησιμοποιήστε τις υποεντολές:

Εντολή Τι ενημερώνει
npx rayfin up Τα πάντα: ρυθμίσεις, βάση δεδομένων και στατικό περιεχόμενο.
npx rayfin up db apply Μόνο σχήμα βάσης δεδομένων.
npx rayfin up staticapp deploy Μόνο στατικό περιεχόμενο.

Αντιμετώπιση προβλημάτων ανάπτυξης

Η ανάπτυξη αποτυγχάνει με σφάλμα 401 ή 403

Η συνεδρία σας μπορεί να έχει λήξει. Εκτελέστε npx rayfin login για εκ νέου έλεγχο ταυτότητας και, στη συνέχεια, δοκιμάστε npx rayfin upξανά .

Η εφαρμογή βάσης δεδομένων αναφέρει καταστροφικές αλλαγές

Το Rayfin CLI αποκλείει αλλαγές σχήματος που θα μπορούσαν να προκαλέσουν απώλεια δεδομένων. Ελέγξτε τις λειτουργίες που αναφέρονται και χρησιμοποιήστε npx rayfin up db apply --force τις μόνο αφού επιβεβαιώσετε ότι αποδέχεστε την απώλεια δεδομένων.

Η στατική ανάπτυξη υπερβαίνει το όριο μεγέθους

Το συμπιεσμένο αρχείο δεν πρέπει να υπερβαίνει τα 100 MB. Βελτιστοποιήστε το αποτέλεσμα της δομής σας εξαιρώντας χάρτες προέλευσης και μεγάλα στοιχεία ανάπτυξης ή μετακινήστε δυαδικά αρχεία στον χώρο αποθήκευσης εφαρμογών Fabric.

Διαχείριση της εφαρμογής σας στην πύλη Fabric

Μετά την ανάπτυξη, μπορείτε να διαχειριστείτε την εφαρμογή Fabric απευθείας στην πύλη Fabric.

Προβολή ιδιοτήτων αντικειμένου

Ανοίξτε την εφαρμογή Fabric στην πύλη Fabric για να δείτε:

  • Διεύθυνση URL εφαρμογής — Η δημόσια διεύθυνση URL όπου φιλοξενείται το στατικό περιεχόμενό σας.
  • Διεύθυνση URL παρασκηνίου εφαρμογής — Η βασική διεύθυνση URL για όλες τις υπηρεσίες παρασκηνίου.

Διαχείριση υπηρεσιών για παιδιά

Επιλέξτε την εφαρμογή Fabric για να δείτε τις θυγατρικές υπηρεσίες της:

  • Βάση δεδομένων SQL — Ανοίγει το Fabric πρόγραμμα επεξεργασίας ερωτημάτων SQL. Μπορείτε να εκτελέσετε ερωτήματα ανάγνωσης στα δεδομένα σας. Οι αλλαγές σχήματος που γίνονται απευθείας στην πύλη Fabric αντικαθίστανται στην επόμενη ανάπτυξη rayfin up.
  • Έλεγχος ταυτότητας — Προβολή και διαχείριση χρηστών με έλεγχο ταυτότητας στον πίνακα Χρήστες στη θυγατρική βάση δεδομένων SQL.

Δικαιώματα εφαρμογών

Για τυχόν συμβάλλοντες της εφαρμογής Fabric, για να αναπτύξουν μια εφαρμογή Fabric, χρειάζονται τουλάχιστον δικαιώματα Edit στο στοιχείο.

Σχετικό περιεχόμενο

  • Last updated on