Cet article explique comment mettre en miroir un dépôt GitHub sur Cloud Source Repositories. Avec cette configuration, les commits que vous transférez vers le dépôt GitHub sont copiés ou mis en miroir dans un dépôt hébergé dans Cloud Source Repositories.
Seuls les dépôts Bitbucket Cloud et GitHub Cloud peuvent être mis en miroir sur Cloud Source Repositories. La mise en miroir de Bitbucket et GitHub auto-hébergées n'est pas disponible.
Si vous mettez en miroir votre dépôt GitHub vers Cloud Source Repositories pour l'intégrer à Cloud Build et que vous n'avez pas besoin d'autres fonctionnalités de Cloud Source Repositories, suivez plutôt les instructions de Cloud Build sur la création de dépôts à partir de GitHub.
Avant de commencer
Lorsque vous mettez en miroir un dépôt, vous devez fournir des identifiants d'authentification GitHub. Ces identifiants permettent à Cloud Source Repositories d'accéder au contenu du dépôt GitHub.
Si vous utilisez des organisations GitHub, il est recommandé d'utiliser un compte utilisateur machine conçu spécialement pour les tâches automatisées, comme la mise en miroir d'un dépôt. Ce compte doit disposer d'un accès administrateur à votre dépôt.
Mettre en miroir un dépôt GitHub
Cette section explique comment mettre en miroir un dépôt GitHub dans Cloud Source Repositories.
Créer un dépôt mis en miroir
Au cours de ce processus, vous devez disposer de vos identifiants utilisateur machine GitHub pour accorder à Google Cloud l'accès en lecture au dépôt GitHub.
Dans la console Google Cloud, ouvrez Cloud Source Repositories.
Cliquez sur Ajouter un dépôt.
La page Ajouter un dépôt s'affiche.
Sélectionnez Connecter un dépôt externe, puis cliquez sur Continuer.
La page Connecter un dépôt externe s'affiche.
Dans la liste déroulante Projet, sélectionnez le projet Google Cloud auquel appartient le dépôt mis en miroir.
Si vous n'avez pas de projet, cliquez sur Créer un projet pour en créer un.
Dans la liste déroulante Fournisseur Git, sélectionnez GitHub.
Cochez la case pour autoriser Cloud Source Repositories à stocker vos identifiants.
Cliquez sur Se connecter à GitHub.
Connectez-vous à GitHub à l'aide de vos identifiants utilisateur machine.
Cliquez sur Autoriser Google Cloud Platform.
Cette option accorde à Google Cloud l'accès en lecture à tous les dépôts dans le compte utilisateur GitHub.
Une fois l'autorisation terminée, vous êtes redirigé vers la page Connecter un dépôt externe. Une liste des dépôts s'affiche.
Dans la liste des dépôts, sélectionnez le dépôt à mettre en miroir.
Cliquez sur Connecter le dépôt sélectionné.
La page principale du dépôt s'affiche. Cette page présente la liste des dépôts contenus dans ce projet Google Cloud, y compris le dépôt que vous venez de créer.
Identifier les dépôts GitHub
Cloud Source Repositories facilite l'identification des dépôts qui sont des miroirs de dépôts GitHub :
- Chaque dépôt GitHub est représenté par le logo GitHub.
github_a été ajouté au début du nom du dépôt.
Forcer la synchronisation du dépôt
Une fois que vous avez configuré la mise en miroir, Cloud Source Repositories synchronise automatiquement votre dépôt avec le dépôt en miroir lorsqu'un utilisateur fait le commit d'une modification. Cloud Source Repositories vous permet d'afficher la dernière synchronisation de votre dépôt mis en miroir et de forcer manuellement une synchronisation si nécessaire.
Dans la console GCP, accédez au dépôt GitHub mis en miroir.
Cliquez sur Paramètres settings.
L'état de synchronisation s'affiche.
Pour forcer manuellement la synchronisation des dépôts, cliquez sur Synchroniser à partir de GitHub.