{"meta":{"title":"Устранение неполадок при миграции с помощью GitHub Enterprise Importer","intro":"Если миграция завершается сбоем или выдает непредвиденные результаты, попробуйте выполнить распространенные действия по устранению неполадок.","product":"Миграции","breadcrumbs":[{"href":"/ru/migrations","title":"Миграции"},{"href":"/ru/migrations/troubleshooting","title":"Устранение неполадок с миграцией"},{"href":"/ru/migrations/troubleshooting/troubleshooting-your-migration-with-github-enterprise-importer","title":"Устранение неполадок с миграцией"}],"documentType":"article"},"body":"# Устранение неполадок при миграции с помощью GitHub Enterprise Importer\n\nЕсли миграция завершается сбоем или выдает непредвиденные результаты, попробуйте выполнить распространенные действия по устранению неполадок.\n\n## О шагах по устранению неполадок GitHub Enterprise Importer\n\nЕсли миграция завершается сбоем или выдает непредвиденные результаты, попробуйте выполнить первые действия по устранению неполадок ниже, которые обычно устраняют различные проблемы. Если эти первые шаги не устраняют проблему, проверьте наличие сообщений об ошибках в журналах миграции. Затем найдите сообщение об ошибке в этой статье и выполните действия по разрешению.\n\nЕсли вы не сможете решить проблему после выполнения шагов устранения ошибки, вы можете связаться Служба поддержки GitHubс .\n\n## Первые шаги по устранению неполадок\n\nПеред дальнейшим изучением попробуйте выполнить эти действия по устранению неполадок, которые обычно устраняют различные проблемы.\n\n1. Убедитесь, что вы используете последнюю версию GitHub CLI расширения, которое используете для миграции. Если нет, обновите до последней версии.\n\n2. Убедитесь, что выполнены все требования к доступу. Дополнительные сведения см. в соответствующей статье для пути миграции.\n\n   * [Управление доступом](/ru/migrations/ado/manage-access)\n   * [Управление доступом к миграции с сервера Bitbucket](/ru/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/managing-access-for-a-migration-from-bitbucket-server)\n   * [Управление доступом к миграции между продуктами GitHub](/ru/migrations/using-github-enterprise-importer/migrating-between-github-products/managing-access-for-a-migration-between-github-products)\n\n3. Попробуйте выполнить миграцию еще раз. Некоторые проблемы миграции являются временными, а вторая попытка может работать.\n\n4. Попробуйте выполнить миграцию в другом репозитории с аналогичными данными. Это поможет определить, является ли проблема уникальной для репозитория или представляет более широкую проблему фигуры данных.\n\nЕсли эти действия не устраняют проблему, просмотрите журналы миграции для сообщений об ошибках. Журнал, который необходимо проверить, зависит от того, завершилась ли миграция сбоем или успешно выполнена.\n\n## Устранение неполадок с неудачными миграциями\n\nЕсли ваша миграция не удалась, просмотрите подробные записи журнала, созданные GitHub CLI для каждой миграции. Файл журнала сохраняется в том же каталоге, где выполняется миграция.\n\nЖурнал содержит запись каждой команды, которую вы запустили, и всех API-запросов, которые они GitHub CLI сделали в ответ. Ошибки и сообщения об ошибках обычно отображаются в конце журнала.\n\n* [Не удается выполнить миграцию](#unable-to-run-migrations)\n* [Ресурс защищен принудительной защитой организации SAML](#resource-is-protected-by-organization-saml-enforcement)\n* [\n  `401 Unauthorized` ответ](#401-unauthorized-response)\n* [\n  `404 Not Found` ответ](#404-not-found-response)\n* [\n  `Archive generation failed` ответ](#archive-generation-failed-response)\n* [Ошибка `cipher name is not supported`](#cipher-name-is-not-supported-error)\n* [Ошибка `Subsystem 'sftp' could not be executed`](#subsystem-sftp-could-not-be-executed-error)\n* [Ошибка `Source export archive... does not exist`](#source-export-archive-does-not-exist-error)\n* [Ошибка `Repository rule violations found`](#repository-rule-violations-found-error)\n* [Ошибка `Your push would publish a private email address`](#your-push-would-publish-a-private-email-address-error)\n\n### Не удается выполнить миграцию\n\nЕсли вы видите ошибку или `No access to createMigrationMutation``Missing permissions`, личная учетная запись не имеет требуемого доступа для выполнения миграции. Убедитесь, что вы являетесь владелец организации или получили роль миграции. Дополнительные сведения о предоставлении роли миграции см. в разделе [Сведения о GitHub Enterprise Importer](/ru/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer).\n\n> \\[!NOTE]\n> Если вы переходите между GitHub продуктами, убедитесь, что вы владелец организации или вам предоставлена роль мигритора как для исходной, так и для целевой организации.\n\n### Ресурс защищен принудительной защитой организации SAML\n\nЭта ошибка указывает на то, personal access token что вам GitHub CLI нужно авторизовать использование с SAML single sign-on. Дополнительные сведения см. в разделе [Авторизация личного маркера доступа для использования с единым входом](/ru/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/authorizing-a-personal-access-token-for-use-with-single-sign-on).\n\n### `401 Unauthorized` ответ\n\nСбои с `401` кодом статуса обычно означают отсутствие personal access tokenGitHub CLI необходимых диапазонов. Проверьте скопы на предоставленном personal access tokenвами S. Дополнительные сведения о необходимых областях см. в соответствующей статье для пути миграции.\n\n* [Управление доступом](/ru/migrations/ado/manage-access)\n* [Управление доступом к миграции с сервера Bitbucket](/ru/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/managing-access-for-a-migration-from-bitbucket-server#required-scopes-for-personal-access-tokens)\n* [Управление доступом к миграции между продуктами GitHub](/ru/migrations/using-github-enterprise-importer/migrating-between-github-products/managing-access-for-a-migration-between-github-products#required-scopes-for-personal-access-tokens)\n\n### `404 Not Found` ответ\n\nСбои, содержащие `404` код состояния, обычно указывают на опечатку в одной из команд. Просмотрите журнал миграции для указанной команды и проверьте типос в исходном репозитории, организации или проекте.\n\n### `Archive generation failed` ответ\n\nЕсли вы получите `Archive generation failed...` ответ при миграции с GitHub Enterprise Server, ваш репозиторий, скорее всего, слишком большой. Дополнительные сведения об ограничениях размера репозитория см. в разделе [О миграциях между GitHub продуктами с GitHub Enterprise Importer](/ru/migrations/using-github-enterprise-importer/migrating-between-github-products/about-migrations-between-github-products#data-that-is-migrated-from-github-enterprise-server).\n\nСначала попробуйте исключить выпуски из миграции с помощью флага `--skip-releases``migrate-repo` с помощью команды.\n\nЕсли это не поможет, рекомендуем обновиться до GitHub Enterprise Server версии 3.8.0 или выше. Если вам не удается обновить, другой вариант — создать архивы репозитория вручную с помощью `ghe-migrator`:\n\n1. Создайте архив миграции для репозитория. Необходимо экспортировать только один репозиторий одновременно. Для инструкций см. [раздел «Экспорт данных миграции из вашего предприятия](/ru/enterprise-server@3.22/migrations/using-ghe-migrator/exporting-migration-data-from-github-enterprise-server) в GitHub Enterprise Server документации.\n2. Отправьте архив миграции в выбранный поставщик хранилища BLOB-объектов.\n3. Сгенерируйте кратковременный URL для вашего архива миграции, доступный для GitHub, например, заранее подписанный URL AWS S3 или Хранилище BLOB-объектов Azure SAS.\n4. `migrate-repo` Вызовите команду с `--git-archive-url` флагами и `--metadata-archive-url` задайте URL-адрес архива из предыдущего шага.\n\n### `cipher name is not supported` Ошибка\n\nЕсли вы выполняете миграцию с Bitbucket Server и получаете ошибку, например `cipher name aes256-ctr for openssh key file is not supported` при выполнении миграции, закрытый ключ SSH использует неподдерживаемый шифр. Дополнительные сведения о поддерживаемых шифрах см. в разделе [Управление доступом к миграции с сервера Bitbucket](/ru/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/managing-access-for-a-migration-from-bitbucket-server#required-permissions-for-bitbucket-server).\n\nЧтобы создать новый совместимый ключ SSH, выполните следующую команду:\n\n```shell copy\nssh-keygen -t ed25519 -Z aes256-cbc -C \"your_email@example.com\"\n```\n\nПосле создания нового ключа SSH перед использованием ключа необходимо добавить открытый ключ в экземпляр `authorized_keys`Bitbucket Server.\n\n### `Subsystem 'sftp' could not be executed` Ошибка\n\nЕсли вы выполняете миграцию с Bitbucket Server и получаете ошибку, например `Subsystem 'sftp' could not be executed`SFTP, не включена на сервере или у вашей учетной записи пользователя нет доступа SFTP.\n\nОбратитесь к администратору сервера и попросите его включить доступ SFTP к учетной записи пользователя.\n\n### `Source export archive... does not exist` Ошибка\n\nЕсли вы переходите с Bitbucket Server и получаете ошибку вроде `Source export archive (/var/atlassian/application-data/bitbucket/shared/migration/export/Bitbucket_export_1.tar) does not exist`, он GitHub CLI ищет ваш архив миграции не в том месте на вашем экземпляре Bitbucket Server.\n\nЧтобы устранить эту проблему, задайте `--bbs-shared-home` аргумент для `gh bbs2gh migrate-repo` сервера Bitbucket или общего домашнего каталога Центра обработки данных. Общий домашний каталог по умолчанию, `/var/atlassian/application-data/bitbucket/shared`но конфигурация может отличаться.\n\nВы можете определить общий домашний каталог в Bitbucket Server.\n\n1. Перейдите в область администрирования экземпляра Bitbucket Server или Data Center.\n2. На боковой панели в разделе \"Система\" щелкните **\"Хранилище**\".\n3. В разделе \"Общий каталог\" просмотрите расположение общего домашнего каталога сервера.\n\nЕсли вы используете Bitbucket Data Center в режиме кластера с несколькими заметками, общий каталог будет совместно использоваться между узлами кластера и должен быть подключен в одном расположении на каждом узле.\n\n### `Repository rule violations found` Ошибка\n\nПри возникновении `Repository rule violations found` ошибки, например `GH013: Repository rule violations found for refs/heads/main`, данные в репозитории источников конфликтуют с наборами правил, настроенными в целевой организации. Дополнительные сведения см. в разделе [Сведения о наборе правил](/ru/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets).\n\nВы можете временно отключить наборы правил во время миграции или использовать режим обхода или список обходов, чтобы исключить миграцию из настроенных правил. Дополнительные сведения см. в разделе [Управление наборами правил для репозиториев в организации](/ru/enterprise-cloud@latest/organizations/managing-organization-settings/managing-rulesets-for-repositories-in-your-organization).\n\n### `Your push would publish a private email address` Ошибка\n\nЕсли вы получаете `Git source migration failed` ошибку с `GH007: Your push would publish a private email address`, в исходном коде Git, который вы пытаетесь перенести, есть коммиты, созданные с адреса электронной почты, на который вы заблокировали для отправки GitHub. Для получения дополнительной информации см. [Блокировка отправок из командной строки, которые раскрывают ваши личные адреса электронной почты](/ru/account-and-profile/how-tos/email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address).\n\nЧтобы устранить эту ошибку, можно переписать журнал Git, чтобы удалить адрес электронной почты, или отключить параметр \"Блокировать отправки командной строки, предоставляющие мою электронную почту\".\n\n## Общие сведения о предупреждениях журнала миграции\n\nДаже если миграция выполнена успешно, необходимо проверить журнал миграции, чтобы проверить наличие предупреждений.\n\nПредупреждения в журнале миграции указывают на определенные элементы в репозитории, которые не удалось перенести. Дополнительные сведения см. в разделе [Доступ к журналам миграции для GitHub Enterprise Importer](/ru/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer).\n\n> \\[!NOTE]\n> Если проблема \"Журнал миграции\" включает \"Миграция завершена\" в нижней части, репозиторий был перенесен. Предупреждения указывают только на то, что определенные элементы в репозитории, например комментарий к запросу на вытягивание, могут не переноситься правильно.\n\n* [Предупреждение: \"Метаданные репозитория слишком большие для миграции\"](#warning-repository-metadata-too-big-to-migrate)\n* [Предупреждение: \"Комментарий не в диффе\"](#warning-comment-not-in-diff)\n* [Предупреждение: \"Проверка запроса на вытягивание... не удалось импортировать из-за ошибки REVIEW\\_THREAD\\_MISSING\\_END\\_COMMIT\\_OID\"](#warning-pull-request-reviewcould-not-be-imported-due-to-review_thread_missing_end_commit_oid-error)\n* [Ссылки группы прерваны после миграции организации](#team-references-are-broken-after-an-organization-migration)\n\n### Предупреждение: \"Метаданные репозитория слишком большие для миграции\"\n\nЕсли вы видите надпись «Метаданные репозитория слишком большие для миграции» в выпуске «Журнал миграции» или GitHub CLIв , ваш репозиторий превышает максимальный размер архива в 10 ГБ. Это часто вызвано большими ресурсами выпуска. Попробуйте исключить выпуски из миграции с флагом `--skip-releases` для `migrate-repo` команды.\n\n### Предупреждение: \"Комментарий не в диффе\"\n\nЕсли вы переходите с Azure DevOps, комментарии pull request-запросов к линиям, которые никогда не менялись в pull-запросе, нельзя перенести в GitHub. Вы увидите это предупреждение для каждого комментария, который не может быть перенесен по этой причине.\n\n> \\[!NOTE]\n> Это ограничение влияет только на комментарии к строкам, которые не были изменены в запросе на вытягивание. Комментарии по строкам, которые были изменены в запросе на вытягивание, переносятся.\n\nПомните, что затронутые комментарии не будут находиться в перенесенном репозитории, но эти предупреждения не требуют дальнейших действий от вас.\n\n### Предупреждение: \"Проверка запроса на вытягивание... не удалось импортировать из-за ошибки REVIEW\\_THREAD\\_MISSING\\_END\\_COMMIT\\_OID\"\n\nЭто предупреждение возникает, когда не удалось перенести проверка запроса на вытягивание, так как фиксация, к которой присоединена проверка, больше не существует.\n\nОбычно это происходит, когда фиксации были удалены с помощью принудительная отправка, или ветвь была удалена.\n\nВ этом случае комментарии не теряются, но переносятся как встроенные примечания запроса на вытягивание, чтобы сохранить журнал, а не как проверку, присоединенную к определенной фиксации.\n\n### Обзор pull request импортируется в виде встроенного комментария к pull request-запросу\n\nЭти предупреждения указывают на то, что проверку pull request нельзя было перенести в оригинальном виде, а в комментариях к встроенным pull request-запросам:\n\n* `INVALID_REVIEW_THREAD`\n* `LINE_NOT_FOUND_IN_DIFF`\n* `REVIEW_THREAD_MISSING_BODY`\n\n### Ссылки группы прерваны после миграции организации\n\nСсылки на команды, например`@octo-org/octo-team`, не\\*\\* обновляются \\*\\*в рамках миграции организации. Это может вызвать проблемы в целевой организации, например `CODEOWNERS` файлы, которые не работают должным образом.\n\nВы можете обновить эти ссылки после миграции или сохранить имена команд, переименовав исходную организацию, чтобы использовать исходное имя для целевой организации.\n\nНапример, если ваша исходная организация имеет `@octo-org``CODEOWNERS` ссылку на команду`@octo-org/octo-team`, вы можете переименовать исходную организацию `@octo-org-temp` до миграции, что позволяет использовать `@octo-org` в качестве имени новой организации. Затем будет вызвана `@octo-org/octo-team`перенесенная команда, и `CODEOWNERS` файл в перенесенном репозитории будет работать должным образом.\n\n## Заблокированные репозитории\n\nПосле миграции вы можете обнаружить, что исходные или целевые репозитории заблокированы, отключая доступ к коду репозитория и всем его ресурсам, таким как проблемы и запросы на вытягивание. Дополнительные сведения о заблокированных репозиториях см. в разделе [Сведения о заблокированных репозиториях](/ru/migrations/overview/about-locked-repositories).\n\nПроцесс разблокировки репозитория зависит от GitHub продукта, в котором он хранится.\n\n* Если заблокированный репозиторий включён GitHub Enterprise Server, администратор сайта может разблокировать репозиторий с помощью панели администратора сайта. Для получения дополнительной информации см. [Блокировка репозитория](/ru/enterprise-server@3.22/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/locking-a-repository) в GitHub Enterprise Server документации.\n* Если заблокированный репозиторий включён GitHub.com, вы можете связаться мы через портал  с ним, чтобы открыть репозиторий.\n\n> \\[!NOTE]\n> Если миграция завершилась сбоем, не все данные были перенесены. Если вы решили разблокировать репозиторий и использовать его, будет потеря данных. Удаление заблокированного репозитория и повторная попытка миграции может оказаться лучшим вариантом.\n\n## Связь Служба поддержки GitHub\n\nЕсли вы всё ещё не можете решить проблему после перечисленных выше шагов по устранению неполадок, вы можете связаться Служба поддержки GitHub с этим через [Портал поддержки GitHub](https://support.github.com)."}