Gestisci le pipeline tramite GitHub

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Source Control Management in Cloud Data Fusion consente di gestire le versioni della pipeline tramite i repository GitHub.

Integrando Cloud Data Fusion con GitHub puoi:

• Gestisci le tue pipeline in un repository Git centrale.
• Rivedi e controlla le modifiche della pipeline.
• Annulla le modifiche alla pipeline.
• Collaborare efficacemente con il team, garantendo al contempo il controllo centrale.

Prima di iniziare

Limitazioni

• Cloud Data Fusion supporta solo GitHub e non altri provider Git.
• OAuth non è supportato.
• Source Control Management offre scalabilità e supporto per le prestazioni ottimali nelle istanze abilitate per RBAC.
• Source Control Management supporta solo le pipeline in modalità batch.
• La gestione del controllo del codice sorgente non supporta le configurazioni delle pipeline.
• La dimensione predefinita del limite del repository collegato è 5 GB.

Nota: per connetterti a un server GitHub da un'istanza Cloud Data Fusion privata, devi configurare le impostazioni di rete per l'accesso alle origini pubbliche. Per ulteriori informazioni, consulta Creare un'istanza privata e Connettersi a una fonte pubblica da un'istanza privata.

Ruoli e autorizzazioni richiesti

Nota: i ruoli predefiniti di Cloud Data Fusion e le autorizzazioni correnti non coprono necessariamente le autorizzazioni read, write e update_repo_metadata nei repository Git di gestione del controllo del codice sorgente.

Operazione	datafusion.accessor	visualizzatore dati	datafusion.operator	datafusion.developer	editor datafusion.editor	datafusion.admin
Configura repository di controllo del codice sorgente	No	No	Sì	No	Sì	Sì
Esegui il push o il pull della pipeline dallo spazio dei nomi	No	No	Sì	Sì	Sì	Sì

Configura un repository Git

Cloud Data Fusion consente di configurare un repository Git per ogni spazio dei nomi. Dopo aver configurato il repository Git per uno spazio dei nomi, puoi eseguire il push delle pipeline distribuite dallo spazio dei nomi di Cloud Data Fusion al repository Git o eseguire il deployment delle pipeline dal repository Git allo spazio dei nomi di Cloud Data Fusion.

Puoi collegare un repository Git a più spazi dei nomi, ma uno spazio dei nomi può essere associato a un solo repository Git.

Collega un repository Git con uno spazio dei nomi

Per collegare un repository Git a uno spazio dei nomi, segui questi passaggi:

1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
2. Fai clic su Amministratore dello spazio dei nomi.
3. Nella pagina Amministratore dello spazio dei nomi, fai clic sulla scheda Gestione del controllo del codice sorgente.
4. Fai clic su Collega repository.

5. Inserisci i seguenti dettagli:

   • Provider (obbligatorio)
   • (Obbligatorio) URL repository
   • (Facoltativo) Ramo predefinito
   • (Facoltativo) Prefisso percorso
   • Tipo di autenticazione (obbligatorio)
   • Nome token (obbligatorio)
   • Token (obbligatorio)
   • (Facoltativo) Nome utente

   Per ulteriori informazioni sulla creazione di un repository Git, consulta la sezione Creare un repository.

   Per ulteriori informazioni sui token di accesso personali, consulta Creazione di un token di accesso personale e Creazione di un token di accesso personale granulare.

   Nota: consigliamo di utilizzare il token di accesso personale granulare GitHub, poiché alcuni ruoli possono accedere ai token salvati. Vedi Autorizzazioni e ruoli richiesti.

6. Fai clic su Convalida. Attendi che la connessione venga verificata.

7. Al termine della configurazione, fai clic su Salva e chiudi per confermare le modifiche alla configurazione.

Aggiorna la configurazione Git

Per aggiornare una configurazione Git esistente:

1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
2. Fai clic su Amministratore dello spazio dei nomi.
3. Nella pagina Amministratore dello spazio dei nomi, fai clic sulla scheda Gestione del controllo del codice sorgente.
4. Per la configurazione Git che vuoi aggiornare, fai clic su > Modifica.
5. Aggiorna i dettagli del repository Git in base alle tue esigenze e fai clic su Convalida.
6. Fai clic su Salva e chiudi per salvare la nuova configurazione.

Elimina la configurazione Git

Per eliminare la configurazione Git da uno spazio dei nomi, procedi nel seguente modo:

1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
2. Fai clic su Amministratore dello spazio dei nomi.
3. Nella pagina Amministratore dello spazio dei nomi, fai clic sulla scheda Gestione del controllo del codice sorgente.
4. Per la configurazione Git che vuoi eliminare, fai clic su > Elimina.

Sincronizza pipeline

Dopo aver configurato un repository Git con uno spazio dei nomi, puoi utilizzare l'opzione Sync Pipelines per eseguire il push delle pipeline da Cloud Data Fusion a GitHub o per il pull e il deployment di pipeline da GitHub a Cloud Data Fusion.

Esegui il push delle pipeline da Cloud Data Fusion a GitHub

Per sincronizzare una pipeline di cui è stato eseguito il deployment da uno spazio dei nomi a GitHub, segui questi passaggi:

1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
2. Fai clic su Amministratore dello spazio dei nomi.
3. Nella pagina Amministratore dello spazio dei nomi, fai clic sulla scheda Gestione del controllo del codice sorgente.
4. Trova il repository Git con cui vuoi effettuare la sincronizzazione e fai clic su Sync Pipelines (Sincronizza pipeline).
5. Fai clic sulla scheda Pipeline locali.

6. Cerca o seleziona la pipeline di cui vuoi eseguire il push a GitHub. Puoi eseguire il push di una sola pipeline alla volta.

   Se viene eseguito il push o il pull della versione più recente della pipeline da GitHub, lo stato Connesso a Git mostra Connected. Se la pipeline non è mai stata trasferita a GitHub, lo stato Connessione a Git è vuoto (-).

   Se esegui il deployment di una versione più recente di una pipeline già sincronizzata con GitHub, lo stato Connesso a Git passa da Connected a vuoto (-).

7. Fai clic su Invia al telecomando.

8. Inserisci un Messaggio di commit e fai clic su OK.

   Al termine della sincronizzazione, viene visualizzato un segno di spunta verde nella pagina Pipeline locali e lo stato Collegato a Git per la pipeline sottoposta a push mostra Connected. Il percorso del repository Git è collegato alla pipeline.

   Se il push non va a buon fine, controlla la pipeline in GitHub per verificare se è la versione più recente.

Puoi anche eseguire il push delle pipeline di cui è stato eseguito il deployment da uno spazio dei nomi a GitHub nei seguenti modi:

• Dalla pagina dei dettagli della pipeline

  1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
  2. Fai clic su List (Elenco).
  3. Fai clic sulla pipeline di cui vuoi eseguire il push a GitHub.
  4. Nella pagina dei dettagli della pipeline, fai clic su Azioni > Invia al telecomando.
  5. Inserisci un Messaggio di commit e fai clic su OK.

• Dalla pagina Elenco

  1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
  2. Fai clic su List (Elenco).
  3. Per la pipeline che vuoi eseguire il push a GitHub, fai clic su > Trasferisci al telecomando.
  4. Inserisci un Messaggio di commit e fai clic su OK.

Esegui il pull delle pipeline GitHub in Cloud Data Fusion

Se gestisci manualmente le versioni della pipeline in GitHub, puoi eseguire il deployment e la distribuzione delle pipeline GitHub in Cloud Data Fusion.

1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
2. Fai clic su Amministratore dello spazio dei nomi.
3. Nella pagina Amministratore dello spazio dei nomi, fai clic sulla scheda Gestione del controllo del codice sorgente.
4. Trova il repository Git con cui vuoi effettuare la sincronizzazione e fai clic su Sync Pipelines.
5. Fai clic sulla scheda Pipeline remote. Vengono visualizzate tutte le pipeline archiviate in GitHub.
6. Cerca o seleziona la pipeline da cui vuoi eseguire il pull da GitHub a Cloud Data Fusion. Puoi eseguire il pull di una sola pipeline alla volta.

7. Fai clic su Trascina allo spazio dei nomi.

   Cloud Data Fusion cerca i file JSON nel percorso configurato e ne esegue il pull e il deployment come pipeline in Cloud Data Fusion.

   Al termine della sincronizzazione, viene visualizzato un segno di spunta verde nella pagina Pipeline remote. Cloud Data Fusion esegue automaticamente il deployment della pipeline.

   Nota: se esegui il pull di una pipeline esistente in uno spazio dei nomi, viene creata una nuova versione con la configurazione creata da GitHub. Non viene creato un duplicato della pipeline.

   Per eseguire una pipeline, vai alla pagina Elenco, fai clic su Deployment eseguito ed eseguilo.

Puoi anche eseguire il pull delle pipeline remote da GitHub a uno spazio dei nomi utilizzando i seguenti metodi:

• Dalla pagina dei dettagli della pipeline

  1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
  2. Fai clic su List (Elenco).
  3. Fai clic sulla pipeline da cui vuoi eseguire il pull da GitHub.
  4. Nella pagina dei dettagli della pipeline, fai clic su Azioni > Trascina verso lo spazio dei nomi.

• Dalla visualizzazione List (Elenco).

  1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
  2. Fai clic su List (Elenco).
  3. Per la pipeline che vuoi estrarre da GitHub, fai clic su > Trascina verso lo spazio dei nomi.

• Pulsante

  1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Menu.
  2. Fai clic su List (Elenco).
  3. Fai clic su .
  4. Fai clic su Rimuovi dal telecomando.
  5. Cerca o seleziona la pipeline da cui vuoi eseguire il pull da GitHub a Cloud Data Fusion. Puoi eseguire il pull di una sola pipeline alla volta.
  6. Fai clic su Trascina allo spazio dei nomi.