Connettiti a un repository GitHub

Questa pagina spiega come connettere un repository GitHub a Cloud Build. Per saperne di più sui repository Cloud Build, consulta Repository Cloud Build.

Prima di iniziare

  • Enable the Cloud Build API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  • Prepara il codice sorgente in un repository GitHub.
  • Avere un Dockerfile o un file di configurazione Cloud Build nel repository di origine GitHub.
  • Se inizialmente connetti il repository a Cloud Build, assicurati di disporre delle autorizzazioni a livello di amministratore per il repository. Per saperne di più sulle autorizzazioni del repository GitHub, consulta Livelli di autorizzazione del repository per un'organizzazione.

  • Per utilizzare i comandi gcloud in questa pagina, installa Google Cloud CLI.

Connettiti a un repository GitHub

Per connettere il tuo repository GitHub a Cloud Build:

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repository

  2. Nel selettore di progetti nella barra superiore, seleziona il tuo progetto Google Cloud .

  3. Nella parte superiore della pagina, seleziona la scheda 1ª gen..

  4. Fai clic su Connetti repository.

    Viene visualizzato il riquadro Connetti repository.

    1. In Seleziona provider di gestione del codice sorgente, seleziona GitHub App GitHub di Cloud Build.

    2. Fai clic su Continua.

      Potrebbe esserti chiesto di autenticare la connessione a GitHub o di installare l'app GitHub. Se non l'hai ancora fatto, completa i seguenti passaggi:

      1. Se non hai mai eseguito l'accesso a GitHub, fallo ora.

        Viene visualizzata la pagina Autorizzazione, in cui autorizzi l'app Google Cloud Build a connettersi a Google Cloud.

        Screenshot del pulsante Autorizza

      2. Fai clic su Autorizza Google Cloud Build da GoogleCloudBuild.

      3. Fai clic su Installa Google Cloud Build.

      4. Nella finestra di dialogo visualizzata, seleziona il tuo nome utente o la tua organizzazione GitHub.

      5. Seleziona una delle seguenti opzioni in base alle esigenze della tua attività:

        • Tutti i repository: abilita i repository GitHub attuali e futuri per l'accesso utilizzando l'app Cloud Build

        • Solo repository selezionati: utilizza il menu a discesa Seleziona repository per attivare l'accesso solo a repository specifici utilizzando l'app Cloud Build.

        Puoi abilitare repository aggiuntivi in un secondo momento. Se selezioni Tutti i repository come opzione, l'app Cloud Build è autorizzata ad accedere a tutti i tuoi repository. Tuttavia, devi connettere ogni nuovo repository tramite Cloud Build seguendo i passaggi descritti in questa sezione.

      6. Fai clic su Installa per installare l'app Cloud Build.

        La finestra di dialogo si chiude e viene visualizzata la pagina Repository.

    3. Nella sezione Seleziona repository, seleziona i seguenti campi:

      • Account GitHub: l'account GitHub utilizzato per installare l'app GitHub di Cloud Build. Questo campo potrebbe essere preselezionato per te.

      • Repository: i repository che vuoi connettere a Cloud Build.

      Se non vedi uno o più dei tuoi repository di destinazione, fai clic su Modifica repository su GitHub per attivare repository aggiuntivi nell'app GitHub di Cloud Build. Puoi quindi selezionare il nuovo repository di destinazione nella sezione Seleziona repository.

    4. Dopo aver selezionato l'account e i repository GitHub, leggi il disclaimer per il consenso e seleziona la casella di controllo accanto per indicare che accetti i termini presentati.

    5. Fai clic su Connetti.

    6. (Facoltativo) Nella sezione Crea un trigger, seleziona i repository per cui vuoi creare un trigger nel campo Crea un trigger di esempio per questi repository. Dopo aver selezionato i repository, fai clic su Crea un attivatore.

    7. Fai clic su Fine.

(Facoltativo) Aggiornamento dell'account GitHub autenticato

Se devi aggiornare l'account GitHub associato al tuo Account Google, puoi andare alla pagina Autenticati con GitHub. Potresti doverlo fare se noti che la pagina Connetti repository di Cloud Build indica che l'app GitHub non è installata in alcun repository dopo l'installazione dell'app Cloud Build su GitHub.

Passaggi successivi