Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
À compter du 31 mai 2020, Apigee ne parrainera plus l'hébergement de portails de développeurs basés sur Drupal 7 (D7P). Jusqu'à cette date, à compter du 31 mai 2019, les clients devaient provisionner eux-mêmes tout nouveau portail basé sur Drupal.
Quelles modifications sont apportées ?
En avril 2019, nous avons annoncé le lancement des équipes et audiences de développeurs pour le portail intégré des développeurs Apigee. En mai 2019, nous avons annoncé que les portails Drupal 8 (D8P) sont prêts à être utilisés pour la production. Ce portail propose une alternative au portail intégré géré par le client, comprenant le nouveau SmartDocs. Parallèlement à l'annonce de D8P, nous avons annoncé la fin de l'hébergement de D7P dans 12 mois, et les scripts d'installation et de mise à niveau pour le cloud privé D7P seront supprimés dans la version 20.06.
Pourquoi l'hébergement parrainé par Apigee prend-il fin pour les portails de développeurs basés sur Drupal 7 ?
L'hébergement parrainé par Apigee pour D7P prendra fin en mai 2020 pour deux raisons:
- Les portails intégrés d'Apigee sont devenus une option intéressante pour les clients grâce à leurs fonctionnalités avancées et à leur coût total de possession réduit.
- Drupal 8 représente la voie à suivre pour ceux qui souhaitent rester sur le circuit Drupal. Bien que la migration de D7P vers D8P soit fructueuse, D8P offre une meilleure trajectoire à tous les clients qui préfèrent un portail autogéré pour les développeurs.
Que dois-je faire ?
Les clients d'Apigee D7P doivent évaluer les alternatives disponibles et établir une relation directe avec un fournisseur d'hébergement privilégié, tel que Pantheon ou Acquia, ou envisager d'autres options d'hébergement.
Quelles sont les options à envisager ?
Les clients Cloud qui utilisent D7P ont trois options:
- Passez aux portails intégrés d'Apigee.
- Migrez vers Drupal 8.
- Restez sur Drupal 7 et assumez la responsabilité de l'hébergement d'ici le 31 mai 2020.
Les clients du cloud privé qui utilisent D7P ont deux options:
- Migrez vers Drupal 8.
- Restez sur Drupal 7 pour le moment.
Chacune de ces options est abordée plus en détail ci-dessous.
Option n° 1: Déplacer vers un portail intégré Apigee
À qui s'adresse cet examen ?
Les fournisseurs d'API qui utilisent Drupal 7 avec peu de personnalisation ou ceux qui préfèrent une solution tout-en-un davantage axée sur la configuration avec un coût total de possession inférieur.
Le portail des développeurs intégré directement à Apigee Edge comprend un puissant catalogue d'API et un système de gestion de contenu attrayant basé sur Markdown avec des outils performants de gestion des audiences. Pour déterminer si le portail intégré est adapté à votre programme d'API, contactez votre responsable de compte Apigee.
Pour obtenir des conseils sur la planification et l'exécution de la migration des éléments de votre portail Drupal 7 vers le portail intégré, consultez Migrer votre portail Drupal 7 vers le portail intégré.
Option n° 2: Passer à Drupal 8
À qui s'adresse cet examen ?
Les fournisseurs d'API qui ont exploité les fonctionnalités de Drupal 7 conjointement avec un haut degré de personnalisation et un haut niveau d'investissement pour créer une expérience de développement spécifique.
En raison des principales différences entre Drupal 7 et Drupal 8, telles que le moteur de rendu des pages, la recréation de personnalisations similaires peut nécessiter un certain travail de personnalisation. Si vous pensez avoir besoin de faire appel à des spécialistes Drupal 8, votre responsable de compte Apigee peut vous recommander des partenaires experts de développement Drupal. Bien qu'Apigee ne fournisse pas d'hébergement pour D8P, Pantheon et Acquia ont de l'expérience dans l'hébergement de D8P pour leurs clients Apigee.
Option n° 3: Rester sur Drupal 7
À qui s'adresse cet examen ?
Les fournisseurs d'API qui utilisent déjà Drupal 7, et qui veulent simplement avoir plus de temps pour prendre une décision.
Le projet Drupal 7 a publié des calendriers pour le support à long terme (LTS) jusqu'en 2021. La prise en charge des modules qui intègrent Drupal 7 avec Apigee Edge n'est pas affectée par cette annonce sur l'hébergement. Notez toutefois que tout client cloud souhaitant rester sur Drupal 7 doit assumer la responsabilité directe du compte auprès de son fournisseur d'hébergement d'ici le 31 mai 2020.
Comment exporter mes données (clients Cloud) ?
Pour exporter vos données Drupal, reportez-vous au processus d'exportation Pantheon ou Acquia.
Que se passera-t-il si je ne prends pas les mesures nécessaires ?
Après le 31 mai 2020, D7P ne sera plus disponible pour vous et vos clients. Vous ne pourrez pas administrer ni développer sur D7P, et vos clients ne pourront pas se connecter à votre portail D7P. Tous les portails D7P hébergés par Apigee seront mis hors service après le 31 mai 2020.
Qui dois-je contacter pour en savoir plus ou obtenir de l'aide ?
Pour demander des informations supplémentaires sur la fin de l'hébergement de D7P, veuillez enregistrer une demande sur le portail d'assistance Apigee ayant pour objet "Portail des développeurs Drupal 7 - hébergement".
Existe-t-il des outils ou une assistance pour faciliter la migration de D7P vers D8P ?
Bien qu'Apigee ne fournisse pas d'assistance directe pour Drupal, votre responsable de compte Apigee peut vous mettre en relation avec des experts Drupal qui pourront vous aider dans la migration et le développement personnalisé.
Existe-t-il des outils ou une assistance pour faciliter la migration de D7P vers des portails intégrés ?
Pour obtenir des conseils sur la planification et l'exécution de la migration des éléments de votre portail Drupal 7 vers le portail intégré, consultez Migrer votre portail Drupal 7 vers le portail intégré.
Bien qu'aucun outil ne soit disponible pour migrer de Drupal vers le portail géré par Apigee, Apigee peut vous aider dans votre migration. Les meilleurs candidats sont ceux qui n'ont pas beaucoup investi dans le développement personnalisé et qui risquent de ne pas être correctement transférés, tels que des workflows spécifiques ou des outils d'approbation. Pour en savoir plus, contactez votre responsable de compte Apigee.
Quelles modifications ont été apportées aux documents SmartDocs ?
Les sections suivantes décrivent les modifications apportées aux nouveaux SmartDocs dans Drupal 8 par rapport à Drupal 7.
Quelle est la différence entre la nouvelle fonctionnalité SmartDocs et la version basée sur Drupal 7 ?
Vous connaissez peut-être les SmartDocs utilisés avec les portails pour développeurs Drupal 7. Consultez la section Utiliser SmartDocs pour documenter des API.
SmartDocs dans Drupal 8 offre de nombreuses fonctionnalités que vous attendez de la documentation de référence de l'API et s'exécute désormais directement à partir d'une spécification OpenAPI. Pour en savoir plus, consultez Documenter vos API.
La spécification OpenAPI 3.0.x est-elle compatible avec SmartDocs ?
La spécification OpenAPI 3.0.x est prise en charge par les nouveaux documents SmartDocs disponibles sur le portail Drupal 8. Attendez-vous à améliorer la prise en charge des nouvelles fonctionnalités de la spécification à l'avenir.
Quels sont les types d'authentification compatibles avec SmartDocs ?
Le panneau "Essayer cette API" de SmartDocs fonctionne avec des points de terminaison non sécurisés ou sécurisés à l'aide de l'authentification Basic, par clé API ou OAuth, selon la méthode de sécurité définie dans la spécification OpenAPI. Pour OAuth, les flux suivants sont compatibles : code d'autorisation, implicite, mot de passe et identifiants client.
La documentation de l'API est-elle la seule option SmartDocs ?
SmartDocs est la solution prête à l'emploi d'Apigee pour la documentation sur les API et basée sur une spécification OpenAPI. Cependant, Apigee reconnaît que les options sont une bonne chose. Pour les portails Drupal 8, le module du catalogue d'API accepte des solutions de rendu supplémentaires, telles que le formateur de champ d'UI Swagger.