Skip to main content

À propos des dépôts verrouillés

Les dépôts peuvent être verrouillés pour empêcher toute modification, souvent pour les migrations.

À propos des dépôts verrouillés

Lorsque vous migrez des dépôts vers ou à partir de produits GitHub, vos dépôts d’origine et de destination peuvent être « verrouillés » pour la migration. Quand un dépôt est verrouillé, vous ne pouvez pas apporter de modifications au dépôt, comme pousser des commits, créer des problèmes ou commenter des demandes de tirage.

Le verrouillage de vos dépôts pendant la migration dépend des outils que vous utilisez et des options que vous choisissez lors de l’exécution de la migration. Lorsqu’un dépôt est verrouillé, une bannière avec le texte suivant s’affiche dans la page du dépôt sur GitHub :

Ce dépôt est en cours de migration. Il est verrouillé pendant la migration.

Souvent, les dépôts sont déverrouillés automatiquement une fois la migration terminée. Dans d’autres cas, le déverrouillage d’un dépôt est une étape manuelle et le processus requis pour déverrouiller un dépôt dépend de l’outil de migration que vous avez utilisé.

Dépôts verrouillés par GitHub Enterprise Importer

Lorsqu’une migration est en cours, l’accès au dépôt de destination est verrouillé par GitHub Enterprise Importer. Si la migration se termine correctement, le dépôt se déverrouille automatiquement. Toutefois, en cas de problème avec la migration, notamment un échec de migration, le dépôt peut rester verrouillé.

GitHub Enterprise Importer ne verrouille pas les dépôts sources par défaut. Les dépôts sources sont verrouillés seulement si vous spécifiez l’option --lock-source-repo dans l’GitHub CLI, ou l’attribut lockSource dans la mutation GraphQL startRepositoryMigration.

Note

Nous vous déconseillons de verrouiller les dépôts sources, sauf si vous êtes sûr de ne pas vouloir les déverrouiller par la suite. Envisagez plutôt d’archiver les dépôts. Pour plus d’informations, consultez « Archivage de référentiels ».

Pour plus d’informations sur le déverrouillage des dépôts qui ont été verrouillés par GitHub Enterprise Importer, consultez « Résolution des problèmes de votre migration avec GitHub Enterprise Importer ».

Dépôts verrouillés par l’API REST « Migrations d’organisations »

Lorsque vous appelez le point de terminaison « Démarrer une migration d’organisation » afin de générer une archive de migration pour un dépôt source, le dépôt n’est pas verrouillé par défaut. Le dépôt est verrouillé seulement si vous définissez le paramètre lock_repositories avec la valeur true.

Si vous verrouillez un dépôt via ce point de terminaison, vous pouvez le déverrouiller à l’aide du point de terminaison « Déverrouiller un dépôt d’organisation ».

Si le dépôt est stocké sur GitHub Enterprise Server, un administrateur de site peut aussi déverrouiller le dépôt à l’aide du tableau de bord de l’administrateur de site. Pour plus d’informations, consultez « Verrouillage d’un dépôt » dans la documentation GitHub Enterprise Server.

Dépôts verrouillés par ghe-migrator

Lorsque vous utilisez ghe-migrator, le dépôt de destination sur GitHub Enterprise Server est verrouillé par défaut et n’est pas déverrouillé automatiquement.

Si l’importation réussit, vous pouvez déverrouiller le dépôt avec la commande ghe-migrator unlock. Pour plus d’informations, consultez « Migration de données vers GitHub Enterprise Server ».

Si l’importation échoue, vos données n’ont pas toutes été migrées. Nous vous recommandons de supprimer le dépôt et de réessayer la migration pour éviter de perdre des données.

Si vous êtes sûr de vouloir utiliser le dépôt, un administrateur de site peut déverrouiller le dépôt à l’aide du tableau de bord de l’administrateur de site. Pour plus d’informations, consultez « Verrouillage d’un dépôt » dans la documentation GitHub Enterprise Server.

Le dépôt source n’est pas verrouillé par défaut, seulement si l’argument --lock est spécifié lors de la préparation du dépôt à l’exportation avec la commande ghe-migrator add. Pour déverrouiller le dépôt, utilisez la commande ghe-migrator unlock. Pour plus d’informations, consultez « Migration de données vers GitHub Enterprise Server ».

Dépôts verrouillés par Enterprise Cloud Importer

Lorsque vous utilisez Enterprise Cloud Importer, le dépôt de destination est verrouillé par défaut et n’est pas déverrouillé automatiquement.

Si l’importation réussit, vous pouvez déverrouiller le dépôt en cliquant sur le bouton Déverrouiller dans Enterprise Cloud Importer.

Si l’importation échoue, vous ne pouvez pas déverrouiller le dépôt vous-même. Étant donné qu’une migration ayant échoué signifie que vos données n’ont pas toutes été migrées, nous vous recommandons de supprimer le dépôt et de réessayer la migration pour éviter de perdre des données.

Si vous êtes sûr de vouloir déverrouiller le dépôt, contactez nous via le portail de support GitHub.

Dépôts verrouillés par la mutation GraphQL startImport

Lorsque vous utilisez la mutation GraphQL startImport, le dépôt de destination est verrouillé par défaut et n’est pas déverrouillé automatiquement.

Si l’importation réussit, vous pouvez déverrouiller le dépôt avec la mutation GraphQL unlockImportedRepositories. Pour obtenir de la documentation, contactez votre expert Services ou votre agent Partenaire GitHub.

Si l’importation échoue, vous ne pouvez pas déverrouiller le dépôt vous-même. Étant donné qu’une migration ayant échoué signifie que vos données n’ont pas toutes été migrées, nous vous recommandons de supprimer le dépôt et de réessayer la migration pour éviter de perdre des données.

Si vous êtes sûr de vouloir déverrouiller le dépôt, contactez nous via le portail de support GitHub.