Creare un'app Fabric con l'interfaccia della riga di comando di Rayfin

Questa esercitazione illustra come usare l'interfaccia della riga di comando di Rayfin per creare un progetto, eseguirlo in locale e distribuirlo in Microsoft Fabric. Si usa lo stesso flusso di lavoro dell'interfaccia della riga di comando per le nuove app e per gli aggiornamenti successivi dello schema o del front-end.

In questa esercitazione, imparerai a:

  • Crea un progetto di app di Fabric da un modello.
  • Avviare l'app in locale.
  • Accedere a Microsoft Fabric dall'interfaccia della riga di comando.
  • Distribuire l'app in un'area di lavoro Fabric.
  • Verificare lo stato della distribuzione.

Prerequisiti

  • Accesso a Microsoft Fabric.
  • Area di lavoro Fabric in cui si dispone delle autorizzazioni Collaboratore, Membro o Amministratore.
  • Il carico di lavoro di Fabric Apps abilitato nel tenant.
  • Node.js e npm sono installati.

Se il carico di lavoro Fabric Apps non è ancora abilitato, chiedi a un amministratore di Fabric di attivare Fabric Apps (anteprima) nel portale di amministrazione Fabric.

Passaggio 1: Creare un nuovo progetto

Per eseguire lo scaffolding di una nuova app da un modello, usare npm create:

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

Questo comando crea una nuova cartella di progetto con il modello di app, la rayfin configurazione e il codice sorgente front-end.

Vai alla directory del progetto:

cd my-app

Suggerimento

Se hai già una cartella di progetto vuota o un codice sorgente esistente, usa npx rayfin init anziché npm create.

npx rayfin init .

Passaggio 2: Esaminare il progetto generato

Dopo la creazione della struttura iniziale del progetto, il progetto include i file necessari per iniziare lo sviluppo:

  • rayfin/rayfin.yml archivia i servizi app e le impostazioni di distribuzione.
  • rayfin/.env archivia i valori di ambiente usati dall'interfaccia della riga di comando.
  • rayfin/data/ contiene i file del modello di dati.
  • L'app frontend si trova nella struttura radice del progetto creata dal template selezionato.

Per una suddivisione dettagliata dei file per file, vedere Informazioni sulla struttura del progetto.

Passaggio 3: Eseguire l'app in locale

Avviare l'ambiente di sviluppo locale:

npm run dev

Questo comando avvia il server di sviluppo front-end per l'app con scaffolding e distribuisce il back-end in Fabric. Per confermare che l'app viene avviata correttamente, aprire l'URL locale visualizzato nel terminale.

Passaggio 4: Distribuire l'app in Fabric

Creare altre funzionalità nell'applicazione. Dopo aver testato le modifiche, eseguire di nuovo la distribuzione in Fabric.

npx rayfin up

Per visualizzare in anteprima la distribuzione senza apportare modifiche, eseguire:

npx rayfin up --dry-run

Passaggio 5: Verificare la distribuzione

Controllare lo stato di distribuzione corrente:

npx rayfin up status

Per una risposta leggibile dal computer, usare l'output JSON:

npx rayfin up status --json

Dopo aver completato la distribuzione, l'interfaccia della riga di comando stampa l'URL dell'app ospitata e il collegamento Fabric portale per l'elemento distribuito.

Passaggio 6: Distribuisci solo il database o i contenuti statici

Se sono stati modificati solo i modelli di dati, applicare le modifiche del database senza ridistribuire completamente:

npx rayfin up db apply

Se è stato modificato solo il codice front-end, ridistribuire gli asset statici:

npx rayfin up staticapp deploy

Risolvere i problemi comuni

L'accesso non funziona o la distribuzione restituisce 401 o 403

Eseguire npx rayfin login di nuovo, quindi riprovare npx rayfin up.

È necessario esaminare le operazioni che l'interfaccia della riga di comando eseguirà

Prima di distribuire le modifiche, eseguire npx rayfin up --dry-run.

L'app viene distribuita, ma modifichi solo lo schema

Per eseguire il push delle modifiche dello schema in modo indipendente, usare npx rayfin up db apply. Se si eseguono modifiche distruttive come la modifica del tipo di una colonna o la rimozione di una colonna, questo comando ha esito negativo. Per forzare le modifiche, è possibile usare il --force flag . Questa azione può essere una modifica che causa un'interruzione.

Passaggi successivi

  • Last updated on