Перенос вашего портала Drupal 7 на интегрированный портал

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

В этом разделе представлены инструкции по планированию и выполнению миграции ресурсов вашего портала Drupal 7 на интегрированный портал.

Шаг 1. Создайте интегрированный портал

Прежде чем переносить ресурсы портала Drupal 7, вы должны создать интегрированный портал.

Чтобы создать интегрированный портал:

1. Убедитесь, что у вас есть соответствующие роли портала для управления интегрированным порталом.
2. Создайте интегрированный портал .

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

Шаг 2. Создайте интегрированный портал

Создайте интегрированный портал, как описано в разделе «Шаги по созданию портала» .

Как минимум вам потребуется выполнить действия, перечисленные в следующей таблице.

Шаг 3. Настройте поставщика удостоверений

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

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

Шаг 4. Контролируйте доступ к ресурсам с помощью аудиторий

Если вы используете роли в Drupal 7 для управления доступом к набору ресурсов, таких как документация API или создание ключей API для продукта API, вы можете добиться той же функциональности, используя аудитории на интегрированном портале.

В частности, с помощью аудиторий вы можете контролировать доступ к следующему ресурсу на интегрированном портале:

• Страницы вашего портала
• Опубликованные продукты API

Чтобы добавить аудиторию и управлять назначениями отдельных пользователей и групп разработчиков , см. Управление аудиториями . Когда новый пользователь создает учетную запись и входит на ваш портал, вам необходимо при необходимости назначить его одной или нескольким аудиториям, как описано в разделе «Управление назначениями для аудитории» .

Чтобы упростить миграцию, вы можете воспользоваться следующими советами:

• Назовите свою аудиторию в честь ролей Drupal, которые она заменяет.
• Управляйте членством аудитории с помощью команд разработчиков . Разработчики создают команды, чтобы разделить ответственность за свои приложения и управлять членством в команде.

Шаг 5. Опубликуйте свои API

Чтобы публиковать API и автоматически создавать справочную документацию по API с помощью SmartDocs на интегрированном портале, вам необходим доступ к спецификации OpenAPI, связанной с API.

Хотя вы, возможно, использовали спецификацию OpenAPI для автоматического создания SmartDocs в Drupal 7, в конечном итоге контент сохраняется с использованием внутреннего формата без какой-либо связи с исходной спецификацией OpenAPI. Команды API, использующие Apigee Edge, обычно хранят спецификации OpenAPI в хранилище спецификаций Apigee Edge.

Затем опубликуйте API на своем портале . Будьте готовы:

• Укажите спецификацию OpenAPI, которая будет использоваться в качестве источника документации, из хранилища спецификаций, локального каталога или URL-адреса.
• Настройте видимость документации (общедоступная, пользователи аутентификации или выбранные аудитории)
• Если необходимо, настройте URL-адрес обратного вызова.
• При желании добавьте изображение для отображения в вашем каталоге API.

Шаг 6. Разделите ответственность за приложение между командами разработчиков.

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

Ваши разработчики создают команды разработчиков, чтобы разделить ответственность за свои приложения и управлять членством в группах, как описано в разделе Разделение ответственности за приложение с помощью команд разработчиков (бета-версия) .

Возможно, вы захотите рассказать своему сообществу разработчиков о командах разработчиков и побудить их перенести свои приложения на использование команд разработчиков для разделения ответственности и перехода к использованию новых ключей API. Затем вы можете удалить все приложения компании и связанные с ними артефакты с помощью API Edge .

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

Шаг 7. Подготовьтесь к запуску интегрированного портала

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