Configura l'integrazione Git per la tua app Fabric

L'integrazione con Git ti aiuta a mantenere la definizione deployabile della tua app Fabric nel controllo sorgente. Collega l'area di lavoro che contiene la tua app a un ramo del repository. Poi, conferma le modifiche dell'area di lavoro su Git oppure applica le modifiche da Git all'area di lavoro.

Questo articolo ti mostra come configurare la connessione, comprendere i file dell'app scritti nel repository e mantenere l'area di lavoro e Git sincronizzati.

Prerequisites

Prima di iniziare, assicurati di avere:

  • Un'area di lavoro sulla capacità Fabric che contiene un'app Fabric distribuita.
  • Il ruolo di Amministratore dell'area di lavoro. L'integrazione Git è un'impostazione a livello di spazio di lavoro e solo un amministratore di spazio di lavoro può collegarla a un repository.
  • Integrazione Git abilitata per la tua organizzazione. Esamina i prerequisiti di Fabric e Git.
  • Un'organizzazione, progetto e repository Azure DevOps, con il permesso di creare un branch e di effettuare commit delle modifiche.

I passaggi in questo articolo utilizzano Azure DevOps. GitHub è supportato anch'esso. Per le istruzioni di connessione GitHub, vedi Iniziare con l'integrazione Git.

Connettere l'area di lavoro a Git

Configura l'integrazione Git per l'intero spazio di lavoro, non per una singola app. La connessione include altri elementi supportati nell'area di lavoro.

  1. Apri l'area di lavoro che contiene la tua app e seleziona Impostazioni dell'area di lavoro.

  2. Nel riquadro a sinistra, seleziona Integrazione Git.

  3. Scegli Azure DevOps come provider di Git.

  4. Seleziona un account esistente, oppure seleziona Aggiungi account e autorizza l'accesso. Selezionare Connetti.

  5. Configura la connessione al repository:

    Setting Cosa selezionare
    Organizzazione L'organizzazione Azure DevOps che contiene il tuo repository.
    Project Il progetto che contiene il tuo repository.
    repository Git Il repository dove vuoi archiviare la definizione dell'app.
    Ramo Seleziona + New Branch per isolare il tuo lavoro, oppure seleziona un branch esistente.
    Cartella Inserisci un nome di cartella per utilizzare una cartella esistente o crearne una. Lascia questa opzione vuota per memorizzare gli elementi nella radice del repository.
  6. Selezionare Connettersi e sincronizzare.

Se la cartella Git collegata è vuota, la sincronizzazione iniziale invia in Git gli elementi dell'area di lavoro supportati, inclusa la definizione dell'app. Dopo che la sincronizzazione termina, l'area di lavoro mostra il ramo connesso e una colonna di stato Git . Lo stato della tua app è Sincronizzato quando la definizione dell'area di lavoro corrisponde alla versione Git collegata. Apri il repository in Azure DevOps per vedere la directory e i file generati dell'app.

Struttura dell'app Fabric in Git

Il seguente esempio mostra i file in una definizione di app esportata. Il tipo di elemento Fabric è AppBackend. L'esportazione include i file per i servizi opzionali solo quando li configuri e distribuisci o applichi il loro contenuto.

<ItemName>.<ItemType>\
    connectors\
        <connectorName>\
            dab-config.json
    data\
        dab-config.json
    frontend\
        static-app.zip
    functions\
        functions-app.zip
        deploymetadata.json
    storage\
        storage-config.json
    .fabric-app-metadata.json
    .platform
    rayfin.yml
File o cartella Che cosa contiene Modalità di gestione
connectors\<connectorName>\dab-config.json Configurazione dell'API dati per le entità esposte di un connettore. Mantieni il nome del connettore allineato con la sua dichiarazione e verifica gli ID degli spazi di lavoro e degli elementi riferiti per l'ambiente di destinazione.
data\dab-config.json Configurazione dell'API dati e schema del database per entità definite dall'utente. Preservare le estensioni dello schema generate e esaminare le modifiche allo schema prima della distribuzione.
frontend\static-app.zip Gli asset frontend costruiti, non il progetto sorgente del frontend. Ricostruisci dal sorgente. Includere questo bundle quando si importa una definizione con l'hosting statico abilitato.
functions\functions-app.zip Il pacchetto di distribuzione dell'app per le funzioni. Ricostruisci dal sorgente e includelo insieme a deploymetadata.json.
functions\deploymetadata.json Il manifest di distribuzione della funzione generata. Conserva questo file e mantienilo abbinato a functions-app.zip.
storage\storage-config.json Definizioni delle cartelle di archiviazione e regole di accesso. Conserva le regole generate e le definizioni dei campi. Gli oggetti caricati non sono inclusi.
.fabric-app-metadata.json Informazioni sulla versione del pacchetto generate dall'app, quando registrate. Questo file non è richiesto per l'importazione. Conserva questo file quando aggiorni una definizione esportata.
.platform Metadati dell'elemento Fabric e l'ID logico utilizzato dall'integrazione Git. Conserva i metadati generati e l'ID logico.
rayfin.yml Configurazione del servizio in runtime, dichiarazioni dei connettori e nomi segreti, senza valori segreti. Per dettagli di configurazione, consulta la struttura del progetto Fabric Apps.

Mantieni il nome della directory degli elementi generati quando modifichi la configurazione dell'app e non modificare l'ID logico in .platform. Fabric utilizza quell'ID per associare la definizione in Git all'elemento dell'area di lavoro. Per ulteriori informazioni, consulta formato di codice sorgente per integrazione Git.

Note

L'elemento esportato rayfin.yml rappresenta la configurazione in fase di esecuzione, non una copia del file rayfin/rayfin.yml del progetto locale. L'esportazione non ricostruisce percorsi locali, comandi di compilazione e impostazioni di sviluppo. Per la configurazione locale, consulta la struttura del progetto Fabric Apps.

Configurazione dati e connettori

Il data\dab-config.json file descrive le entità della tua app, i permessi API e lo schema del database. Esclude le impostazioni di connessione dati dell'ambiente sorgente e le entità gestite dalla piattaforma come Users. Il target fornisce il proprio servizio dati; le righe del database non vengono copiate.

Ogni connettore GraphQL configurato può avere un proprio connectors\<connectorName>\dab-config.json file, dove <connectorName> è il suo nome amichevole, come adventureWorksSql. Una dichiarazione di connettore senza configurazione di entità persistente potrebbe non contenere questo file. Applica la configurazione del connettore sulla sorgente prima di esportare se ti aspetti entità configurate. Per la configurazione del connettore, vedi Collega le app Fabric ai dati Fabric.

Caution

L'importazione applica modifiche allo schema del database al target target. Rimuovere o modificare entità o campi può essere distruttivo. Esamina le modifiche prima di distribuire; la definizione non è un backup del database.

Configurazione dell'archiviazione

Il storage\storage-config.json file definisce le cartelle di archiviazione e le loro regole di accesso, non gli oggetti caricati su di esse. Sia i servizi dati che quelli di storage devono essere abilitati per applicare questa configurazione.

Pacchetti frontend e di funzioni

I file ZIP contengono build deployabili, non file sorgente sparsi. Mantieni il codice sorgente originale dell'applicazione sotto controllo di versione così puoi rivedere le modifiche al codice e ricostruire i pacchetti.

L'esportazione frontend esclude i file rayfin.config.json e config.json specifici dell'ambiente. L'importazione rigenera la configurazione di runtime per il target target. Se l'hosting statico è abilitato ma la sorgente non dispone di un bundle frontend, distribuisci il frontend prima di esportare.

L'esportazione di funzioni rimuove local.settings.json i file. Fornire functions-app.zip e deploymetadata.json insieme, durante l'importazione, e preservare il manifest generato. Se nessuna app per le funzioni è stata fornita sulla sorgente, entrambi i file possono essere assenti.

Esamina i file di configurazione e i contenuti confezionati prima di confermare. Non includere credenziali o altri segreti.

Important

La definizione non trasferisce righe del database, oggetti di archiviazione caricati, account utente o valori segreti. Non è un backup dei dati della tua app.

Sincronizza le modifiche tra Fabric e Git

Le modifiche nell'area di lavoro e le modifiche in Git non si sincronizzano automaticamente dopo la connessione iniziale. Usa Source control per eseguire il commit delle modifiche dell'area di lavoro o applicare modifiche Git in entrata.

Important

Git memorizza nomi segreti, non valori. Dopo aver importato un'app o nuovi nomi segreti da Git, imposta i valori nell'app di destinazione. I valori segreti target esistenti vengono mantenuti.

Confermare le modifiche dell'area di lavoro in Git

  1. Aggiorna e distribuisci la tua app sull'area di lavoro collegata, ad esempio utilizzando la Rayfin CLI.
  2. Nell'area di lavoro, controlla la colonna stato Git . L'app mostra modifiche non sottoposte a commit quando la sua definizione cambia.
  3. Apri il Controllo Sorgente e seleziona Modifiche.
  4. Esamina e seleziona l'app e qualsiasi altro elemento che intendi includere nel commit.
  5. Inserisci un messaggio di commit e seleziona Commit.

Dopo che il commit ha avuto successo, gli elementi selezionati mostrano Sincronizzati.

Utilizzo con pipeline di distribuzione

L'integrazione Git gestisce le versioni della definizione dell'app. Per promuovere questa definizione tra gli spazi di sviluppo e test e di produzione, utilizza pipeline di distribuzione. Verifica le impostazioni dei connettori specifiche per ambiente prima della distribuzione e verifica l'app nell'area di lavoro di destinazione in seguito.

Important

Le pipeline di distribuzione copiano i nomi dei segreti, non i valori. Imposta i valori in ogni fase target dopo la prima distribuzione e ogni volta che distribuisci segreti appena aggiunti.

I valori segreti esistenti nell'app target vengono mantenuti. Esamina anche gli ID degli spazi di lavoro e degli elementi dei connettori e eventuali URI di reindirizzamento di autenticazione assoluta per l'ambiente di destinazione; copiare una definizione non garantisce che le dipendenze esterne vengano rimappate.

Automatizza con API pubbliche

Per workflow scriptati, usa Ottieni definizione elemento per esportare la definizione dell'app, Crea elemento con tipo AppBackend per creare un'app da una definizione, oppure Aggiorna definizione elemento per applicare una definizione a un elemento dell'app esistente.

Nelle richieste API, le parti di definizione utilizzano i payload InlineBase64. Codifica YAML e JSON come UTF-8 prima della codifica Base64 e codifica i file ZIP dai loro byte binari.

Queste API funzionano sulla definizione dell'elemento. Non creano commit Git, non sincronizzano un branch né gestiscono una pipeline di deployment. Esamina il formato delle richieste, i permessi e la gestione delle operazioni di lunga durata di ciascuna API prima di utilizzarla nell'automazione.