Estás viendo la documentación de Apigee Edge.
Ve a la
documentación de Apigee X. info
A partir del 31 de mayo de 2020, Apigee ya no patrocinará el alojamiento de portales para desarrolladores (D7P) basados en Drupal 7. Antes de eso, a partir del 31 de mayo de 2019, los clientes deben aprovisionar por su cuenta cualquier portal nuevo basado en Drupal.
¿Qué cambios se realizarán?
En abril de 2019, anunciamos el lanzamiento de equipos y públicos de desarrolladores para el portal integrado para desarrolladores de Apigee. En mayo de 2019, anunciamos que los portales basados en Drupal 8 (D8P) estaban listos para la producción, lo que proporciona una nueva alternativa de portal administrado por el cliente al portal integrado administrado por Apigee y que incluye los nuevos SmartDocs. Al mismo tiempo que anunciamos la versión D8P, anunciamos que finalizará el alojamiento de la versión D7P dentro de 12 meses y que se quitarán las secuencias de comandos de instalación y actualización de la versión D7P de la nube privada en la versión 20.06.
¿Por qué finalizará el hosting patrocinado por Apigee para los portales para desarrolladores basados en Drupal 7?
El hosting patrocinado por Apigee para D7P finalizará en mayo de 2020 por dos motivos:
- Los portales integrados de Apigee se han convertido en una opción atractiva para los clientes, con funciones avanzadas y un costo total de propiedad más bajo.
- Drupal 8 representa el camino a seguir para quienes deseen permanecer en el segmento de Drupal. Si bien el esfuerzo de migración de D7P a D8P no es trivial, D8P ofrece una mejor trayectoria para cualquier cliente que prefiera un portal para desarrolladores autoadministrado.
¿Qué acciones debo realizar?
Los clientes de Apigee D7P deben evaluar las alternativas disponibles y establecer una relación directa con un proveedor de hosting preferido, como Pantheon o Acquia, o considerar otras opciones de hosting.
¿Cuáles son las opciones que debes considerar?
Los clientes de Cloud que usan D7P tienen tres opciones:
- Cambia a los portales integrados de Apigee.
- Migra a Drupal 8.
- Permanecer en Drupal 7 y asumir la responsabilidad de hosting antes del 31 de mayo de 2020
Los clientes de la nube privada que usan D7P tienen dos opciones:
- Migra a Drupal 8.
- Permanece en Drupal 7 por el momento.
Cada una de estas opciones se analiza con más detalle a continuación.
Opción 1: Cambia a un portal integrado de Apigee
¿Quién debería considerar esto?
Proveedores de APIs que usan Drupal 7 con una cantidad mínima de personalización o que prefieren una solución todo en uno más orientada a la configuración con un costo total de propiedad más bajo.
El portal para desarrolladores integrado directamente en Apigee Edge incluye un catálogo de APIs potente y un sistema de administración de contenido basado en Markdown atractivo con herramientas sólidas de administración de públicos. Para determinar si el portal integrado es adecuado para tu programa de API, comunícate con tu representante de cuenta de Apigee.
Para obtener orientación sobre cómo planificar y ejecutar la migración de los recursos de tu portal de Drupal 7 al portal integrado, consulta Cómo migrar tu portal de Drupal 7 al portal integrado.
Opción 2: Migra a Drupal 8
¿Quién debería considerar esto?
Proveedores de APIs que aprovecharon la funcionalidad de Drupal 7 junto con un alto grado de personalización y de inversión para crear una experiencia específica para desarrolladores.
Debido a las principales diferencias entre Drupal 7 y Drupal 8, como el motor de renderización de páginas, recrear personalizaciones similares puede requerir un grado considerable de trabajo personalizado. Si anticipas la necesidad de contratar especialistas en Drupal 8, tu representante de cuenta de Apigee puede recomendarte socios expertos en desarrollo de Drupal. Si bien Apigee no proporciona hosting para D8P, Pantheon y Acquia tienen experiencia en el hosting de D8P para clientes de Apigee.
Opción 3: Permanecer en Drupal 7
¿Quién debería considerar esto?
Proveedores de API que ya usan Drupal 7 y que solo quieren más tiempo para tomar una decisión.
El proyecto Drupal 7 publicó cronogramas para la asistencia a largo plazo (LTS) hasta 2021. La compatibilidad de los módulos que integran Drupal 7 con Apigee Edge no se ve afectada por este anuncio de hosting. Sin embargo, ten en cuenta que cualquier cliente de la nube que desee permanecer en Drupal 7 debe asumir la responsabilidad directa de la cuenta con su proveedor de hosting antes del 31 de mayo de 2020.
¿Cómo exporto mis datos (clientes de la nube)?
Para exportar tus datos de Drupal, consulta el proceso de exportación de Pantheon o Acquia.
¿Qué sucederá si no realizo las acciones necesarias?
Después del 31 de mayo de 2020, D7P no estará disponible para ti ni para tus clientes. No podrás administrar ni desarrollar en D7P, y tus clientes no podrán acceder a tu portal de D7P. Todos los portales de D7P alojados en Apigee se darán de baja después del 31 de mayo de 2020.
¿Con quién debo comunicarme para obtener más información o ayuda?
Para solicitar detalles adicionales sobre el fin del hosting de D7P, registra un ticket en el portal de asistencia de Apigee con el asunto "Portal para desarrolladores basado en Drupal 7: hosting".
¿Hay herramientas o asistencia disponibles para ayudar con la migración de D7P a D8P?
Si bien Apigee no proporciona asistencia directa para Drupal, tu representante de la cuenta de Apigee puede ayudarte a comunicarte con expertos en Drupal que puedan ayudarte con la migración y el desarrollo personalizado.
¿Hay herramientas o asistencia disponibles para ayudar con la migración de D7P a los portales integrados?
Para obtener orientación sobre cómo planificar y ejecutar la migración de los recursos de tu portal de Drupal 7 al portal integrado, consulta Cómo migrar tu portal de Drupal 7 al portal integrado.
Si bien no hay herramientas disponibles para migrar de Drupal al portal administrado por Apigee, es posible que Apigee pueda ayudarte con la migración. Los mejores candidatos son aquellos que no invirtieron mucho en el desarrollo personalizado que podría no transferirse bien, como flujos de trabajo o herramientas de aprobación específicos. Comunícate con el representante de tu cuenta de Apigee para obtener más información.
¿Qué cambios se hicieron en SmartDocs?
En las siguientes secciones, se describen los cambios que se realizaron en los nuevos SmartDocs de Drupal 8 en comparación con Drupal 7.
¿Cómo se compara la nueva función SmartDocs con la versión basada en Drupal 7?
Es posible que conozcas SmartDocs, que se usa con los portales para desarrolladores de Drupal 7. Consulta Cómo usar SmartDocs para documentar APIs.
SmartDocs en Drupal 8 ofrece muchas de las funciones que esperas en la documentación de referencia de la API y ahora se ejecuta directamente desde una especificación de OpenAPI. Para obtener más información, consulta Documenta tus APIs.
¿La especificación de OpenAPI 3.0.x es compatible con SmartDocs?
Los nuevos SmartDocs disponibles en el portal de Drupal 8 admiten la especificación de OpenAPI 3.0.x. En el futuro, se espera que haya una mejor compatibilidad con las nuevas funciones de la especificación.
¿Qué tipos de autenticación son compatibles con SmartDocs?
El panel Prueba esta API en SmartDocs funciona con extremos no seguros o extremos seguros con Basic, clave de API, o autenticación de OAuth, según el método de seguridad definido en tu especificación de OpenAPI. Para OAuth, se admiten los siguientes flujos: código de autorización, implícito, contraseña y credenciales del cliente.
¿SmartDocs es mi única opción para la documentación de la API?
SmartDocs es la solución lista para usar de Apigee para la documentación de la API basada en una especificación de OpenAPI, pero Apigee reconoce que es bueno tener opciones. En el caso de los portales de Drupal 8, el módulo del catálogo de la API admite soluciones de renderización adicionales, como el formateador de campos de la IU de Swagger.