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.

È possibile eseguire il mirroring solo dei repository Bitbucket Cloud e GitHub Cloud in Cloud Source Repositories. Il mirroring Bitbucket e GitHub self-hosted non è supportato.

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 per creare repository da GitHub.

Prima di iniziare

Quando esegui il mirroring di un repository, devi fornire le credenziali di autenticazione di 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 specificatamente alle attività automatizzate, ad esempio il mirroring di un repository. Questo account deve avere accesso amministrativo al repository.

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.

    Repository Open Cloud Source

  2. Fai clic su Aggiungi repository.

    Viene visualizzata la pagina Aggiungi un repository.

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

    Viene visualizzata 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 creare un progetto.

  5. Nell'elenco a discesa Provider di Git, seleziona GitHub.

  6. Seleziona la casella di controllo per autorizzare Cloud Source Repositories all'archiviazione delle tue credenziali.

  7. Fai clic su Connetti a GitHub.

  8. Accedi a GitHub con le tue credenziali utente della 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, il sistema ti reindirizzerà alla 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 repository selezionato.

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

Identifica i repository GitHub

Cloud Source Repositories rende chiaro quali dei tuoi repository sono mirror dei repository GitHub:

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

Forzare la sincronizzazione del repository

Dopo aver configurato il mirroring, Cloud Source Repositories sincronizza automaticamente il repository con il repository con 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, se necessario, di forzare manualmente una sincronizzazione.

  1. Nella console di GCP, 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.