CI/CD Eventstream - Integrazione Git e Pipeline di Distribuzione

Questo articolo illustra il funzionamento delle pipeline di integrazione e distribuzione Git per Eventstream in Fabric. Informazioni su come sincronizzare un'area di lavoro con il repository Git, eseguire il commit degli elementi Eventstream in Git e distribuirli in aree di lavoro diverse.

La piattaforma Fabric offre pipeline di integrazione e distribuzione Git per diversi scenari:

  • Usare l'integrazione git per sincronizzare un'area di lavoro con un repository Git e gestire modifiche incrementali, collaborazione team, cronologia dei commit negli elementi eventstream.
  • Usare la pipeline di distribuzione per distribuire un'area di lavoro con elementi Eventstream in diversi ambienti di sviluppo, test e produzione.

Prerequisiti

Per accedere alle funzionalità CI/CD per Eventstream, è necessario soddisfare i requisiti seguenti:

  • Capacità di Fabric per l'uso di tutti gli oggetti supportati. Se non si ha ancora una sottoscrizione, iscriversi per ottenere una versione di valutazione gratuita.
  • L'integrazione git deve essere abilitata dal portale di amministrazione: gli utenti possono sincronizzare gli elementi dell'area di lavoro con i repository Git personali.
  • Accesso a un repository esistente da Azure DevOps o GitHub.
  • Si è un amministratore di un'area di lavoro infrastruttura.

Connettere un'area di lavoro a un repository Git

Solo un amministratore dell'area di lavoro può connettere un'area di lavoro a un repository, ma una volta effettuata la connessione, chiunque abbia l'autorizzazione può lavorare nell'area di lavoro. Se non si è un amministratore, chiedere assistenza all'amministratore per la connessione.

Per connettere un'area di lavoro a un repository Azure o GitHub, seguire questa procedura:

  1. Accedere a Fabric e passare all'area di lavoro con cui connettersi.

  2. Passare alle impostazioni dell'area di lavoro e selezionare Integrazione GitScreenshot che mostra la connessione di un'area di lavoro a Git.

  3. Scegliere un repository Git e immettere una cartella Git. Un'area di lavoro viene sincronizzata con una cartella Git. Screenshot che mostra l'immissione di una cartella Git con cui eseguire la sincronizzazione.

    L'integrazione git di Fabric supporta la sincronizzazione selettiva dei rami per ogni area di lavoro. Quando ci si connette, è possibile scegliere il ramo con cui eseguire la sincronizzazione ed è possibile cambiare rami in un secondo momento dalle impostazioni di integrazione git . Le aree di lavoro con rami sono chiaramente indicate nell'interfaccia utente, consentendo agli amministratori di gestire flussi di sviluppo paralleli tra i team.

  4. Dalla visualizzazione dell'area di lavoro viene visualizzato lo stato dell'elemento Eventstream come Sincronizzato. Screenshot che mostra lo stato git nell'area di lavoro.

Eseguire il commit delle modifiche di EventStream in Git

Dopo aver apportato modifiche all'elemento Eventstream, viene visualizzato lo stato Git di cui non è stato eseguito il commit accanto all'elemento Eventstream nella visualizzazione dell'area di lavoro. Selezionare il pulsante Source Control nella parte superiore della visualizzazione e scegliere l'elemento Eventstream su cui effettuare il commit.

Screenshot che mostra l'elemento eventstream di cui non è stato eseguito il commit nell'area di lavoro.

Prima di eseguire il commit, è possibile usare l'esperienza predefinita diff nel riquadro Controllo del codice sorgente per esaminare le modifiche a livello di elemento. Selezionare un elemento nella scheda Modifiche per confrontare la versione corrente dell'area di lavoro con l'ultima versione di cui è stato eseguito il commit, in modo da poter verificare le modifiche prima di eseguirne il push in Git.

Dopo aver sincronizzato l'elemento Eventstream, è possibile visualizzare la modifica eventstream più recente nel repository Git.

Screenshot che mostra la modifica più recente di Eventstream nel repository Git.

Aggiorna gli elementi Eventstream da Git

Se si apportano modifiche all'elemento Eventstream nel repository Git, viene visualizzato lo stato Git Update Required accanto all'elemento Eventstream nella visualizzazione dell'area di lavoro. Selezionare il pulsante Controllo origine nella parte superiore della visualizzazione e selezionare Aggiorna tutto per unire le modifiche più recenti di Eventstream. È anche possibile esaminare il diff per ogni elemento nella scheda Aggiornamenti prima di applicare le modifiche, assicurandosi di comprendere cosa verrà modificato nell'area di lavoro.

Screenshot che mostra gli elementi eventstream di aggiornamento da Git.

Distribuire elementi Eventstream da una fase a un'altra

  1. Nella visualizzazione area di lavoro selezionare Crea pipeline di distribuzione. È anche possibile creare una pipeline dal punto di ingresso delle pipeline di distribuzione in Fabric (nella parte inferiore dell'elenco di aree di lavoro). Screenshot che mostra dove creare una pipeline.
  2. È possibile definire il numero di fasi che deve avere e le operazioni da chiamare. Il numero di fasi è permanente e non può essere modificato dopo la creazione della pipeline.
  3. Assegnare un nome alla pipeline. La pipeline predefinita ha tre fasi denominate Sviluppo, Test e Produzione. È possibile rinominare le fasi e avere una posizione compresa tra 2 e 10 fasi in una pipeline. Selezionare quindi Crea e continua. Screenshot che mostra il nome di una pipeline e della fase.
  4. Dopo aver creato una pipeline, è possibile assegnare un'area di lavoro a ogni fase. Screenshot che mostra come assegnare un'area di lavoro a ogni fase.
  5. Dopo avere contenuto in una fase della pipeline, è possibile selezionare gli elementi e Distribuirlo nella fase successiva, anche se l'area di lavoro successiva include contenuto. Gli elementi associati vengono sovrascritti. Screenshot che mostra come distribuire il contenuto in diverse fasi.

È possibile esaminare la cronologia della distribuzione per visualizzare l'ultima distribuzione del contenuto in ogni fase. La cronologia della distribuzione è utile per stabilire quando è stato eseguito l'ultimo aggiornamento di una fase. Può anche essere utile se si vuole tenere traccia del tempo tra le distribuzioni.

Per altre informazioni sulla pipeline di distribuzione, vedere Introduzione alle pipeline di distribuzione

Supporto CI/CD per i componenti eventstream

Le funzionalità CI/CD di Fabric includono Integrazione Git, Pipeline di distribuzione e API pubbliche. Questa sezione descrive la compatibilità di vari componenti Eventstream con diverse funzionalità CI/CD. Comprendere questi livelli di supporto è essenziale per gestire e distribuire elementi Eventstream tra aree di lavoro.

È anche possibile usare le API Batch Import/Export Item Definitions (anteprima) per la sincronizzazione di elementi su larga scala. Gli elementi eventstream possono essere sincronizzati tramite queste API batch per semplificare le operazioni multi-area di lavoro o multi-ambiente. Vedere la documentazione dell'API per i limiti e i requisiti di autenticazione applicabili.

Definizioni del livello di supporto

  • Completamente supportato: la configurazione viene mantenuta completamente durante la distribuzione.
  • Parzialmente supportato: la risorsa supporta CI/CD, ma le impostazioni avanzate (ad esempio, l'elenco di esclusione di colonne del database SQL di Azure (CDC) non sono supportate e verranno ripristinate le impostazioni predefinite dopo la distribuzione.
  • Non supportato: il componente non supporta CI/CD tramite le pipeline di integrazione e distribuzione Git.

Matrice di supporto dei componenti

Categoria Completamente supportato Parzialmente supportato Non supportato
origini Origini GA standard (ad esempio, Hub eventi di Azure, Confluent, Dati di esempio) Database SQL di Azure (CDC)
Istanza gestita di Azure SQL (CDC)
Database MySQL (CDC)
PostgreSQL Banca dati CDC
SQL Server nella macchina virtuale (CDC)
Cribl (anteprima)
Eventi di rilevamento anomalie (anteprima)
Destinazioni Eventhouse
Lakehouse
Flusso derivato
Endpoint personalizzato
Activator
- Eventi aziendali (anteprima)
Notebook Spark (anteprima)
Operators Filter
Gestire i campi
Aggregate
Unisciti.
Raggruppa per
Union
Espandi
Codice SQL (codice personalizzato) -
Features Funzionalità generali (ad esempio, inferenza di più schemi) - Stato di Pausa/Ripresa

Importante

Dopo ci/cd (pipeline di integrazione e distribuzione Git), tutte le risorse nel flusso di eventi di destinazione diventano attive, a meno che non abbiano esito negativo a causa di problemi di connessione o configurazione. Le risorse nel flusso di eventi originale (esportato in Git) e nel flusso di eventi da distribuire mantengono i relativi stati.

Avvertimento

Quando si importa un'origine Griglia di eventi di Azure namespace, assicurarsi di avere autorizzazioni Membro o superiore nella workspace Fabric di destinazione. In caso contrario, richiedere le autorizzazioni di Collaboratore per l'entità servizio Event Grid prima di procedere.

Limitazione

  • L'integrazione git e la pipeline di distribuzione hanno un supporto limitato per scenari tra aree di lavoro. Per evitare problemi, assicurarsi che tutte le destinazioni Eventstream siano all'interno della stessa area di lavoro. La distribuzione tra aree di lavoro potrebbe non funzionare come previsto.
  • Se un eventstream include una destinazione eventhouse usando la modalità di inserimento diretto , sarà necessario riconfigurare manualmente la connessione dopo l'importazione o la distribuzione in una nuova area di lavoro.
  • Riferimenti alla connessione: è consigliabile usare gli elementi di riferimento alla connessione (libreria di variabili) per centralizzare e riassociare le connessioni durante la distribuzione di elementi Eventstream tra aree di lavoro. Questo approccio può ridurre la riconfigurazione manuale, ad esempio quando le destinazioni eventhouse usano l'inserimento diretto.