Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация
С 31 мая 2020 г. Apigee больше не будет спонсировать хостинг порталов разработчиков на базе Drupal 7 (D7P). До этого, начиная с 31 мая 2019 г., клиенты должны самостоятельно подготовить любой новый портал на базе Drupal.
Какие изменения вносятся?
В апреле 2019 года мы объявили о запуске групп разработчиков и аудиторий для интегрированного портала разработчиков Apigee. В мае 2019 года мы объявили о готовности к производству порталов на базе Drupal 8 (D8P) , которые предоставляют новую управляемую клиентом альтернативу интегрированному порталу, управляемому Apigee, и включают в себя новый SmartDocs . Одновременно с анонсом D8P мы объявили об окончании хостинга D7P через 12 месяцев и о том, что сценарии установки и обновления для частного облака D7P будут удалены в выпуске 20.06.
Почему прекращается спонсируемый Apigee хостинг для порталов разработчиков на базе Drupal 7?
Хостинг для D7P, спонсируемый Apigee, прекратится в мае 2020 года по двум причинам:
- Интегрированные порталы Apigee стали привлекательным вариантом для клиентов благодаря расширенным функциям и более низкой совокупной стоимости владения.
- Drupal 8 представляет собой путь вперед для тех, кто хочет оставаться на пути Drupal. Хотя переход с D7P на D8P нетривиален, D8P предлагает лучший путь для любого клиента, который предпочитает самоуправляемый портал разработчиков.
Какие действия мне нужно предпринять?
Клиенты Apigee D7P должны оценить доступные альтернативы и либо установить прямые отношения с предпочтительным хостинг-провайдером, например Pantheon или Acquia, либо рассмотреть другие варианты хостинга.
Какие варианты следует рассмотреть?
У облачных клиентов , использующих D7P, есть три варианта:
- Перейдите на интегрированные порталы Apigee.
- Перейдите на Drupal 8.
- Оставайтесь на Drupal 7 и примите на себя ответственность за хостинг до 31 мая 2020 года.
У клиентов частного облака , использующих D7P, есть два варианта:
- Перейдите на Drupal 8.
- Пока оставайтесь на Drupal 7.
Каждый из этих вариантов обсуждается более подробно ниже.
Вариант 1. Перейти на интегрированный портал Apigee.
Кому следует это учитывать?
Поставщики API, которые использовали Drupal 7 с минимальным количеством настроек или те, кто предпочитает комплексное решение, более ориентированное на настройку с более низкой совокупной стоимостью владения.
Портал разработчиков, интегрированный непосредственно в Apigee Edge, включает в себя мощный каталог API и привлекательную систему управления контентом на основе Markdown с надежными инструментами управления аудиторией. Чтобы определить, подходит ли интегрированный портал для вашей программы API, свяжитесь с представителем Apigee.
Рекомендации по планированию и выполнению миграции ресурсов портала Drupal 7 на интегрированный портал см. в разделе Миграция портала Drupal 7 на интегрированный портал .
Вариант №2: перейти на Drupal 8
Кому следует это учитывать?
Поставщики API, которые использовали функциональность Drupal 7 в сочетании с высокой степенью настройки и инвестициями в создание конкретного опыта разработки.
Из-за существенных различий между Drupal 7 и Drupal 8, таких как механизм рендеринга страниц, воссоздание подобных настроек может потребовать значительной степени индивидуальной работы. Если вы предполагаете необходимость привлечения специалистов по Drupal 8, ваш представитель Apigee может порекомендовать вам опытных партнеров по разработке Drupal. Хотя Apigee не предоставляет хостинг для D8P, Pantheon и Acquia имеют опыт хостинга D8P для клиентов Apigee.
Вариант №3: остаться на Drupal 7
Кому следует это учитывать?
Поставщики API, уже использующие Drupal 7, которым просто нужно больше времени для принятия решения.
Проект Drupal 7 опубликовал график долгосрочной поддержки (LTS) до 2021 года. Это объявление о хостинге не затрагивает поддержку модулей, интегрирующих Drupal 7 с Apigee Edge. Однако обратите внимание, что любой облачный клиент, желающий остаться на Drupal 7, должен принять на себя прямую ответственность за учетную запись своего хостинг-провайдера до 31 мая 2020 года.
Как мне экспортировать мои данные (клиенты облака)?
Чтобы экспортировать данные Drupal, обратитесь к процессу экспорта Pantheon или Acquia .
Что будет, если я не предприму необходимые действия?
После 31 мая 2020 г. D7P будет недоступен для вас и ваших клиентов. Вы не сможете администрировать или разрабатывать D7P, а ваши клиенты не смогут войти на ваш портал D7P. Все порталы D7P, размещенные на Apigee, будут выведены из эксплуатации после 31 мая 2020 года.
К кому мне обратиться за дополнительной информацией или помощью?
Чтобы запросить дополнительную информацию об окончании хостинга для D7P, зарегистрируйте заявку на портале поддержки Apigee с темой «Портал разработчиков на базе Drupal 7 — хостинг».
Существуют ли какие-либо инструменты или поддержка, которые помогут при переходе с D7P на D8P?
Хотя Apigee не предоставляет прямую поддержку Drupal, ваш представитель Apigee может связать вас с экспертами Drupal, которые могут помочь в миграции и индивидуальной разработке.
Существуют ли какие-либо инструменты или поддержка, которые помогут с миграцией D7P на интегрированные порталы?
Рекомендации по планированию и выполнению миграции ресурсов портала Drupal 7 на интегрированный портал см. в разделе Миграция портала Drupal 7 на интегрированный портал .
Хотя инструментов для миграции с Drupal на портал, управляемый Apigee, нет, Apigee может помочь вам с миграцией. Лучшими кандидатами являются те, кто не вложил значительные средства в индивидуальные разработки, которые могут плохо переноситься, например, в конкретные рабочие процессы или инструменты утверждения. Для получения дополнительной информации обратитесь к представителю вашего аккаунта Apigee.
Какие изменения были внесены в SmartDocs?
В следующих разделах описаны изменения, внесенные в новый SmartDocs в Drupal 8 по сравнению с Drupal 7.
Чем новая функция SmartDocs отличается от версии на базе Drupal 7?
Возможно, вы знакомы со SmartDocs, используемым на порталах разработчиков Drupal 7. См. Использование SmartDocs для документирования API .
SmartDocs в Drupal 8 предоставляет многие функции, которые вы ожидаете от справочной документации API, и теперь запускается непосредственно из спецификации OpenAPI. Дополнительную информацию см. в разделе Документирование API .
Поддерживается ли спецификация OpenAPI 3.0.x в SmartDocs?
Спецификация OpenAPI 3.0.x поддерживается новым SmartDocs, доступным на портале Drupal 8. Ожидайте улучшенной поддержки новых функций спецификации в будущем.
Какие типы аутентификации поддерживаются SmartDocs?
Панель «Попробуйте этот API» в SmartDocs работает с незащищенными конечными точками или с защищенными конечными точками, использующими базовую аутентификацию, ключ API или аутентификацию OAuth, в зависимости от метода безопасности, определенного в вашей спецификации OpenAPI. Для OAuth поддерживаются следующие потоки: код авторизации, неявный пароль и учетные данные клиента.
Является ли SmartDocs моим единственным вариантом документации по API?
SmartDocs — это готовое решение Apigee для документации API, основанное на спецификации OpenAPI, но Apigee признает, что хорошо иметь варианты. Для порталов Drupal 8 модуль API Catalog поддерживает дополнительные решения для рендеринга, такие как Swagger UI Field Formatter .