Deployment continuo da Git con Cloud Build

Puoi utilizzare Cloud Build per automatizzare le build e i deployment in Knative serving utilizzando il trigger di Cloud Build per creare ed eseguire automaticamente il deployment del codice ogni volta che viene eseguito il push di nuovi commit a un determinato ramo di un repository Git.

Quando utilizzi un trigger di Cloud Build per creare container, le informazioni sul repository di origine vengono visualizzate nella Google Cloud console per il tuo servizio dopo il deployment in Knative serving.

Prima di iniziare

  • Hai un repository Git con un Dockerfile o la tua codebase è scritta in uno dei linguaggi supportati da Google Cloud's buildpacks: Go, Node.js, Python, Java o .NET Core.

  • Abilita le API Cloud Build e Cloud Source Repositories.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin), che contiene l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

    Abilita le API

Configurare il deployment continuo dall'interfaccia utente di Knative serving

La procedura varia leggermente a seconda che tu stia configurando il deployment continuo su un nuovo servizio o su un servizio esistente. Fai clic sulla scheda appropriata per saperne di più.

Nuovo servizio

  1. Vai a Knative serving nella Google Cloud console:

    Vai a Knative serving

  2. Fai clic su Crea servizio.

  3. Compila le Impostazioni servizio con le tue preferenze.

  4. Fai clic su Avanti.

  5. Seleziona Esegui il deployment continuo di nuove revisioni da un repository codice sorgente.

    Configura con Cloud Build

  6. Fai clic su Configura con Cloud Build.

  7. Seleziona il provider e il repository.

    • GitHub : se non hai ancora eseguito l'autenticazione, fai clic su Autentica e segui le istruzioni. Per impostazione predefinita, la connessione di un repository viene eseguita tramite l'app Cloud Build GitHub. In alternativa, puoi eseguire il mirroring del repository GitHub in Cloud Source Repositories. Per farlo, fai clic su Opzione avanzata e seleziona Esegui il mirroring del repository GitHub utilizzando Cloud Source Repositories Scopri di più
    • Bitbucket : se non hai ancora eseguito l'autenticazione, fai clic su Autentica e segui le istruzioni.
    • Cloud Source Repositories

    Configura il deployment continuo - Passaggio 1

  8. Fai clic su Avanti.

  9. Compila le opzioni nel passaggio Configurazione build:

    • Ramo : indica l'origine da utilizzare quando viene eseguito il trigger. Puoi inserire l'regex qui. I rami corrispondenti vengono verificati automaticamente: puoi visualizzarli sotto l'input. Tieni presente che, se viene trovato esattamente un ramo, il trigger verrà eseguito automaticamente dopo la creazione.

    • Tipo di build

      • Se il repository deve essere creato utilizzando Docker e contiene un Dockerfile, seleziona Dockerfile. Posizione di origine indica la posizione e il nome del Dockerfile. Questa directory verrà utilizzata come contesto della build Docker. Tutti i percorsi devono essere relativi alla directory corrente.

      • In caso contrario, seleziona Buildpack Google Cloud. Utilizza Contesto buildpack per specificare la directory e Punto di ingresso (facoltativo) per fornire il comando per avviare il server. Esempio: gunicorn -p :8080 main:app per Python, java -jar target/myjar.jar per Java. Lascia vuoto per utilizzare il comportamento predefinito.

    Configura il deployment continuo, passaggio 2

  10. Fai clic su Salva.

  11. Verifica le impostazioni selezionate.

    Configurare la verifica del deployment continuo

  12. Fai clic su Crea.

  13. Tieni presente che verrai reindirizzato alla pagina Dettagli servizio, dove potrai monitorare l'avanzamento della configurazione del deployment continuo.

  14. Una volta completati tutti i passaggi, tieni presente le opzioni aggiuntive:

Servizio esistente

  1. Vai a Knative serving nella Google Cloud console:

    Vai a Knative serving

  2. Individua il servizio nell'elenco dei servizi e fai clic su di esso.

  3. Fai clic su Configura il deployment continuo.

  4. Seleziona il provider e il repository.

    • GitHub : se non hai ancora eseguito l'autenticazione, fai clic su Autentica e segui le istruzioni. Per impostazione predefinita, la connessione di un repository viene eseguita tramite l'app Cloud Build GitHub. In alternativa, puoi eseguire il mirroring del repository GitHub in Cloud Source Repositories. Per farlo, fai clic su Opzione avanzata e seleziona Esegui il mirroring del repository GitHub utilizzando Cloud Source Repositories Scopri di più
    • Bitbucket : se non hai ancora eseguito l'autenticazione, fai clic su Autentica e segui le istruzioni.
    • Cloud Source Repositories

    Configura il deployment continuo - Passaggio 1

  5. Fai clic su Avanti.

  6. Compila le opzioni nel passaggio Configurazione build:

    • Ramo : indica l'origine da utilizzare quando viene eseguito il trigger. Puoi inserire l'regex qui. I rami corrispondenti vengono verificati automaticamente: puoi visualizzarli sotto l'input. Tieni presente che, se viene trovato esattamente un ramo, il trigger verrà eseguito automaticamente dopo la creazione.

    • Tipo di build

      • Se il repository deve essere creato utilizzando Docker e contiene un Dockerfile, seleziona Dockerfile. Posizione di origine indica la posizione e il nome del Dockerfile. Questa directory verrà utilizzata come contesto della build Docker. Tutti i percorsi devono essere relativi alla directory corrente.

      • In caso contrario, seleziona Buildpack Google Cloud. Utilizza Contesto buildpack per specificare la directory e Punto di ingresso (facoltativo) per fornire il comando per avviare il server. Esempio: gunicorn -p :8080 main:app per Python, java -jar target/myjar.jar per Java. Lascia vuoto per utilizzare il comportamento predefinito.

    Configura il deployment continuo, passaggio 2

  7. Fai clic su Salva.

  8. La pagina si ricarica e mostra l'avanzamento della configurazione del deployment continuo.

  9. Una volta completati tutti i passaggi, tieni presente le opzioni aggiuntive:

Configurare manualmente il deployment continuo

Consulta la sezione Configurare manualmente il deployment continuo se devi utilizzare una procedura manuale e non l'interfaccia utente.

Collegare il trigger di Cloud Build esistente al servizio Knative serving.

Se hai già un trigger di Cloud Build, puoi collegarlo al servizio e sfruttare le funzionalità della Google Cloud console nella pagina dei dettagli del servizio: Modifica il deployment continuo e il grafico Cronologia build.

Per farlo, devi aggiungere un'etichetta con gcb-trigger-id come chiave e l'identificatore univoco del trigger di Cloud Build come valore (non il nome del trigger ). Consulta le istruzioni per configurare l'etichetta.