Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
A partir del 31 de mayo de 2020, Apigee ya no patrocinará el hosting de portales para desarrolladores basados en Drupal 7 (D7P). Antes de esto, a partir del 31 de mayo de 2019, los clientes deben aprovisionar por cuenta propia cualquier portal nuevo basado en Drupal.
¿Qué cambios se están realizando?
En abril de 2019, anunciamos el lanzamiento de los equipos y públicos de desarrolladores para el portal integrado para desarrolladores de Apigee. En mayo de 2019, anunciamos la preparación para la producción de los portales basados en Drupal 8 (D8P), que ofrecen una nueva alternativa al portal administrado por el cliente y el portal integrado administrado por Apigee, además de los nuevos SmartDocs. Simultáneamente con el anuncio de D8P, anunciamos que finalizaría el hosting de D7P en 12 meses. Además, en la versión 20.06, se quitarán las secuencias de comandos de instalación y actualización de D7P en la nube privada.
¿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 convirtieron 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 desean 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.
¿Qué opciones hay que tener en cuenta?
Los clientes de Cloud que usan D7P tienen tres opciones:
- Migra a los portales integrados de Apigee.
- Migra a Drupal 8.
- Permanece en Drupal 7 y asume 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 ahora.
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 tener esto en cuenta?
Proveedores de API que usaron Drupal 7 con una cantidad mínima de personalización o que prefieren una solución todo en uno que esté 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 potente catálogo de API y un atractivo sistema de administración de contenido basado en Markdown con herramientas sólidas de administración de públicos. A fin de determinar si el portal integrado es una buena opción para tu programa de API, comunícate con tu representante de cuenta de Apigee.
Si deseas obtener orientación para planificar y ejecutar la migración de tus elementos del 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 tener esto en cuenta?
Proveedores de API que aprovecharon la funcionalidad de Drupal 7 junto con un alto grado de personalización y de inversión en la creación de una experiencia específica para desarrolladores.
Debido a las principales diferencias entre Drupal 7 y Drupal 8, como el motor de procesamiento de páginas, la recreación de personalizaciones similares puede requerir un cierto grado de trabajo personalizado. Si prevés la necesidad de contratar especialistas de Drupal 8, tu representante de cuenta de Apigee puede recomendarte socios expertos de desarrollo de Drupal. Si bien Apigee no proporciona hosting para D8P, Pantheon y Acquia tienen experiencia en hosting D8P para clientes de Apigee.
Opción 3: Permanece en Drupal 7
¿Quién debería tener esto en cuenta?
Proveedores de API que ya usan Drupal 7 y simplemente 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 puedo exportar 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 tomo las medidas necesarias?
Después del 31 de mayo de 2020, D7P ya no estará disponible para usted ni para sus clientes. No podrás administrar ni desarrollar en D7P, y tus clientes no podrán acceder al portal del D7P. Todos los portales D7P alojados en Apigee se retirarán 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”.
¿Existen 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 cuenta de Apigee puede comunicarte con expertos de Drupal que pueden ayudarte con la migración y el desarrollo personalizado.
¿Existen herramientas o asistencia disponibles para ayudar con la migración de D7P a portales integrados?
Si deseas obtener orientación para planificar y ejecutar la migración de tus elementos del 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 realizaron una gran inversión en el desarrollo personalizado y que podrían no transferirse bien, como las herramientas de aprobación o los flujos de trabajo específicos. Comunícate con tu representante de cuenta de Apigee para obtener más información.
¿Qué cambios se realizaron en SmartDocs?
En las siguientes secciones, se describen los cambios que se realizaron en los nuevos SmartDocs en 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 estés familiarizado con SmartDocs que se usan con los portales para desarrolladores de Drupal 7. Consulta Cómo usar SmartDocs para documentar las APIs.
SmartDocs en Drupal 8 ofrece muchas de las funciones que encontrarás 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 Cómo documentar tus APIs.
¿La OpenAPI Specification 3.0.x es compatible con SmartDocs?
OpenAPI Specification 3.0.x es compatible con los nuevos SmartDocs disponibles en el portal de Drupal 8. En el futuro, se mejorará la compatibilidad con las funciones nuevas 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 con extremos protegidos mediante la autenticación Básica, Clave de API o 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.
¿Es SmartDocs mi única opción de documentación de la API?
SmartDocs es la solución lista para usar de Apigee para la documentación de las API basada en una especificación de OpenAPI, pero Apigee reconoce que es bueno contar con opciones. Para 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.