Δημιουργήστε μια εφαρμογή Fabric με το Rayfin CLI

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

Σε αυτό το πρόγραμμα εκμάθησης:

  • Δημιουργήστε ένα έργο Fabric Apps από ένα πρότυπο.
  • Ξεκινήστε την εφαρμογή τοπικά.
  • Συνδεθείτε στο Fabric από το CLI.
  • Αναπτύξτε την εφαρμογή σε έναν χώρο εργασίας Fabric.
  • Επαληθεύστε την κατάσταση ανάπτυξης.

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

  • Πρόσβαση στο Fabric.
  • Ένας χώρος εργασίας Fabric όπου έχετε δικαιώματα συμβάλλου, μέλους ή διαχειριστή.
  • Ο φόρτος εργασίας Fabric Apps είναι ενεργοποιημένος στον μισθωτή σας.
  • Node.js και npm εγκατεστημένα.

Εάν ο φόρτος εργασίας Fabric εφαρμογών δεν έχει ενεργοποιηθεί ακόμα, ζητήστε από έναν διαχειριστή Fabric να ενεργοποιήσει το Fabric Εφαρμογές (έκδοση προεπισκόπησης) στην πύλη διαχείρισης Fabric.

Βήμα 1: Δημιουργία νέου έργου

Για να δημιουργήσετε μια νέα εφαρμογή από ένα πρότυπο, χρησιμοποιήστε τα npm createεξής:

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

Αυτή η εντολή δημιουργεί έναν νέο φάκελο έργου με το πρότυπο εφαρμογής, τη rayfin ρύθμιση παραμέτρων και τον πηγαίο κώδικα διεπαφής.

Μεταβείτε στον κατάλογο του έργου:

cd my-app

Συμβουλή

Εάν έχετε ήδη έναν κενό φάκελο έργου ή υπάρχοντα πηγαίο κώδικα, χρησιμοποιήστε αντί npx rayfin init για npm create.

npx rayfin init .

Βήμα 2: Ελέγξτε το έργο που δημιουργήθηκε

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

  • rayfin/rayfin.yml Αποθηκεύει τις υπηρεσίες εφαρμογών και τις ρυθμίσεις ανάπτυξης.
  • rayfin/.env αποθηκεύει τις τιμές περιβάλλοντος που χρησιμοποιούνται από το CLI.
  • rayfin/data/ περιέχει τα αρχεία του μοντέλου δεδομένων σας.
  • Η εφαρμογή διεπαφής σας βρίσκεται στη ριζική δομή έργου που δημιουργήθηκε από το επιλεγμένο πρότυπο.

Για μια λεπτομερή ανάλυση ανά αρχείο, ανατρέξτε στην ενότητα Κατανόηση της δομής του έργου.

Βήμα 3: Εκτελέστε την εφαρμογή τοπικά

Ξεκινήστε το περιβάλλον τοπικής ανάπτυξης:

npm run dev

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

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

Ενσωματώστε περισσότερες δυνατότητες στην εφαρμογή σας. Αφού δοκιμάσετε τις αλλαγές σας, αναπτύξτε ξανά το Fabric.

npx rayfin up

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

npx rayfin up --dry-run

Βήμα 5: Επαληθεύστε την ανάπτυξη

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

npx rayfin up status

Για μια απόκριση αναγνώσιμη από υπολογιστή, χρησιμοποιήστε την έξοδο JSON:

npx rayfin up status --json

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

Βήμα 6: Βάση δεδομένων Deloy ή μόνο στατικό περιεχόμενο

Εάν αλλάξατε μόνο μοντέλα δεδομένων, εφαρμόστε τις αλλαγές στη βάση δεδομένων χωρίς πλήρη αναανάπτυξη:

npx rayfin up db apply

Εάν αλλάξατε μόνο τον κώδικα διεπαφής, αναπτύξτε ξανά τα στατικά στοιχεία:

npx rayfin up staticapp deploy

Αντιμετώπιση συνηθισμένων προβλημάτων

Η είσοδος αποτυγχάνει ή η ανάπτυξη επιστρέφει 401 ή 403

Εκτελέστε npx rayfin login ξανά και μετά δοκιμάστε npx rayfin upξανά.

Πρέπει να επιθεωρήσετε τι θα κάνει το CLI

Πριν από την ανάπτυξη αλλαγών, εκτελέστε npx rayfin up --dry-run.

Η εφαρμογή αναπτύσσεται, αλλά αλλάζετε μόνο το σχήμα

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

Επόμενα βήματα

  • Last updated on