Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
A partire dal 31 maggio 2020, Apigee non sponsorizzerà più l'hosting di portali per sviluppatori (D7P) basati su Drupal 7. Prima di questa data, a partire dal 31 maggio 2019, i clienti dovranno eseguire il provisioning autonomo di qualsiasi nuovo portale basato su Drupal.
Quali modifiche verranno apportate?
Ad aprile 2019 abbiamo annunciato il lancio di Team di sviluppatori e segmenti di pubblico per il portale per sviluppatori integrato di Apigee. A maggio 2019 abbiamo annunciato la disponibilità per la produzione dei portali basati su Drupal 8 (D8P), che offrono una nuova alternativa al portale integrato gestito da Apigee e includono i nuovi SmartDocs. Contemporaneamente all'annuncio di D8P, abbiamo annunciato la fine dell'hosting per D7P tra 12 mesi e che gli script di installazione e upgrade per il cloud privato D7P verranno rimossi nella release 20.06.
Perché l'hosting sponsorizzato da Apigee per i portali per sviluppatori basati su Drupal 7 sta per terminare?
L'hosting sponsorizzato da Apigee per D7P terminerà a maggio 2020 per due motivi:
- I portali integrati di Apigee sono diventati un'opzione interessante per i clienti, grazie a funzionalità avanzate e a un costo totale di proprietà inferiore.
- Drupal 8 rappresenta il percorso da seguire per chi vuole rimanere sulla strada di Drupal. Anche se l'impegno richiesto per la migrazione da D7P a D8P non è banale, D8P offre una traiettoria migliore per qualsiasi cliente che preferisca un portale per sviluppatori autogestito.
Che cosa devo fare?
I clienti di Apigee D7P devono valutare le alternative disponibili e stabilire un rapporto diretto con un fornitore di hosting preferito, come Pantheon o Acquia, oppure prendere in considerazione altre opzioni di hosting.
Quali sono le opzioni da prendere in considerazione?
I clienti di Cloud che utilizzano D7P hanno tre opzioni:
- Passa ai portali integrati di Apigee.
- Esegui la migrazione a Drupal 8.
- Rimanere su Drupal 7 e assumere la responsabilità dell'hosting entro il 31 maggio 2020.
I clienti del cloud privato che utilizzano D7P hanno due opzioni:
- Esegui la migrazione a Drupal 8.
- Per il momento, mantieni Drupal 7.
Di seguito vengono descritte più nel dettaglio ciascuna di queste opzioni.
Opzione 1: passa a un portale integrato Apigee
Chi dovrebbe prendere in considerazione questa opzione?
Fornitori di API che utilizzano Drupal 7 con una quantità minima di personalizzazione o che preferiscono una soluzione all-in-one più orientata alla configurazione con un costo totale di proprietà inferiore.
Il portale per sviluppatori integrato direttamente in Apigee Edge include un potente catalogo di API e un sistema di gestione dei contenuti basato su Markdown con efficaci strumenti di gestione dei segmenti di pubblico. Per determinare se il portale integrato potrebbe essere adatto al tuo programma API, contatta il rappresentante dell'account Apigee.
Per indicazioni su come pianificare ed eseguire la migrazione degli asset del portale Drupal 7 al portale integrato, consulta Eseguire la migrazione del portale Drupal 7 al portale integrato.
Opzione 2: esegui la migrazione a Drupal 8
Chi dovrebbe prendere in considerazione questa opzione?
Provider di API che hanno sfruttato le funzionalità di Drupal 7 in combinazione con un elevato grado di personalizzazione e di investimento nella creazione di un'esperienza specifica per gli sviluppatori.
A causa delle differenze principali tra Drupal 7 e Drupal 8, ad esempio il motore di rendering delle pagine, la ricreazione di personalizzazioni simili potrebbe richiedere un discreto grado di personalizzazione. Se prevedi di dover coinvolgere esperti di Drupal 8, il rappresentante dell'account Apigee può consigliarti partner di sviluppo Drupal esperti. Anche se Apigee non fornisce l'hosting per D8P, Pantheon e Acquia hanno esperienza nell'hosting di D8P per i clienti Apigee.
Opzione 3: rimanere su Drupal 7
Chi dovrebbe prendere in considerazione questa opzione?
Provider di API che utilizzano già Drupal 7 e che vogliono semplicemente più tempo per prendere una decisione.
Il progetto Drupal 7 ha pubblicato le tempistiche per l'assistenza a lungo termine (LTS) fino al 2021. Il supporto dei moduli che integrano Drupal 7 con Apigee Edge non è interessato da questo annuncio sull'hosting. Tuttavia, tieni presente che qualsiasi cliente cloud che voglia rimanere su Drupal 7 deve assumersi la responsabilità diretta dell'account con il proprio provider di hosting entro il 31 maggio 2020.
Come faccio a esportare i miei dati (clienti cloud)?
Per esportare i dati di Drupal, consulta la procedura di esportazione di Pantheon o Acquia.
Che cosa succede se non prendo le misure necessarie?
Dopo il 31 maggio 2020, D7P non sarà più disponibile per te e per i tuoi clienti. Non potrai gestire o sviluppare su D7P e i tuoi clienti non potranno accedere al tuo portale D7P. Tutti i portali D7P ospitati su Apigee verranno ritirati dopo il 31 maggio 2020.
Chi devo contattare per ulteriori informazioni o assistenza?
Per richiedere ulteriori dettagli sul termine dell'hosting per il portale per sviluppatori Drupal 7, registra un ticket nel portale di assistenza Apigee con l'oggetto "Portale per sviluppatori basato su Drupal 7 - hosting".
Sono disponibili strumenti o assistenza per la migrazione da D7P a D8P?
Anche se Apigee non fornisce assistenza diretta per Drupal, il rappresentante dell'account Apigee può metterti in contatto con esperti di Drupal che possono aiutarti con la migrazione e lo sviluppo personalizzato.
Sono disponibili strumenti o assistenza per la migrazione di D7P ai portali integrati?
Per indicazioni su come pianificare ed eseguire la migrazione degli asset del portale Drupal 7 al portale integrato, consulta Eseguire la migrazione del portale Drupal 7 al portale integrato.
Sebbene non siano disponibili strumenti per eseguire la migrazione da Drupal al portale gestito da Apigee, Apigee potrebbe essere in grado di aiutarti con la migrazione. I candidati migliori sono quelli che non hanno investito molto nello sviluppo personalizzato che potrebbe non essere trasferito correttamente, ad esempio flussi di lavoro o strumenti di approvazione specifici. Per saperne di più, contatta il rappresentante dell'account Apigee.
Quali modifiche sono state apportate a SmartDocs?
Le seguenti sezioni descrivono le modifiche apportate al nuovo SmartDocs in Drupal 8 rispetto a Drupal 7.
Quali sono le differenze tra la nuova funzionalità SmartDocs e la versione basata su Drupal 7?
Potresti conoscere SmartDocs utilizzati con i portali per sviluppatori Drupal 7. Consulta Utilizzare SmartDocs per documentare le API.
SmartDocs in Drupal 8 offre molte delle funzionalità che ti aspetti nella documentazione di riferimento dell'API e ora viene eseguito direttamente da una specifica OpenAPI. Per ulteriori informazioni, consulta Documentare le API.
La specifica OpenAPI 3.0.x è supportata con SmartDocs?
La specifica OpenAPI 3.0.x è supportata dai nuovi SmartDocs disponibili nel portale Drupal 8. In futuro, prevediamo di migliorare il supporto delle nuove funzionalità della specifica.
Quali tipi di autenticazione sono supportati con SmartDocs?
Il riquadro Prova questa API in SmartDocs funziona con endpoint non sicuri o sicuri che utilizzano l'autenticazione di base, la chiave API o OAuth, in base al metodo di sicurezza definito nella specifica OpenAPI. Per OAuth sono supportati i seguenti flussi: codice di autorizzazione, implicito, password e credenziali client.
SmartDocs è la mia unica opzione per la documentazione dell'API?
SmartDocs è la soluzione pronta all'uso di Apigee per la documentazione delle API basata su una specifica OpenAPI, ma Apigee riconosce che è bene avere opzioni. Per i portali Drupal 8, il modulo Catalogo API supporta soluzioni di rendering aggiuntive, come Swagger UI Field Formatter.