Condividi tramite


Usare le pipeline di integrazione e distribuzione Git per gli ambienti

Questo articolo descrive come usare le pipeline di integrazione e distribuzione Git per gli ambienti in Microsoft Fabric.

Integrare Git per gli ambienti Fabric

Fabric supporta l'integrazione git. Gli sviluppatori possono usare Git per eseguire il backup, controllare le versioni, ripristinare le fasi precedenti e collaborare al lavoro usando i rami Git.

  • Git supporta attualmente solo librerie e risorse di calcolo Spark, incluso il runtime di Spark.
  • L'integrazione Git gestisce lo stato di preparazione dell'ambiente. Per applicare le modifiche apportate in Git all'ambiente, devono essere pubblicate. È consigliabile pubblicare dopo aver aggiornato l'ambiente da Git per garantire l'efficacia della configurazione. È possibile usare l'API Pubblica dell'ambiente per pubblicare le modifiche tramite l'API REST se si preferisce l'esperienza code-first.
  • Il pool personalizzato collegato viene mantenuto in un ambiente quando si sincronizza da un repository a un'area di lavoro Fabric. La definizione del pool si trova nell'impostazione dell'area di lavoro. Il riferimento incrociato tra aree di lavoro del pool non è supportato. È necessario aggiornare manualmente instance_pool_id a un pool personalizzato esistente nello spazio dell'area di lavoro di destinazione o ripristinare un pool di avvio rimuovendo questa proprietà. Per l'elenco completo dei pool disponibili nell'area di lavoro di destinazione dall'API REST, vedere Pool personalizzati - Elenca pool personalizzati dell'area di lavoro. Per creare un nuovo pool personalizzato, vedere Pool personalizzati - Creare un pool personalizzato dell'area di lavoro.
  • Ogni commit ha un limite massimo di 150 MB. Attualmente, le librerie personalizzate superiori a 150 MB non sono supportate tramite Git.

Connettere l'area di lavoro di Fabric a un repository di Azure DevOps

Se si è l'amministratore di un'area di lavoro, passare a Impostazioni area di lavoro e configurare la connessione nella sezione Controllo del codice sorgente . Per altre informazioni, vedere Gestire un'area di lavoro con Git.

Dopo la connessione, è possibile trovare elementi, inclusi gli ambienti sincronizzati con il repository.

Screenshot che mostra la connessione dell'area di lavoro a un repository Di Azure DevOps.

Rappresentazione locale di un ambiente su Git

Nella cartella radice dell'elemento gli ambienti sono organizzati con una cartella Libraries che contiene sottocartelle PublicLibraries e CustomLibraries insieme alla cartella Setting .

Screenshot che mostra la rappresentazione locale dell'ambiente in Git.

Librerie

Quando si esegue il commit di un ambiente in Git, la sezione della libreria pubblica viene trasformata nella relativa rappresentazione YAML. Viene eseguito anche il commit della libreria personalizzata insieme al relativo file di origine.

Screenshot che mostra la rappresentazione locale dell'ambiente della libreria pubblica in Git.

È possibile aggiornare il catalogo pubblico modificando la rappresentazione YAML. Proprio come l'esperienza del portale, è possibile specificare una libreria da PyPI e Conda. È possibile specificare la libreria con la versione prevista, un intervallo di versioni o senza una versione. Il sistema consente di determinare una versione compatibile con altre dipendenze nell'ambiente. Per cancellare tutti i cataloghi pubblici esistenti, eliminare il file YAML.

È possibile aggiornare il catalogo personalizzato aggiungendo nuovi file o eliminando direttamente i file esistenti.

Nota

È possibile usare il proprio file YAML personalizzato per gestire il catalogo pubblico. Il nome del file deve essere environment.yml in modo che il sistema possa riconoscerlo correttamente.

Calcolo di Spark

Anche la sezione di calcolo di Spark viene trasformata nella rappresentazione YAML. All'interno di questo file YAML è possibile cambiare il pool collegato, ottimizzare le configurazioni di calcolo, gestire le proprietà spark e selezionare il runtime spark desiderato.

Screenshot che mostra la rappresentazione locale di calcolo Spark dell'ambiente in Git.

Configurare una pipeline di distribuzione per un ambiente

Importante

Questa funzionalità è in anteprima.

Le pipeline di distribuzione del contenuto delle fabriche semplificano il processo di consegna del contenuto modificato attraverso diverse fasi, come ad esempio il passaggio dallo sviluppo al test. La pipeline automatica può includere gli elementi dell'ambiente per trasmettere il processo di nuova creazione.

È possibile configurare una pipeline di distribuzione assegnando le aree di lavoro a fasi diverse. Per altre informazioni, vedere Introduzione alle pipeline di distribuzione.

Screenshot che mostra la distribuzione di un ambiente in una pipeline di distribuzione.

Dopo aver configurato correttamente la pipeline, è possibile trovare lo stato di distribuzione. Dopo aver selezionato Distribuisci con l'ambiente selezionato, tutti i contenuti dell'ambiente vengono distribuiti nelle aree di lavoro di destinazione. Lo stato dell'ambiente originale viene mantenuto in questo processo in modo che le configurazioni pubblicate rimangano nello stato pubblicato e non richiedano alcuna pubblicazione aggiuntiva.

Importante

Attualmente, il pool personalizzato non è supportato nelle pipeline di distribuzione. Se l'ambiente seleziona il pool personalizzato, le configurazioni della sezione Calcolo nell'ambiente di destinazione vengono impostate con valori predefiniti. In questo caso, gli ambienti continuano a visualizzare le differenze nella pipeline di distribuzione anche se la distribuzione viene eseguita correttamente.