Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info
À compter du 31 mai 2020, Apigee ne sponsorisera plus l'hébergement des portails des développeurs (D7P) basés sur Drupal 7. Avant cela, à compter du 31 mai 2019, les clients devront autoprovisionner tout nouveau portail basé sur Drupal.
Quels changements sont apportés ?
En avril 2019, nous avons annoncé le lancement des équipes de développement et des audiences pour le portail des développeurs intégré Apigee. En mai 2019, nous avons annoncé la disponibilité en production des portails basés sur Drupal 8 (D8P), qui constituent une nouvelle alternative de portail gérée par le client au portail intégré géré par Apigee et incluent les nouveaux SmartDocs. En même temps que l'annonce de la D8P, nous avons annoncé la fin de l'hébergement de la D7P dans 12 mois et que les scripts d'installation et de mise à niveau de la D7P dans le cloud privé seront supprimés dans la version 20.06.
Pourquoi l'hébergement sponsorisé par Apigee pour les portails des développeurs basés sur Drupal 7 prend-il fin ?
L'hébergement sponsorisé par Apigee pour D7P prendra fin en mai 2020 pour deux raisons:
- Les portails intégrés d'Apigee sont devenus une option attrayante pour les clients, avec des fonctionnalités avancées et un coût total de possession inférieur.
- Drupal 8 représente la voie à suivre pour ceux qui souhaitent rester sur la voie Drupal. Bien que l'effort de migration du D7P vers le D8P ne soit pas anodin, le D8P offre une meilleure trajectoire pour tout client qui préfère un portail de développeur autogéré.
Que dois-je faire ?
Les clients Apigee D7P doivent évaluer les alternatives disponibles et établir une relation directe avec un fournisseur d'hébergement de leur choix, tel que Pantheon ou Acquia, ou envisager d'autres options d'hébergement.
Quelles options s'offrent à vous ?
Les clients Cloud qui utilisent D7P ont trois options:
- Passez aux portails intégrés d'Apigee.
- Migrez vers Drupal 8.
- Rester sur Drupal 7 et assumer la responsabilité de l'hébergement d'ici le 31 mai 2020.
Les clients de cloud privé qui utilisent D7P ont deux options:
- Migrez vers Drupal 8.
- Pour l'instant, restez sur Drupal 7.
Chacune de ces options est décrite plus en détail ci-dessous.
Option 1: Passer à un portail intégré Apigee
À qui s'adresse cette question ?
Les fournisseurs d'API qui utilisent Drupal 7 avec une personnalisation minimale ou ceux qui préfèrent une solution tout-en-un plus orientée 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 basé sur Markdown attrayant, avec des outils de gestion des audiences performants. Pour déterminer si le portail intégré peut convenir à votre programme d'API, contactez votre représentant du compte Apigee.
Pour savoir comment planifier et exécuter la migration des composants de votre portail Drupal 7 vers le portail intégré, consultez Migrer votre portail Drupal 7 vers le portail intégré.
Option 2: Migrer vers Drupal 8
À qui s'adresse cette question ?
Fournisseurs d'API qui ont exploité les fonctionnalités de Drupal 7 en combinant un haut niveau de personnalisation et d'investissement pour créer une expérience spécifique pour les développeurs.
En raison des différences majeures entre Drupal 7 et Drupal 8, telles que le moteur de rendu de page, la recréation de personnalisations similaires peut nécessiter un certain degré de travail personnalisé. Si vous prévoyez de faire appel à des spécialistes Drupal 8, votre représentant du compte Apigee peut vous recommander des partenaires de développement Drupal experts. Bien qu'Apigee ne fournisse pas d'hébergement pour le D8P, Pantheon et Acquia ont de l'expérience dans l'hébergement du D8P pour les clients Apigee.
Option 3: Rester sur Drupal 7
À qui s'adresse cette question ?
Les fournisseurs d'API qui utilisent déjà Drupal 7 et qui souhaitent simplement prendre 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. L'assistance des modules qui intègrent Drupal 7 à Apigee Edge n'est pas affectée par cette annonce d'hébergement. Toutefois, notez que tout client cloud souhaitant conserver Drupal 7 doit assumer la responsabilité directe de son compte auprès de son fournisseur d'hébergement d'ici le 31 mai 2020.
Comment faire exporter mes données (clients cloud) ?
Pour exporter vos données Drupal, consultez le processus d'exportation Pantheon ou Acquia.
Que se passe-t-il si je ne prends pas les mesures nécessaires ?
Après le 31 mai 2020, vous et vos clients ne pourrez plus utiliser D7P. 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 obtenir plus d'informations ou de l'aide ?
Pour en savoir plus sur la fin de l'hébergement du portail des développeurs Drupal 7, veuillez créer une demande dans le portail d'assistance Apigee en indiquant "Portail des développeurs basé sur Drupal 7 – Hébergement" dans l'objet.
Des outils ou une assistance sont-ils disponibles pour faciliter la migration de D7P vers D8P ?
Bien qu'Apigee ne fournisse pas d'assistance directe pour Drupal, votre représentant de compte Apigee peut vous mettre en relation avec des experts Drupal qui peuvent vous aider à migrer et à développer des applications personnalisées.
Existe-t-il des outils ou une assistance pour faciliter la migration des D7P vers des portails intégrés ?
Pour savoir comment planifier et exécuter la migration des composants 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 à effectuer la migration. Les meilleurs candidats sont ceux qui n'ont pas investi beaucoup dans le développement personnalisé qui pourrait ne pas être bien transféré, comme des workflows ou des outils d'approbation spécifiques. Pour en savoir plus, contactez le responsable de votre compte Apigee.
Quelles modifications ont été apportées à SmartDocs ?
Les sections suivantes décrivent les modifications apportées aux nouveaux SmartDocs dans Drupal 8 par rapport à Drupal 7.
En quoi la nouvelle fonctionnalité SmartDocs diffère-t-elle de la version basée sur Drupal 7 ?
Vous connaissez peut-être SmartDocs, qui est utilisé avec les portails des développeurs Drupal 7. Consultez Utiliser SmartDocs pour documenter les 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 la section Documenter vos API.
La spécification OpenAPI 3.0.x est-elle compatible avec SmartDocs ?
La spécification OpenAPI 3.0.x est compatible avec les nouveaux SmartDocs disponibles dans le portail Drupal 8. Nous prévoyons d'améliorer la prise en charge des nouvelles fonctionnalités de la spécification à l'avenir.
Quels types d'authentification sont 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 de base, de clé API ou OAuth, en fonction de la méthode de sécurité définie dans votre spécification OpenAPI. Pour OAuth, les flux suivants sont compatibles : code d'autorisation, implicite, mot de passe et identifiants client.
SmartDocs est-il ma seule option pour la documentation de l'API ?
SmartDocs est la solution prête à l'emploi d'Apigee pour la documentation des API basée sur une spécification OpenAPI. Toutefois, Apigee reconnaît qu'il est utile d'avoir le choix. Pour les portails Drupal 8, le module de catalogue d'API prend en charge des solutions de rendu supplémentaires, telles que le formateur de champ de l'UI Swagger.