Mirroring di un repository GitHub

Questo argomento descrive come eseguire il mirroring di un repository GitHub in Cloud Source Repositories. Con questa configurazione, i commit di cui esegui il push nel repository GitHub vengono copiati o con mirroring in un repository ospitato in Cloud Source Repositories.

Solo i repository Bitbucket Cloud e GitHub Cloud possono essere sottoposti a mirroring in Cloud Source Repositories; il mirroring Bitbucket e GitHub ospitato autonomamente non sono supportati.

Se esegui il mirroring del tuo repository GitHub in Cloud Source Repositories per l'integrazione con Cloud Build e non hai bisogno di altre funzionalità di Cloud Source Repositories, segui invece le istruzioni di Cloud Build sulla creazione di repository da GitHub.

Prima di iniziare

Quando esegui il mirroring di un repository, devi fornire credenziali di autenticazione GitHub. Queste credenziali consentono a Cloud Source Repositories di accedere ai contenuti del repository GitHub.

Se utilizzi organizzazioni GitHub, ti consigliamo di utilizzare un account utente della macchina dedicato alle attività automatizzate, come il mirroring di un repository. Questo account deve avere accesso amministrativo al repository.

Esegui il mirroring di un repository GitHub

Questa sezione mostra come eseguire il mirroring di un repository GitHub in Cloud Source Repositories.

Crea un repository con mirroring

In questo processo, sono necessarie le credenziali utente della macchina GitHub per concedere a Google Cloud l'accesso in lettura al repository GitHub.

  1. Nella console Google Cloud, apri Cloud Source Repositories.

    Apri Cloud Source Repositories

  2. Fai clic su Aggiungi repository.

    Viene visualizzata la pagina Aggiungi un repository.

  3. Seleziona Connetti repository esterno e fai clic su Continua.

    Si apre la pagina Connetti repository esterno.

  4. Nell'elenco a discesa Progetto, seleziona il progetto Google Cloud a cui appartiene il repository con mirroring.

    Se non hai un progetto, puoi fare clic su Crea progetto per crearne uno.

  5. Nell'elenco a discesa Git provider, seleziona GitHub.

  6. Seleziona la casella di controllo per autorizzare Cloud Source Repositories ad archiviare le tue credenziali.

  7. Fai clic su Connetti a GitHub.

  8. Accedi a GitHub con le credenziali utente della tua macchina.

  9. Fai clic su Autorizza GoogleCloudPlatform.

    Questa opzione concede a Google Cloud l'accesso in lettura a tutti i repository nell'account utente GitHub.

    Al termine dell'autorizzazione, si aprirà la pagina Connetti repository esterno. Si apre un elenco di repository.

  10. Dall'elenco dei repository, seleziona quello di cui vuoi eseguire il mirroring.

  11. Fai clic su Connetti il repository selezionato.

    Si apre la pagina del repository principale. Questa pagina contiene un elenco dei repository per questo progetto Google Cloud, compreso il nuovo repository appena creato.

Identifica i repository GitHub

Cloud Source Repositories chiarisce quali dei tuoi repository sono specchi dei repository GitHub:

  • Ogni repository GitHub è rappresentato dal logo GitHub.
  • All'inizio del nome del repository è stato aggiunto github_.

Forza la sincronizzazione di un repository

Dopo aver configurato il mirroring, Cloud Source Repositories sincronizza automaticamente il repository con il repository sottoposto a mirroring quando un utente esegue il commit di una modifica. Cloud Source Repositories consente di visualizzare l'ultima volta che il repository con mirroring è stato sincronizzato e di forzare manualmente una sincronizzazione, se necessario.

  1. Nella console Google Cloud, vai al repository GitHub con mirroring.

  2. Fai clic su Impostazioni .

    Viene visualizzato lo stato della sincronizzazione.

    Stato di sincronizzazione del repository con mirroring

  3. Per forzare manualmente una sincronizzazione dei repository, fai clic su Sincronizza da GitHub.