Creare e gestire i deployment

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Nota: per fornire feedback o porre domande relative a questa funzionalità di anteprima, contatta [e-mail].

I deployment consentono di pianificare l'esecuzione del codice, ad esempio le pipeline, archiviato in repository Git remoti. Puoi scegliere la directory in cui si trova il codice ed eseguire le seguenti azioni:

• Crea e gestisci i deployment connessi ai repository remoti.
• Configura i trigger per eseguire il pull del codice dai repository remoti ed eseguirlo regolarmente.
• Esegui le pipeline in base a una pianificazione o con altri trigger.
• Visualizza i log delle esecuzioni direttamente nella Google Cloud console. Per gli avvisi, i deployment di Dataform si integrano con Cloud Logging e Cloud Monitoring.

Limitazioni

• I deployment non hanno avvisi integrati. Devi utilizzare Logging e Monitoring per configurare gli avvisi.
• L'autenticazione con Developer Connect supporta solo le connessioni e non i connettori di account.

Prima di iniziare

Prima di creare un deployment, completa le seguenti attività:

• Attiva l'utilizzo della pagina Pipeline e connessioni nella Google Cloud console.

• Abilita l'API BigQuery, l'API Dataform e l'API Developer Connect:

  Abilita le API

• Connetti un repository remoto utilizzando Developer Connect.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare le attività descritte in questo documento, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Amministratore Dataform (roles/dataform.admin) sul progetto
• Utente job BigQuery (roles/bigquery.jobUser) sul progetto
• Visualizzatore Developer Connect (roles/developerconnect.viewer) sul progetto
• Utilizza un account di servizio personalizzato per eseguire un deployment: Utente account di servizio (roles/iam.serviceAccountUser) sull'account di servizio personalizzato

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

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

Per utilizzare un account di servizio personalizzato per eseguire un deployment, devi anche concedere il ruolo Editor dati BigQuery (roles/bigquery.dataEditor) all'account di servizio personalizzato.

Crea un deployment

Per creare un deployment di Dataform:

1. Nella Google Cloud console, vai alla pagina Pipeline e connessioni.

   Vai a Pipeline e connessioni

2. Fai clic su Crea > Crea deployment.

3. Seleziona un tipo di autenticazione del repository, quindi seleziona una delle seguenti opzioni:

   Developer Connect

   1. Seleziona un repository e un branch.
   2. Inserisci il percorso della directory in cui si trova il codice.
   3. Inserisci un nome per il deployment.
   4. Seleziona una regione per il deployment.

   5. Nella sezione Frequenza di pianificazione, segui questi passaggi:

      1. Nel menu Ripeti, seleziona la frequenza delle esecuzioni pianificate della pipeline.
      2. Nel campo All'ora, inserisci l'ora delle esecuzioni pianificate della pipeline.
      3. Nel menu Fuso orario, seleziona il fuso orario per la pianificazione.

      In alternativa, seleziona On demand per eseguire il deployment on demand.

   6. (Facoltativo) Inserisci l'ID progetto Google Cloud .

   7. (Facoltativo) Inserisci un suffisso dello schema.

   8. (Facoltativo) Inserisci un prefisso della tabella.

   9. (Facoltativo) Inserisci lo schema predefinito.

   10. (Facoltativo) Inserisci le variabili di compilazione.

   11. Fai clic su Esegui il deployment.

   HTTPS

   1. Inserisci l'URL del repository Git remoto.
   2. Seleziona un branch.
   3. Inserisci il percorso della directory in cui si trova il codice.
   4. Inserisci il secret contenente il token di accesso personale per gli oggetti "remote" HTTPS. Per saperne di più, consulta Connetti un repository remoto tramite HTTPS.
   5. Inserisci un nome per il deployment.
   6. Seleziona una regione per il deployment.

   7. Nella sezione Frequenza di pianificazione, segui questi passaggi:

      1. Nel menu Ripeti, seleziona la frequenza delle esecuzioni pianificate della pipeline.
      2. Nel campo All'ora, inserisci l'ora delle esecuzioni pianificate della pipeline.
      3. Nel menu Fuso orario, seleziona il fuso orario per la pianificazione.

      In alternativa, seleziona On demand per eseguire il deployment on demand.

   8. (Facoltativo) Inserisci l'ID progetto Google Cloud .

   9. (Facoltativo) Inserisci un suffisso dello schema.

   10. (Facoltativo) Inserisci un prefisso della tabella.

   11. (Facoltativo) Inserisci lo schema predefinito.

   12. (Facoltativo) Inserisci le variabili di compilazione.

   13. Fai clic su Esegui il deployment.

   SSH

   1. Inserisci l'URL del repository Git remoto.
   2. Seleziona un branch.
   3. Inserisci il percorso della directory in cui si trova il codice.
   4. Inserisci il secret contenente una chiave privata dell'utente e il valore della chiave host pubblica SSH. Per saperne di più, consulta Connetti un repository remoto tramite SSH.
   5. Inserisci un nome per il deployment.
   6. Seleziona una regione per il deployment.

   7. Nella sezione Frequenza di pianificazione, segui questi passaggi:

      1. Nel menu Ripeti, seleziona la frequenza delle esecuzioni pianificate della pipeline.
      2. Nel campo All'ora, inserisci l'ora delle esecuzioni pianificate della pipeline.
      3. Nel menu Fuso orario, seleziona il fuso orario per la pianificazione.

      In alternativa, seleziona On demand per eseguire il deployment on demand.

   8. (Facoltativo) Inserisci l'ID progetto Google Cloud .

   9. (Facoltativo) Inserisci un suffisso dello schema.

   10. (Facoltativo) Inserisci un prefisso della tabella.

   11. (Facoltativo) Inserisci lo schema predefinito.

   12. (Facoltativo) Inserisci le variabili di compilazione.

   13. Fai clic su Esegui il deployment.

Elenca implementazioni

Per elencare i deployment creati:

1. Nella Google Cloud console, vai alla pagina Pipeline e connessioni.

   Vai a Pipeline e connessioni

2. Visualizza l'elenco dei deployment.

Crea una pianificazione del deployment

Per creare una pianificazione per un deployment:

1. Nella Google Cloud console, vai alla pagina Pipeline e connessioni.

   Vai a Pipeline e connessioni

2. Fai clic sulla scheda Deployment, quindi seleziona un deployment.

3. Nella pagina Dettagli deployment, nella sezione Trigger (configurazioni del flusso di lavoro), fai clic su Crea.

4. Nel riquadro Crea configurazione del flusso di lavoro, segui i passaggi per creare una configurazione del flusso di lavoro.

Esegui una pianificazione del deployment

Per eseguire una pianificazione per un deployment:

1. Nella Google Cloud console, vai alla pagina Pipeline e connessioni.

   Vai a Pipeline e connessioni

2. Fai clic sulla scheda Deployment , quindi seleziona un deployment.

3. Nella sezione Trigger (configurazioni del flusso di lavoro), accanto alla pianificazione del deployment che vuoi eseguire, fai clic su Visualizza azioni > Esegui ora.

Elimina una pianificazione del deployment

Per eliminare una pianificazione per un deployment:

1. Nella Google Cloud console, vai alla pagina Pipeline e connessioni.

   Vai a Pipeline e connessioni

2. Fai clic sulla scheda Deployment, quindi seleziona un deployment.

3. Nella pagina Dettagli deployment, nella sezione Trigger (configurazioni del flusso di lavoro), accanto alla pianificazione del deployment che vuoi eliminare, fai clic su Visualizza azioni > Elimina.

Configura avvisi

Per ricevere notifiche quando l'esecuzione di un flusso di lavoro non riesce, configura gli avvisi per le chiamate del flusso di lavoro non riuscite.

Passaggi successivi

• Scopri come creare un repository.
• Scopri come pianificare le esecuzioni.
• Scopri come configurare gli avvisi.