Κοινή χρήση μέσω

Ρύθμιση λειτουργίας cloud φόρτου εργασίας

  • Άρθρο

Σε αυτό το άρθρο, μάθετε τις απαιτήσεις για την ανάπτυξη ενός φόρτου εργασίας που λειτουργεί σε έναν απομακρυσμένο διακομιστή με πρόσβαση στο Internet στο Microsoft Fabric.

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

  • Κώδικας προγράμματος-πελάτη φόρτου εργασίας: Κώδικας προσκηνίου που έχει ενσωματωθεί ως iFrame στο περιβάλλον εργασίας χρήστη του Microsoft Fabric.
  • Παρασκήνιο φόρτου εργασίας: Το στοιχείο παρασκηνίου, στην πλευρά του διακομιστή που επεξεργάζεται τον φόρτο εργασίας σας.

Αναπτύξτε και τα δύο στοιχεία ως υπηρεσίες cloud. Μπορείτε να φιλοξενήσετε τα δύο στοιχεία σε ξεχωριστούς διακομιστές, εάν είναι απαραίτητο.

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

Μορφή resourceId της εφαρμογής Microsoft Entra ID

Η τιμή της εφαρμογής resourceId Microsoft Entra ID πρέπει να έχει την εξής μορφή:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
  • Επαληθευμένος τομέας μισθωτή ISV: Μια ακριβής αντιστοίχιση του επαληθευμένου τομέα στον μισθωτή του εκδότη χωρίς προθήματα ή υποτομέα. Μάθετε πώς μπορείτε ναπροσθέσετε έναν προσαρμοσμένο τομέα στο Microsoft Entra.
  • Διακομιστής προσκηνίου φόρτου εργασίας: Το όνομα του διακομιστή προσκηνίου όπως εμφανίζεται στη διεύθυνση URL προσκηνίου (το επιπλέον τμήμα στη διεύθυνση URL προσκηνίου πάνω από τον επαληθευμένο τομέα).
  • Διακομιστής παρασκηνίου φόρτου εργασίας: Το όνομα του διακομιστή παρασκηνίου όπως εμφανίζεται στη διεύθυνση URL παρασκηνίου (το επιπλέον τμήμα στη διεύθυνση URL παρασκηνίου πάνω από τον επαληθευμένο τομέα).
  • Αναγνωριστικό φόρτου εργασίας: Το αναγνωριστικό φόρτου εργασίας όπως εμφανίζεται στη διακήρυξη φόρτου εργασίας.
  • Αναγνωριστικό πόρου: Μια προαιρετική συμβολοσειρά μπορεί να προστεθεί στο τέλος της τιμής resourceId .

Σημείωμα

  • *.onmicrosoft Οι υποτομέαι δεν επιτρέπονται σε διευθύνσεις URL.
  • Η προαιρετική συμβολοσειρά πρέπει να περιέχει αλφαριθμητικούς (Αγγλικούς) χαρακτήρες ή ενωτικά μόνο και δεν μπορεί να υπερβαίνει το μήκος των 36 χαρακτήρων.

Τομείς προσκηνίου και παρασκηνίου

  • Οι διευθύνσεις URL προσκηνίου και παρασκηνίου πρέπει να είναι υποτομέας της resourceId τιμής, με μέγιστο ένα επιπλέον τμήμα.
  • Ο τομέας κεντρικού υπολογιστή διεύθυνσης URL απάντησης πρέπει να είναι ίδιος με τον τομέα κεντρικού υπολογιστή προσκηνίου.

Παραδείγματα

  • Τιμή εφαρμογής resourceId Microsoft Entra ID: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
  • Τομέας προσκηνίου: https://feserver.datafactory.contoso.com
  • Τομέας παρασκηνίου: https://beserver.datafactory.contoso.com
  • URI ανακατεύθυνσης: https://feserver.datafactory.contoso.com/close

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

Για να ρυθμίσετε τις παραμέτρους των τελικών σημείων φόρτου εργασίας:

  1. Προσθέστε τη διεύθυνση URL παρασκηνίου του φόρτου εργασίας στην CloudServiceConfiguration ενότητα στη διακήρυξη και ονομάστε Workloadτην .

  2. Προσθέστε τη διεύθυνση URL προσκηνίου του φόρτου εργασίας στην CloudServiceConfiguration ενότητα στη διακήρυξη και ονομάστε την Frontend.

Ακολουθεί ένα παράδειγμα:

<CloudServiceConfiguration>
    <Cloud>Public</Cloud>
    ...
    <Endpoints>
        <ServiceEndpoint>
        <Name>Workload</Name>
        <Url>https://beserver.datafactory.contoso.com/workload</Url>
        </ServiceEndpoint>
        <ServiceEndpoint>
        <Name>Frontend</Name>
        <Url>https://feserver.datafactory.contoso.com</Url>
        </ServiceEndpoint>
    </Endpoints>
</CloudServiceConfiguration>

Ρύθμιση παραμέτρων της εφαρμογής σας στο Αναγνωριστικό Microsoft Entra

Για να ρυθμίσετε τις παραμέτρους της εφαρμογής σας στο Microsoft Entra:

  1. Η διεύθυνση URL ανακατεύθυνσης θα πρέπει να παραπέμπει στη διεύθυνση URL προσκηνίου προσαρτημένη με /closeτο . Για παράδειγμα, feserver.datafactory.contoso.com/close.
  2. Το URI αναγνωριστικού εφαρμογής θα πρέπει να συμφωνεί με τον επαληθευμένο τομέα της εφαρμογής σας.

Σημείωμα

Όλες οι άλλες ρυθμίσεις παραμέτρων εφαρμογών στο Microsoft Entra ID είναι ίδιες όπως στη λειτουργία προγραμματιστή.

Ρύθμιση παραμέτρων του φόρτου εργασίας σας (παρασκήνιο)

  1. Στο δείγμα παρασκηνίου, ανοίξτε το src/appsettings.json και ρυθμίστε τις παραμέτρους των παρακάτω ρυθμίσεων:

    • Για το PublisherTenantId, επιλέξτε το αναγνωριστικό μισθωτή του εκδότη.
    • Για το ClientId, εισαγάγετε το αναγνωριστικό της εφαρμογής σας (βρίσκεται στην επισκόπηση του Αναγνωριστικού Microsoft Entra).
    • Στο πεδίο ClientSecret, εισαγάγετε τον μυστικό κωδικό που δημιουργήσατε όταν ρυθμίσατε τις παραμέτρους της εφαρμογής Microsoft Entra ID.
    • Για το Audience, εισαγάγετε το URI αναγνωριστικού που ρυθμίσατε στην εφαρμογή Microsoft Entra ID.

  2. Ανοίξτε το src/Packages/manifest/WorkloadManifest.xml.

  3. Στην περιοχή AADApp, ορίστε AppIdτα , redirectUriκαι ResourceId (το URI αναγνωριστικού).

Σημειώστε τις απαιτήσεις που καθορίζονται στο αρχείο XSD και την επισκόπηση διακήρυξης παρασκηνίου.

Ρύθμιση παραμέτρων της εφαρμογής προσκηνίου

Στο αρχείο .env.test, ορίστε WORKLOAD_BE_URL τη διεύθυνση URL παρασκηνίου φόρτου εργασίας (για παράδειγμα, ορίστε τη σε beserver.datafactory.contoso.com).

Ακολουθεί ένα παράδειγμα:

WORKLOAD_NAME=Fabric.WorkloadSample
WORKLOAD_BE_URL=beserver.datafactory.contoso.com