Перенос репозиториев из GitHub Enterprise Server в GitHub Enterprise Cloud

Если вы решили использовать API, вам потребуется написать собственные скрипты или использовать HTTP-клиент, такой как бессонница. Вы можете узнать больше о начале работы с GitHubAPI 's в Начало работы с REST API и AUTOTITLE.

Чтобы перенести ваши репозитории из GitHub Enterprise Server в GitHub Enterprise Cloud с помощью API, вы следуете:

1. Создайте personal access token как для исходной, так и для организации назначения
2. Выведите ownerId организацию назначения на GitHub Enterprise Cloud
3. Настройте исходный код миграции через GitHubAPI GraphQL от ', чтобы определить, откуда вы переходите
4. Для каждого репозитория, который требуется перенести, повторите эти действия.
   • Используйте REST API для экземпляр GitHub Enterprise Server генерации архивов миграции для вашего репозитория
   • Загрузите ваши архивы миграции в место, где к ним можно получить доступ GitHub
   • Запустите миграцию с помощью API GraphQL для назначения миграции, передавая URL-адреса архива
   • Проверьте состояние миграции с помощью API GraphQL
   • Проверка миграции и проверка журнала ошибок

Чтобы просмотреть инструкции по использованию GitHub CLI, используйте переключатель инструментов в верхней части страницы.

Шаг 1. Создайте свой personal access token

1. Создайте и запишите personal access token (classic), которая будет проходить проверку подлинности для целевой организации на GitHub Enterprise Cloud, убедившись, что маркер соответствует всем требованиям. Дополнительные сведения см. в разделе Управление доступом к миграции между продуктами GitHub.
2. Создайте и запишите personal access token, которая будет проходить проверку подлинности для исходной организации, убедившись, что этот маркер также соответствует всем одинаковым требованиям.

Шаг 2. Получение ownerId целевой организации

В качестве владелец организации в GitHub Enterprise Cloudиспользуйте GetOrgInfo запрос для возврата ownerIdидентификатора организации, которая также называется идентификатором организации, для которой требуется принадлежать перенесенные репозитории. Вам потребуется ownerId определить назначение миграции.

GetOrgInfo запрос

query(
  $login: String!
){
  organization (login: $login)
  {
    login
    id
    name
    databaseId
  }
}

GetOrgInfo ответ

{
  "data": {
    "organization": {
      "login": "Octo",
      "id": "MDEyOk9yZ2FuaXphdGlvbjU2MTA=",
      "name": "Octo-org",
      "databaseId": 5610
    }
  }
}

В этом примере MDEyOk9yZ2FuaXphdGlvbjU2MTA= — это идентификатор организации или ownerIdидентификатор организации, который мы будем использовать на следующем шаге.

Шаг 3. Настройка хранилища BLOB-объектов

При миграции репозитория необходимо хранить данные репозитория в месте, куда GitHub Enterprise Importer можно получить доступ. Это можно сделать, выполнив следующие действия.

• Использование локального хранилища в экземпляре GHES (GHES 3.16 и более поздних версий)
• Использование поставщика хранилища BLOB-объектов

Использование локального хранилища (GHES 3.16+)

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

• Если у вас нет правил брандмауэра, блокирующих исходящий трафик из GitHub Enterprise Server, GitHub Enterprise Importer может автоматически получить сохраненный архив из GitHub Enterprise Server.
• Если у вас есть правила брандмауэра и нет необходимости разрешать доступ к GitHub Enterprise Importer, вы можете передать архивные данные в GitHub-owned blob storage для доступа к GitHub Enterprise Importer. Чтобы сделать это вручную, см. статью "Отправка архивов миграции в хранилище BLOB-объектов, принадлежащих GitHub" в версии API этой статьи.

1. В учетной записи администратора GitHub Enterprise Server, в правом верхнем углу любой страницы щелкните .
2. На боковой панели " "Администратор сайта" щелкните Консоль управления.
3. Войдите в Консоль управления.
4. На левой боковой панели щелкните "Миграции".
5. Нажмите кнопку "Включить" GitHub Миграции.
6. В разделе "Хранилище миграций" щелкните "Локальное хранилище".
7. Нажмите кнопку Сохранить параметры.

При выполнении миграции отслеживайте место на диске на GitHub Enterprise Server. Архивы миграции автоматически удаляются через 7 дней. Чтобы освободить место, можно удалить архив с помощью Конечные точки REST API для миграции организации.

Использование поставщика хранилища BLOB-объектов

Если ваш GitHub Enterprise Server экземпляр находится за межсетевым экраном, возможно, придётся настроить blob storage с внешним облачным сервисом.

Сначала необходимо настроить хранилище BLOB-объектов с помощью поддерживаемого поставщика. Затем, если вы используете облачного провайдера, необходимо настроить учетные данные для провайдера хранения в Консоль управления или GitHub CLI.

GitHub CLI поддерживает следующие поставщики хранилища BLOB-объектов:

• Amazon Web Services (AWS) S3
• хранилище BLOB-объектов Azure

Настройка контейнера хранилища AWS S3

В AWS настройте контейнер S3. Дополнительные сведения см. в разделе "Создание контейнера " в документации ПО AWS.

Вам также потребуется ключ доступа AWS и секретный ключ со следующими разрешениями:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:ListBucketMultipartUploads",
                "s3:AbortMultipartUpload",
                "s3:ListBucket",
                "s3:DeleteObject",
                "s3:ListMultipartUploadParts"
            ],
            "Resource": [
                "arn:aws:s3:::github-migration-bucket",
                "arn:aws:s3:::github-migration-bucket/*"
            ]
        }
    ]
}

Настройка учетной записи Хранилище BLOB-объектов Azure

В Azure создайте учетную запись хранения и запишите строка подключения. Дополнительные сведения см. в разделе "Управление ключами доступа к учетной записи хранения" в Документация Майкрософт.

Настройка хранения blob в Консоль управленияэкземпляр GitHub Enterprise Server

После настройки контейнера хранилища AWS S3 или учетной записи хранения Хранилище BLOB-объектов Azure настройте хранилище BLOB-объектов в Консоль управления экземпляр GitHub Enterprise Server. Дополнительные сведения о Консоль управлениясм. в статье администрирование экземпляра из консоли управления.

1. В учетной записи администратора GitHub Enterprise Server, в правом верхнем углу любой страницы щелкните .

2. Если вы еще не на странице "Администратор сайта" в левом верхнем углу щелкните "Администратор сайта". 1. На боковой панели " "Администратор сайта" щелкните Консоль управления.

3. Войдите в Консоль управления.

4. В верхней панели навигации** щелкните **"Параметры".

5. В разделе "Миграции" нажмите кнопку "Включить" GitHub Миграции.

6. При необходимости для импорта параметров хранилища, настроенных для GitHub Actions, выберите "Копировать параметры хранилища" из действий. Дополнительные сведения см. в статье "Включение действий GitHub с хранилищем BLOB-объектов Azure" и включение GitHub Actions с помощью хранилища Amazon S3.

   Примечание.

   После копирования параметров хранилища может потребоваться обновить конфигурацию облачной учетной записи хранения, чтобы работать с GitHub Enterprise Importer. В частности, необходимо убедиться, что разрешены IP-адреса GitHub. Дополнительные сведения см. в разделе Управление доступом к миграции между продуктами GitHub.

7. Если параметры хранилища не импортируются из GitHub Actions, выберите Хранилище BLOB-объектов Azure или Amazon S3 и заполните необходимые сведения.

   Примечание.

   Если вы используете Amazon S3, необходимо задать URL-адрес службы AWS для стандартной конечной точки региона AWS, в котором находится контейнер. Например, если контейнер находится в регионе eu-west-1 , будет указан https://s3.eu-west-1.amazonaws.comURL-адрес службы AWS. Сеть экземпляра GitHub Enterprise Server должна разрешить доступ к этому узлу. Конечные точки шлюза не поддерживаются, например bucket.vpce-0e25b8cdd720f900e-argc85vg.s3.eu-west-1.vpce.amazonaws.com. Дополнительные сведения о конечных точках шлюза см. в разделе "Конечные точки шлюза" для Amazon S3 в документации AWS.

8. Щелкните " Тестировать параметры хранилища".

9. Нажмите кнопку Сохранить параметры.

Разрешение сетевого доступа

Если вы настроили правила брандмауэра в учетной записи хранения, убедитесь, что у вас есть доступ к диапазонам IP-адресов для назначения миграции. См . раздел AUTOTITLE.

Шаг 4: Настройте исходник миграции в GitHub Enterprise Cloud

Вы можете настроить источник миграции с помощью createMigrationSource запроса. Вам потребуется указать ownerIdидентификатор организации, собранный GetOrgInfo из запроса.

Ваш источник миграции — это ваша организация на GitHub Enterprise Server.

createMigrationSource мутация

mutation createMigrationSource($name: String!, $url: String!, $ownerId: ID!) {
  createMigrationSource(input: {name: $name, url: $url, ownerId: $ownerId, type: GITHUB_ARCHIVE}) {
    migrationSource {
      id
      name
      url
      type
    }
  }
}

| url | URL для экземпляр GitHub Enterprise Server. Этот URL не обязательно должен быть доступен из GitHub Enterprise Cloud.

createMigrationSource ответ

{
  "data": {
    "createMigrationSource": {
      "migrationSource": {
        "id": "MS_kgDaACRjZTY5NGQ1OC1mNDkyLTQ2NjgtOGE1NS00MGUxYTdlZmQwNWQ",
        "name": "GHES Source",
        "url": "https://my-ghes-hostname.com",
        "type": "GITHUB_ARCHIVE"
      }
    }
  }
}

В этом примере MS_kgDaACRjZTY5NGQ1OC1mNDkyLTQ2NjgtOGE1NS00MGUxYTdlZmQwNWQ — это идентификатор источника миграции, который мы будем использовать на следующем шаге.

Шаг 5: Сгенерировать архивы миграции на экземпляр GitHub Enterprise Server

Вы используете REST API для запуска двух «миграций» GitHub Enterprise Server: одна — для создания архива исходного файла Git вашего репозитория, другая — для создания архива метаданных вашего репозитория (например, проблем и pull requests).

Чтобы сгенерировать архив исходного кода Git, сделайте POST запрос к https://HOSTNAME/api/v3/orgs/ORGANIZATION/migrations, заменяя HOSTNAME на имя хоста экземпляр GitHub Enterprise Server, а ORGANIZATION также на логин вашей организации.

В тексте укажите один репозиторий, который требуется перенести. Запрос будет выглядеть примерно так:

POST /api/v3/orgs/acme-corp/migrations HTTP/1.1
Accept: application/vnd.github+json
Authorization: Bearer <TOKEN>
Content-Type: application/json
Host: github.acmecorp.net

{
  "repositories": ["repository_to_migrate"],
  "exclude_metadata": true
}

Чтобы создать архив метаданных, отправьте аналогичный запрос на тот же URL-адрес со следующим текстом:

{
  "repositories": ["repository_to_migrate"],
  "exclude_git_data": true,
  "exclude_releases": false,
  "exclude_owner_projects": true
}

Каждый из этих двух вызовов API возвращает ответ JSON, включая идентификатор запущенной миграции.

HTTP/1.1 201 Created

{
  "id": 123,
  // ...
}

Дополнительные сведения см. в разделе "Запуск миграции организации".

Создание архивов может занять некоторое время в зависимости от объема данных. Вы можете регулярно проверять состояние двух миграций с помощью API "Получить состояние миграции организации" до тех пор, пока state миграция не изменится exported.

GET /api/v3/orgs/acme-corp/migrations/123 HTTP/1.1
Accept: application/vnd.github+json
Authorization: Bearer <TOKEN>
Host: github.acmecorp.net

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": 123,
  "state": "exported",
  // ...
}

Дополнительные сведения см. в разделе "Получение состояния миграции организации".

state После перехода exportedна миграцию можно получить URL-адрес миграции с помощью API загрузки архива миграции организации.

GET /api/v3/orgs/acme-corp/migrations/123/archive HTTP/1.1
Accept: application/vnd.github+json
Authorization: Bearer <TOKEN>
Host: github.acmecorp.net

HTTP/1.1 302 Found
Location: https://media.github.acmecorp.net/migrations/123/archive/cca2ebe9-7403-4ffa-9b6a-4c9e16c94410?token=AAAAABEWE7JP4H2HACKEGMTDOYRC6

API вернет 302 Found ответ с заголовком Location , перенаправляющимся на URL-адрес, в котором находится скачиваемый архив. Скачайте два файла: один для источника Git и один для метаданных.

Дополнительные сведения см. в разделе "Скачивание архива миграции организации".

После завершения обоих миграций и скачивания архивов можно перейти к следующему шагу.

Шаг 6. Отправка архивов миграции

Чтобы импортировать данные в GitHub Enterprise Cloud, вы должны передать оба архива для каждого репозитория (исходный код Git и метаданные) с вашей машины в GitHub, используя наш API GraphQL.

Если вы используете GitHub Enterprise Server версию 3.7 или ниже, сначала нужно сгенерировать URL-адреса архивов, доступных через GitHub. Большинство клиентов предпочитают отправлять архивы в службу хранилища BLOB-объектов поставщика облачных служб, например Amazon S3 или Хранилище BLOB-объектов Azure, а затем создать короткий URL-адрес для каждого.

Если вы используете GitHub Enterprise Server версию 3.8 или выше, ваш экземпляр загружает архивы и генерирует URL-адреса. Заголовок Location на предыдущем шаге возвращает короткий URL-адрес.

Возможно, вам нужно добавить IP-диапазоны разрешительных GitHubсписков. Дополнительные сведения см. в разделе Управление доступом к миграции между продуктами GitHub.

Загрузка ваших архивов миграции в GitHub-owned blob storage

Если вы используете GitHub-owned blob storage, вы загрузите свой архив GitHub-owned blob storage следующим образом:

1. Создание многопартийной отправки путем отправки запроса POST
2. Отправка архива в нескольких частях размером до 100 МБ в виде запросов PATCH
3. Отправка запроса PUT для завершения отправки

1. Создание многопартийной отправки

Вы отправите запрос POST на следующие действия:

https://uploads.github.com/organizations/{organization_id}/gei/archive/blobs/uploads

Включите текст JSON, как показано ниже, с именем и размером архива. Тип контента может оставаться как "application/octet-stream" для всех отправлений.

{
"content_type": "application/octet-stream",
"name": "git-archive.tar.gz",
"size": 262144000
}

При этом возвращается ответ объекта JSON следующим образом:

{
  "guid": "363b2659-b8a3-4878-bfff-eed4bcb54d35",
  "node_id": "MA_kgDaACQzNjNiMjY1OS1iOGEzLTQ4NzgtYmZmZi1lZWQ0YmNiNTRkMzU",
  "name": "git-archive.tar.gz",
  "size": 33287,
  "uri": "gei://archive/363b2659-b8a3-4878-bfff-eed4bcb54d35",
  "created_at": "2024-11-13T12:35:45.761-08:00"
}

Этот универсальный код ресурса (URI) представляет загруженный архив и будет использоваться для запроса миграции при запуске миграции репозитория. Ответ также будет содержать расположение в заголовке ответа, используемом для отправки частей файлов с помощью запроса PATCH на следующем шаге:

/organizations/{organization_id}/gei/archive/blobs/uploads?part_number=1&guid=<guid>&upload_id=<upload_id>

2. Отправка архива в нескольких частях

Отправьте до 100 МБ файла в каждой части с запросом PATCH с помощью расположения из предыдущего заголовка ответа, обеспечивая отправку необработанных данных в тексте запроса без использования многопартийной формы. Если последняя часть файла меньше 100 МБ, отправьте только оставшиеся байты в этом последнем запросе:

https://uploads.github.com/{location}

При этом будет возвращен пустой текст ответа со следующим расположением в заголовке ответа:

/organizations/{organization_id}/gei/archive/blobs/uploads?part_number=2&guid=<guid>&upload_id=<upload_id>

Повторите эту процедуру до завершения отправки. Убедитесь, что вы зачитываете до 100 МБ файла за раз и отправляете запросы в новые значения расположения с добавочными part_number значениями.

3. Завершение отправки

Отправьте запрос PUT в значение "последний путь" из предыдущего шага с пустым текстом и отправка в хранилище GitHub завершена. URI GEI можно создать с помощью GUID из этого первоначального запроса POST в следующем формате:

gei://archive/{guid}

Шаг 7. Запуск миграции репозитория

При запуске миграции один репозиторий и его сопутствующие данные переносятся в новый репозиторий GitHub, который вы определяете.

Если вы хотите одновременно переместить несколько репозиториев из одной исходной организации, можно ставить в очередь несколько миграций. Одновременно можно выполнять до 5 миграций репозитория.

startRepositoryMigration мутация

mutation startRepositoryMigration (
  $sourceId: ID!,
  $ownerId: ID!,
  $repositoryName: String!,
  $continueOnError: Boolean!,
  $accessToken: String!,
  $githubPat: String!,
  $gitArchiveUrl: String!,
  $metadataArchiveUrl: String!,
  $sourceRepositoryUrl: URI!,
  $targetRepoVisibility: String!
){
  startRepositoryMigration( input: {
    sourceId: $sourceId,
    ownerId: $ownerId,
    repositoryName: $repositoryName,
    continueOnError: $continueOnError,
    accessToken: $accessToken,
    githubPat: $githubPat,
    targetRepoVisibility: $targetRepoVisibility
    gitArchiveUrl: $gitArchiveUrl,
    metadataArchiveUrl: $metadataArchiveUrl,
    sourceRepositoryUrl: $sourceRepositoryUrl,
  }) {
    repositoryMigration {
      id
      migrationSource {
        id
        name
        type
      }
      sourceUrl
    }
  }
}

gitArchiveUrl | -доступный URL для вашего архива исходного кода GitHub Enterprise CloudGit.

metadataArchiveUrl | -доступный URL для вашего архива GitHub Enterprise Cloudметаданных.

sourceRepositoryUrl | URL вашего репозитория в вашем GitHub Enterprise Server инстансе. Это обязательно, но GitHub Enterprise Cloud не будет напрямую общаться с вашим GitHub Enterprise Server экземпляром.

Для personal access token требований см. Управление доступом к миграции между продуктами GitHub.

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

Шаг 8. Проверка состояния миграции

Чтобы обнаружить любые сбои миграции и убедиться, что миграция работает, можно проверить состояние миграции с помощью getMigration запроса. Вы также можете проверить состояние нескольких миграций.getMigrations

Запрос getMigration возвращается с состоянием, чтобы сообщить, является queuedли миграция , in progress``failedили completed. Если миграция завершилась сбоем, Importer предоставит причину сбоя.

getMigration запрос

query (
  $id: ID!
){
  node( id: $id ) {
    ... on Migration {
      id
      sourceUrl
      migrationSource {
        name
      }
      state
      failureReason
    }
  }
}

Шаг 9. Проверка миграции и проверка журнала ошибок

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

Наконец, рекомендуется просмотреть перенесенные репозитории для проверки звука.