Condividi tramite


DevGateway con Microsoft Fabric

DevGateway è un piccolo helper eseguito durante lo sviluppo per registrare l'istanza del carico di lavoro locale con Fabric. Indica al servizio Fabric dove è ospitato il front-end (DevServer in localhost) e quali elementi sono disponibili, in base ai manifesti. Con DevGateway in esecuzione, Fabric può caricare l'interfaccia utente in un iFrame e chiamare il devServer locale per leggere i metadati del prodotto e dell'elemento, senza pubblicare un pacchetto nel tenant.

Che cosa fa DevGateway

  • Registra un'istanza del carico di lavoro locale in un'area di lavoro specifica per lo sviluppatore attualmente connesso.
  • Informa Fabric sull'identità del carico di lavoro e sul punto di ingresso usando i manifesti.
  • Instrada le chiamate host dell'infrastruttura all'ambiente locale in modo che la piattaforma possa caricare il front-end e individuare gli elementi durante l'iterazione.
  • Lavora a stretto contatto con DevServer, che ospita effettivamente il front-end ed espone gli endpoint manifest.

Annotazioni

DevGateway non fornisce l'app Web né si rende visibile. Invece, registra la tua istanza locale e punta Fabric verso il tuo DevServer e i tuoi manifesti.

Come usa i manifesti nello sviluppo

Il carico di lavoro è guidato dal manifesto sia nello sviluppo sia nell'ambiente di produzione. Durante lo sviluppo:

  • DevGateway usa la configurazione locale per annunciare l'identità e i punti di ingresso del carico di lavoro, come definito nel manifesto del carico di lavoro.
  • Fabric chiama quindi il tuo DevServer per recuperare il product manifest e gli item manifest tramite endpoint locali (ad esempio, la route del /manifests del modello), in modo che il servizio possa eseguire il rendering della navigazione, delle piastrelle e della creazione di esperienze.

Questo rispecchia ciò che accade in fase di pubblicazione, ma tutto rimane locale per l'iterazione rapida.

Flusso di sviluppo tipico

  1. Avviare DevServer per ospitare il front-end in localhost.
  2. Avviare DevGateway e accedere con un utente amministratore dell'area di lavoro di destinazione.
  3. Apri l'area di lavoro Fabric e usa il punto di ingresso del carico di lavoro; Fabric carica l'interfaccia utente in un iFrame e individua gli elementi tramite i manifesti.
  4. Modificare i file dell'interfaccia utente e del manifesto, aggiornare per visualizzare immediatamente le modifiche.

Per istruzioni dettagliate sulla configurazione e sull'avvio, vedere l'esercitazione introduttiva .

Input di configurazione

A seconda del modello, DevGateway legge una configurazione locale che include:

  • Area di lavoro di destinazione per la registrazione
  • Endpoint locale del frontend (URL del DevServer)
  • Percorsi o riferimenti ai file manifest/asset utilizzati nella fase di sviluppo

Gli script di installazione/compilazione del repository generano o aggiornano automaticamente questa configurazione in modo che DevGateway e DevServer rimangano sincronizzati.

Suggerimenti per la risoluzione dei problemi

  • Se l'interfaccia utente non viene aperta in Fabric, assicurarsi di aver avviato sia DevGateway che DevServer e di aver eseguito l'accesso a un'area di lavoro in cui si dispone delle autorizzazioni necessarie.
  • Se Fabric non riesce a individuare gli elementi, verificare che l'endpoint dei manifesti di DevServer restituisca json valido e DevGateway punti il servizio all'URL localhost corretto.
  • Se mancano icone o stringhe, verificare i percorsi degli asset nei manifesti e che il DevServer li fornisca.

Vedere anche