Connettiti a un repository Git di terze parti

Questo documento mostra come collegare un repository remoto a un repository Dataform. Dopo aver collegato i repository, le modifiche apportate in un workspace di sviluppo Dataform possono essere inviate e recuperate dal repository Git remoto.

Puoi connettere un repository remoto tramite HTTPS o SSH.

Nella tabella seguente sono elencati i fornitori Git supportati e i metodi di connessione disponibili per i relativi repository:

Provider Git	Metodo di connessione
Azure DevOps Services	SSH
Bitbucket	SSH
GitHub	SSH o HTTPS
GitLab	SSH o HTTPS

Nota: la connessione di un repository Dataform a un repository remoto può non riuscire se il repository remoto non è aperto alla rete internet pubblica, ad esempio se si trova dietro un firewall. Puoi compilare il modulo di lista d'attesa per gli intervalli IP di uscita di Dataform per iscriverti per ricevere aggiornamenti sugli indirizzi IP di uscita coerenti in Dataform, che consentono le connessioni ai repository remoti protetti.

Prima di iniziare

1. Se la tua organizzazione o il tuo progetto limita i repository Git remoti con i criteri dell'organizzazione dataform.restrictGitRemotes, assicurati che il repository Git remoto sia aggiunto alla lista consentita nei criteri prima di creare un repository Dataform da collegare a un repository remoto. Per ulteriori informazioni, consulta Limitare i repository remoti.
2. Seleziona o crea un repository Dataform. Ti servirà in un secondo momento per condividere un secret con il tuo account di servizio Dataform predefinito.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per connettere un repository Dataform a un repository Git remoto, chiedi all'amministratore di concederti il ruolo IAM Amministratore Dataform (roles/dataform.admin) nei repository. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Connetti un repository remoto tramite SSH

Per connettere un repository remoto tramite SSH, devi generare una chiave SSH e un segreto di Secret Manager. La chiave SSH è composta da una chiave SSH pubblica e una chiave SSH privata. Devi condividere la chiave SSH pubblica con il tuo provider Git e creare un secret di Secret Manager con la chiave SSH privata. Poi, condividi il secret con il tuo account di servizio Dataform predefinito.

Dataform utilizza il secret con la chiave SSH privata per accedere al tuo provider Git e committare le modifiche per conto degli sviluppatori. Dataform esegue questi commit utilizzando l' Google Cloud indirizzo email dello sviluppatore, in modo da poter capire chi ha eseguito ogni commit.

Avviso: la chiave SSH privata è condivisa tra tutti gli utenti di Dataform che utilizzano l'account di servizio corrispondente. Ti consigliamo di creare un utente macchina con il tuo provider Git e di limitarne l'accesso ai repository Git remoti che intendi utilizzare con Dataform. Solo i Google Cloud proprietari dei progetti e gli utenti di Dataform con il ruolo Amministratore Dataform possono utilizzare la chiave per collegare i repository. Gli utenti di Dataform non sono in grado di vedere la chiave stessa.

Per collegare un repository remoto a un repository Dataform tramite SSH:

1. Nel tuo provider Git:

   Azure DevOps Services

   1. In Azure DevOps Services, crea una chiave SSH privata.
   2. Carica la chiave SSH pubblica nel tuo repository di Azure DevOps Services.

   Bitbucket

   1. In Bitbucket, crea una chiave SSH privata.
   2. Carica la chiave pubblica SSH nel tuo repository Bitbucket.

   GitHub

   1. In GitHub, crea una chiave SSH privata.
   2. Carica la chiave SSH pubblica di GitHub nel tuo repository GitHub.

   GitLab

   1. In GitLab, crea una chiave SSH privata.
   2. Carica la chiave SSH pubblica di GitLab nel tuo repository GitLab.

2. In Secret Manager, crea un secret e imposta la chiave SSH privata come valore del secret.

   1. Concedi l'accesso al secret al tuo account di servizio Dataform predefinito.

      Il tuo account di servizio Dataform predefinito ha il seguente formato:

      [e-mail]
      

   2. Concedi il ruolo roles/secretmanager.secretAccessor all'account di servizio.

3. Nella console Google Cloud, vai alla pagina Dataform.

   Vai a Dataform

4. Seleziona il repository Dataform da collegare al repository remoto.

5. Nella pagina del repository, fai clic su Impostazioni > Connetti con Git.

6. Nel riquadro Collega al repository remoto, nel campo URL repository Git remoto, inserisci l'URL del repository Git remoto che termina con .git.

   L'URL del repository Git remoto deve essere in uno dei seguenti formati:

   • URL assoluto: ssh://git@{host_name}[:{port}]/{repository_path}, port è facoltativo.
   • URL simile a SCP: git@{host_name}:{repository_path}.

7. Nel campo Nome del ramo remoto predefinito, inserisci il nome del ramo di sviluppo principale del repository Git remoto.

8. Nel menu a discesa Secret, seleziona il secret per il repository Git remoto.

9. Nel campo Valore chiave host pubblica SSH, inserisci la chiave host pubblica del tuo provider Git.

   Azure DevOps Services

   Il valore della chiave host pubblica SSH deve essere nel formato di un file known_hosts. Il valore deve contenere un algoritmo e una chiave pubblica codificati nel formato base64, ma senza il nome host o l'IP, nel seguente formato:

   ALGORITHM BASE64_KEY_VALUE
   

   Per recuperare la chiave host pubblica di Azure DevOps Services, esegui il comando ssh-keyscan -t rsa ssh.dev.azure.com nel terminale.

   Bitbucket

   Il valore della chiave host pubblica SSH deve essere nel formato di un file known_hosts. Il valore deve contenere un algoritmo e una chiave pubblica codificati nel formato base64, ma senza il nome host o l'IP, nel seguente formato:

   ALGORITHM BASE64_KEY_VALUE
   

   Per recuperare la chiave host pubblica di Bitbucket, consulta Configurare SSH.

   GitHub

   Il valore della chiave host pubblica SSH deve essere nel formato di un file known_hosts. Il valore deve contenere un algoritmo e una chiave pubblica codificati nel formato base64, ma senza il nome host o l'IP, nel seguente formato:

   ALGORITHM BASE64_KEY_VALUE
   

   Per recuperare la chiave host pubblica di GitHub, consulta Le impronte delle chiavi SSH di GitHub.

   GitLab

   Il valore della chiave host pubblica SSH deve essere nel formato di un file known_hosts. Il valore deve contenere un algoritmo e una chiave pubblica codificati nel formato base64, ma senza il nome host o l'IP, nel seguente formato:

   ALGORITHM BASE64_KEY_VALUE
   

   Per recuperare la chiave host pubblica di GitLab, consulta Esenzioni known_hosts SSH.

10. Fai clic su Collega.

Connetti un repository remoto tramite HTTPS

Per collegare un repository remoto tramite HTTPS, devi creare un secret di Secret Manager con un token di accesso personale e condividerlo con il tuo account di servizio Dataform predefinito.

Dataform utilizza quindi il token di accesso per accedere al provider Git e committare le modifiche per conto degli sviluppatori. Dataform esegue questi commit utilizzando l' Google Cloud indirizzo email dello sviluppatore, in modo da poter capire chi ha eseguito ogni commit.

Avviso: il token di accesso è condiviso tra tutti gli utenti di Dataform che utilizzano l'account di servizio corrispondente. Ti consigliamo di creare un utente della macchina con il tuo provider Git e di limitarne l'accesso ai repository Git remoti che intendi utilizzare con Dataform. Solo i Google Cloud proprietari dei progetti e gli utenti di Dataform con il ruolo di Amministratore Dataform possono utilizzare il token per collegare i repository. Gli utenti di Dataform non possono vedere il token stesso.

Per collegare un repository remoto a un repository Dataform tramite HTTPS:

1. Nel tuo provider Git:

   GitHub

   1. In GitHub, crea un token di accesso personale granulare o un token di accesso personale classico.

      • Per un token di accesso personale GitHub granulare:

      1. Seleziona l'accesso ai repository solo per alcuni repository, quindi seleziona il repository a cui vuoi connetterti.

      2. Concedi l'accesso in lettura e scrittura ai contenuti del repository.

      3. Imposta una scadenza del token appropriata alle tue esigenze.

      • Per un token di accesso personale GitHub classico:

      1. Concedi a Dataform l'autorizzazione repo.

      2. Imposta una scadenza del token appropriata alle tue esigenze.

   2. Se la tua organizzazione utilizza il Single Sign-On (SSO) SAML, autorizza il token.

   GitLab

   1. In GitLab, crea un token di accesso personale GitLab.

   2. Assegna il nome dataform al token.

      Il token di accesso personale di GitLab deve avere il nome dataform.

   3. Concedi a Dataform le autorizzazioni api, read_repository e write_repository.

   4. Imposta una scadenza del token appropriata alle tue esigenze.

2. In Secret Manager, crea un secret contenente il token di accesso personale del tuo repository remoto.

3. Concedi l'accesso al secret al tuo account di servizio Dataform predefinito.

   Il tuo account di servizio Dataform predefinito ha il seguente formato:

   [e-mail]
   

   1. Concedi il ruolo roles/secretmanager.secretAccessor all'account di servizio.

4. Nella console Google Cloud, vai alla pagina Dataform.

   Vai a Dataform

5. Seleziona il repository Dataform da collegare al repository remoto.

6. Nella pagina del repository, fai clic su Impostazioni > Connetti con Git.

7. Nel riquadro Collega al repository remoto, nel campo URL repository Git remoto, inserisci l'URL del repository Git remoto che termina con .git.

   L'URL del repository Git remoto non può contenere nomi utente o password.

8. Nel campo Nome del ramo remoto predefinito, inserisci il nome del ramo di sviluppo principale del repository Git remoto.

9. Nel menu a discesa Secret, seleziona il secret per il repository Git remoto.

10. Fai clic su Collega.

Modificare la connessione al repository remoto

Per modificare una connessione tra un repository Dataform e un repository Git remoto:

1. Nella console Google Cloud, vai alla pagina Dataform.

   Vai a Dataform

2. Fai clic sul repository che vuoi modificare.

3. Nella pagina del repository, fai clic su Impostazioni > Modifica connessione Git.

4. Nel riquadro Collega al repository remoto, modifica le impostazioni di connessione.

5. Fai clic su Aggiorna.

Passaggi successivi

• Per scoprire di più sui repository Dataform, consulta Creare un repository.

• Per creare uno spazio di lavoro di sviluppo, consulta Creare uno spazio di lavoro.

• Per scoprire come risolvere i problemi relativi alle connessioni dei repository remoti, consulta Risolvere i problemi di Dataform.