Questo argomento descrive come eseguire il mirroring di un repository GitHub in Cloud Source Repositories. Con questa configurazione, i commit che esegui push nel repository GitHub vengono copiati o sottoposti a 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 di Bitbucket e GitHub self-hosted non è supportato.
Se esegui il mirroring del tuo repository GitHub in Cloud Source Repositories per integrarlo con Cloud Build e non hai bisogno di altre funzionalità di Cloud Source Repositories, segui le istruzioni di Cloud Build per la creazione di 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 le organizzazioni GitHub, ti consigliamo di utilizzare un account utente macchina espressamente dedicato alle attività automatizzate, come il mirroring di un repository. Questo account deve disporre dell'accesso amministrativo al tuo repository.
Esegui il mirroring di un repository GitHub
Questa sezione mostra come eseguire il mirroring di un repository GitHub in Cloud Source Repositories.
Creare un repository sottoposto a mirroring
In questa procedura, devi disporre delle credenziali dell'utente della macchina GitHub per concedere accesso in lettura a Google Cloud al repository GitHub.
Nella console Google Cloud, apri Cloud Source Repositories.
Fai clic su Aggiungi repository.
Viene visualizzata la pagina Aggiungi un repository.
Seleziona Connetti repository esterno e fai clic su Continua.
Si apre la pagina Collega repository esterno.
Nell'elenco a discesa Progetto, seleziona il progetto Google Cloud a cui appartiene il repository sottoposto a mirroring.
Se non hai un progetto, puoi fare clic su Crea progetto per crearne uno.
Nell'elenco a discesa Provider Git, seleziona GitHub.
Seleziona la casella di controllo per autorizzare Cloud Source Repositories a memorizzare le tue credenziali.
Fai clic su Connetti a GitHub.
Accedi a GitHub con le credenziali dell'utente della macchina.
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, viene visualizzata nuovamente la pagina Collega repository esterno. Viene visualizzato un elenco di repository.
Nell'elenco dei repository, seleziona quello di cui vuoi creare un mirror.
Fai clic su Connetti repository selezionato.
Si apre la pagina del repository principale. Questa pagina contiene un elenco dei repository per questo progetto Google Cloud, incluso il nuovo repository che hai appena creato.
Identificare i repository GitHub
Cloud Source Repositories indica chiaramente quali dei tuoi repository sono mirror dei repository GitHub:
- Ogni repository GitHub è rappresentato dal logo di GitHub.
- All'inizio del nome del repository è stato aggiunto
github_.
Forzare la sincronizzazione di un repository
Dopo aver configurato il mirroring, Cloud Source Repositories sincronizza automaticamente il tuo repository con il repository sottoposto a mirroring quando un utente esegue il commit di una modifica. Cloud Source Repositories ti consente di visualizzare l'ultima volta che il repository sottoposto a mirroring è stato sincronizzato e di forzare manualmente una sincronizzazione, se necessario.
Nella console Google Cloud, vai al repository GitHub sottoposto a mirroring.
Fai clic su Impostazioni settings.
Viene visualizzato lo stato della sincronizzazione.
Per forzare manualmente una sincronizzazione dei repository, fai clic su Sincronizza da GitHub.