Condividi tramite


Ambiente di integrazione Git e pipeline di distribuzione

Questo articolo descrive come usare l'integrazione Git e le pipeline di distribuzione per l'ambiente in Microsoft Fabric.

Integrazione git per l'ambiente Microsoft Fabric

Microsoft Fabric supporta l'integrazione Git, consentendo agli sviluppatori di eseguire il backup, controllare le versioni, ripristinare le fasi precedenti e collaborare al proprio lavoro usando i rami Git.

Importante

Questa funzionalità è in anteprima.

Nota

  • Attualmente, Git supporta solo cataloghi e risorse di calcolo Spark, incluso il runtime di Spark.
  • L'integrazione Git gestisce lo stato di gestione temporanea dell'ambiente, per applicare le modifiche apportate in Git all'ambiente, queste ultime devono essere pubblicate. È consigliabile pubblicare dopo aver effettuato l'aggiornamento dell'ambiente da Git per garantire l'efficacia della configurazione. È possibile usare l'API di pubblicazione dell'ambiente per pubblicare le modifiche tramite l'API REST se si preferisce l'esperienza Code First.
  • Il pool personalizzato collegato persiste in un ambiente quando si esegue la sincronizzazione da un repository a un'area di lavoro di Fabric. La definizione del pool si trova nell'impostazione dell'area di lavoro e il riferimento tra aree di lavoro al pool non è supportato. È necessario aggiornare manualmente il instance_pool_id a un pool personalizzato esistente nello spazio dell'area di lavoro di destinazione o ripristinare il pool di avvio rimuovendo questa proprietà. È possibile fare riferimento a Pool personalizzati - Elenca pool personalizzati dell'area di lavoro per ottenere l'elenco completo dei pool disponibili nell'area di lavoro di destinazione dall'API REST oppure fare riferimento a Pool personalizzati - Creare un pool personalizzato dell'area di lavoro per creare un nuovo pool personalizzato.
  • Ogni commit ha un limite massimo di 150 MB. I cataloghi personalizzati di dimensioni superiori a 150 MB non sono attualmente supportati 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 alle impostazioni dell'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, sarà possibile trovare gli elementi, inclusi gli ambienti che si sincronizzano con il repository.

Screenshot dell'avvenuta 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 Cataloghi che contiene sottocartelle Cataloghi pubblici e Cataloghi personalizzati insieme alla cartella Impostazioni.

Screenshot della rappresentazione locale dell'ambiente in Git.

Librerie

Quando si esegue il commit di un ambiente in Git, la sezione del catalogo pubblico viene trasformata nella relativa rappresentazione YAML. Inoltre, viene eseguito il commit del catalogo personalizzato insieme al relativo file di origine.

Screenshot della rappresentazione locale del catalogo pubblico dell'ambiente in Git.

È possibile aggiornare il catalogo pubblico modificando la rappresentazione YAML. Proprio come per l'esperienza sul portale, è possibile specificare un catalogo da PyPI e conda. È possibile specificare il catalogo con la versione prevista, un intervallo di versioni o senza versione. Il sistema consente di determinare una versione compatibile con altre dipendenze nell'ambiente in uso. 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 per poter essere riconosciuto correttamente dal sistema.

Calcolo di Spark

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

Screenshot della rappresentazione locale del calcolo di Spark dell'ambiente in Git.

Pipeline di distribuzione per l'ambiente

Importante

Questa funzionalità è in anteprima.

Le pipeline di distribuzione di Fabric semplificano il processo di distribuzione del contenuto modificato nelle diverse fasi, 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. Ulteriori informazioni su Introduzione alle pipeline di distribuzione.

Screenshot dell'ambiente di distribuzione nella pipeline di distribuzione.

Dopo aver configurato correttamente la pipeline, è possibile trovare lo stato di distribuzione. Dopo aver fatto clic sul pulsante Distribuisci con 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, ciò significa che le configurazioni pubblicate rimangono nello stato pubblicato e non richiedono alcuna pubblicazione aggiuntiva.

Importante

  • Il pool personalizzato non è attualmente supportato nella pipeline di distribuzione. Se l'ambiente seleziona il pool personalizzato, le configurazioni della sezione Calcolo nell'ambiente di destinazione vengono impostate con i valori predefiniti. In questo caso, gli ambienti continuano a mostrare le differenze nella pipeline di distribuzione anche se la distribuzione viene eseguita correttamente.
  • L'uso delle regole di distribuzione per specificare pool diversi nella nuova area di lavoro verrà incluso nella versione futura.