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

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

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

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

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

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

Δημιουργία εφαρμογής με προτροπή AI

Χρησιμοποιήστε την ακόλουθη προτροπή με το GitHub Copilot ή άλλο παράγοντα κωδικοποίησης για να δημιουργήσετε, να εξερευνήσετε, να εκτελέσετε, να προσαρμόσετε και να αναπτύξετε μια εφαρμογή 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

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

Δημιουργία νέας εφαρμογής από το CLI

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

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

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

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

cd my-app

Συμβουλή

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

npx rayfin init .

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

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

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

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

Εκτέλεση της εφαρμογής τοπικά

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

npx rayfin dev

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

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

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

npx rayfin up

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

npx rayfin up --dry-run

Επαληθεύστε την ανάπτυξη

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

npx rayfin up status

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

npx rayfin up status --json

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

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

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

npx rayfin up db apply

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

npx rayfin up staticapp deploy

Προσθήκη συναρτήσεων

Οι συναρτήσεις είναι συναρτήσεις TypeScript που εκτελούνται στον διακομιστή μέσα στην εφαρμογή Fabric. Χρησιμοποιήστε συναρτήσεις για λογική που δεν πρέπει να εκτελούνται στο πρόγραμμα περιήγησης, όπως η εργασία με μυστικά, η πρόσβαση σε προνομιακά δεδομένα και η κλήση μεταγενέστερων υπηρεσιών για λογαριασμό του συνδεδεμένου χρήστη.

npx rayfin functions init

Το GitHub Copilot μπορεί να δημιουργήσει και να ενημερώσει τα απαιτούμενα αρχεία και στοιχεία. Μπορείτε επίσης να ζητήσετε από τον πράκτορα να εκτελέσει την εφαρμογή, να εντοπίσει σφάλματα στις λειτουργίες τοπικά και να αναπτύξει την εφαρμογή. Για παράδειγμα, μπορείτε να χρησιμοποιήσετε την ακόλουθη προτροπή για να δημιουργήσετε έναν βοηθό αναθεώρησης αιτήματος έλξης AI χρησιμοποιώντας συναρτήσεις:

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.

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

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

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

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

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

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

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

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

  • Τελευταία ενημέρωση στις