Миграция предприятия в реестр контейнеров из реестра Docker

Вы можете перенести образы Docker, ранее хранящиеся в реестре Docker, на ваш экземпляр GitHub Enterprise Server в Container registry.

Кто может использовать эту функцию?

Enterprise owners can migrate Docker images to the Container registry.

В этой статье

Note

Container registry в настоящее время находится в beta для GitHub Enterprise Server и подлежит изменению.

Для использования Container registry необходимо включить GitHub Packages и изоляцию поддоменов. Дополнительные сведения см. в разделе Работа с реестром контейнеров.

Сведения о Container registry

Container registry хранит образы контейнеров в вашей организации или личной учетной записи и позволяет связать образ с репозиторием. Можно указать, нужно ли наследовать разрешения из репозитория или задавать детализированные разрешения независимо от репозитория. Кроме того, можно анонимно выполнять доступ к открытым образам контейнеров. Дополнительные сведения см. в разделе Работа с реестром контейнеров.

Дополнительные сведения о настройке GitHub Packages для ваш экземпляр GitHub Enterprise Serverсм. в разделе Начало работы с GitHub Packages для вашего предприятия.

Сведения о миграции из реестра Docker

Container registry заменяет реестр Docker GitHub. Если реестр Docker на ваш экземпляр GitHub Enterprise Server содержит изображения, необходимо вручную перенести образы в Container registry.

Note

GitHub Enterprise Server 3.6 поддерживает миграцию образов Docker, хранящихся в организациях. Будущий выпуск будет поддерживать миграцию образов, которыми владеет пользователь.

Все скрипты или рабочие процессы GitHub Actions, использующие пространство имен для реестра Docker, docker.HOSTNAME, будут продолжать работать после миграции в Container registry в containers.HOSTNAME. Дополнительные сведения о влиянии миграции на Container registryсм. в разделе Миграция в реестр контейнеров из реестра Docker.

Миграция организаций в Container registry

Вы можете начать миграцию всех образов Docker в вашей организации в Container registry. Длительность операции миграции зависит от общего количества образов для переноса, а также общей нагрузки на экземпляр. После успешной миграции GitHub Enterprise Server отобразит сводку, а все будущие отправки образов Docker будут использовать Container registry.

Если администратор сайта настроил Уведомления по электронной почте для ваш экземпляр GitHub Enterprise Server, вы получите сообщение электронной почты после завершения миграции. Дополнительные сведения см. в разделе Настройка электронной почты для получения уведомлений.

Во время миграции

Во время миграции загрузка ЦП и памяти для вашего экземпляра возрастает. Чтобы обеспечить производительность экземпляра для пользователей, GitHub рекомендует начать миграцию в период снижения активности.

Warning

Не изменяйте параметры для вашего предприятия или не запускайте ghe-config-apply из административного сеанса SSH. Эти действия активируют запуск конфигурации, который может перезапустить службы и может прервать миграцию.

После миграции

После миграции дефицит объема хранилища на вашем экземпляре возрастет из-за дублирования файлов образов в реестре Docker и Container registry. В будущем выпуске GitHub Enterprise Server будут удалены повторяющиеся файлы после завершения всех миграций.

Дополнительные сведения о мониторинге производительности и хранения данных ваш экземпляр GitHub Enterprise Serverсм. в разделе Migrating your enterprise to the Container registry from the Docker registry.

Запуск миграции

  1. В правом верхнем углу GitHub Enterprise Serverщелкните фото профиля, а затем выберите параметры Enterprise.

    Снимок экрана: раскрывающееся меню, отображаемое при щелчке фото профиля на GitHub Enterprise Server. Описан параметр "Параметры предприятия".

  2. В левой части страницы на боковой панели учетной записи предприятия щелкните Параметры.

  3. На боковой панели слева нажмите Пакеты.

  4. Справа от количества пакетов для миграции нажмите кнопку Начать миграцию. Во время миграции GitHub Enterprise Server отобразит ход выполнения на этой странице.

По завершении миграции на странице отобразятся результаты. Если миграция завершается сбоем, на странице отобразятся организации, владеющие пакетом, из-за которых возник сбой.

Повторное выполнение неудачной миграции организации

Если до миграции пользователь создал пакет в Container registry с идентичным именем существующего пакета в реестре Docker, миграция завершается ошибкой.

  1. Удаление затрагиваемого контейнера в Container registry. Дополнительные сведения см. в разделе Удаление и восстановление пакета.

  2. В правом верхнем углу GitHub Enterprise Serverщелкните фото профиля, а затем выберите параметры Enterprise.

    Снимок экрана: раскрывающееся меню, отображаемое при щелчке фото профиля на GitHub Enterprise Server. Описан параметр "Параметры предприятия".

  3. В левой части страницы на боковой панели учетной записи предприятия щелкните Параметры.

  4. На боковой панели слева нажмите Пакеты.

  5. Справа от количества пакетов для миграции нажмите кнопку Повторно выполнить миграцию. Во время миграции GitHub Enterprise Server отобразит ход выполнения на этой странице.

  6. Если миграция снова завершается ошибкой, начните с шага 1 и повторно выполните миграцию.