Você está visualizando a documentação do Apigee Edge.
Acesse a
documentação da
Apigee X. info
A partir de 31 de maio de 2020, a Apigee não vai mais patrocinar a hospedagem de portais de desenvolvedores baseados no Drupal 7 (D7P). Antes disso, a partir de 31 de maio de 2019, os clientes precisavam provisionar por conta própria qualquer novo portal baseado em Drupal.
Quais mudanças estão sendo feitas?
Em abril de 2019, anunciamos o lançamento das equipes e públicos-alvo de desenvolvedores para o portal integrado do desenvolvedor do Apigee. Em maio de 2019, anunciamos a disponibilidade para produção dos portais baseados em Drupal 8 (D8P), que oferecem uma nova alternativa de portal gerenciada pelo cliente ao portal integrado gerenciado pela Apigee e inclui os novos SmartDocs. Junto com o anúncio da D8P, também anunciamos o fim da hospedagem da D7P em 12 meses e que os scripts de instalação e upgrade da D7P para a nuvem particular serão removidos na versão 20.06.
Por que a hospedagem patrocinada pela Apigee para portais de desenvolvedores baseados no Drupal 7 está sendo encerrada?
A hospedagem patrocinada pela Apigee para o D7P será encerrada em maio de 2020 por dois motivos:
- Os portais integrados da Apigee se tornaram uma opção atraente para os clientes, com recursos avançados e um custo total de propriedade menor.
- O Drupal 8 representa o caminho a seguir para quem quer continuar no Drupal. Embora o esforço de migração do D7P para o D8P não seja trivial, o D8P oferece uma trajetória melhor para qualquer cliente que prefira um portal de desenvolvedor autogerenciado.
O que eu preciso fazer?
Os clientes do Apigee D7P precisam avaliar as alternativas disponíveis e estabelecer um relacionamento direto com um provedor de hospedagem preferencial, como o Pantheon ou o Acquia, ou considerar outras opções de hospedagem.
Quais são as opções a serem consideradas?
Os clientes do Cloud que usam o D7P têm três opções:
- Mude para os portais integrados da Apigee.
- Migrar para o Drupal 8.
- Permanecer no Drupal 7 e assumir a responsabilidade de hospedagem até 31 de maio de 2020.
Os clientes de nuvem privada que usam o D7P têm duas opções:
- Migrar para o Drupal 8.
- Permaneça no Drupal 7 por enquanto.
Cada uma dessas opções é discutida em mais detalhes abaixo.
Opção 1: migrar para um portal integrado da Apigee
Quem deve considerar isso?
Provedores de API que usam o Drupal 7 com um mínimo de personalização ou que preferem uma solução completa mais orientada à configuração com um custo total de propriedade mais baixo.
O portal do desenvolvedor integrado diretamente ao Apigee Edge inclui um catálogo de APIs poderoso e um sistema de gerenciamento de conteúdo baseado em Markdown com ferramentas robustas de gerenciamento de público-alvo. Para determinar se o portal integrado é adequado para seu programa de API, entre em contato com o representante da conta da Apigee.
Para orientações sobre como planejar e executar a migração dos recursos do portal do Drupal 7 para o portal integrado, consulte Como migrar seu portal do Drupal 7 para o portal integrado.
Opção 2: migrar para o Drupal 8
Quem deve considerar isso?
Provedores de API que aproveitaram a funcionalidade do Drupal 7 com um alto grau de personalização e investimento na criação de uma experiência específica para desenvolvedores.
Devido às principais diferenças entre o Drupal 7 e o Drupal 8, como o mecanismo de renderização de páginas, recriar personalizações semelhantes pode exigir um bom grau de trabalho personalizado. Se você precisar de especialistas em Drupal 8, o representante da conta da Apigee pode recomendar parceiros de desenvolvimento de Drupal. Embora a Apigee não ofereça hospedagem para o D8P, o Pantheon e a Acquia têm experiência na hospedagem do D8P para clientes da Apigee.
Opção 3: permanecer no Drupal 7
Quem deve considerar isso?
Provedores de API que já usam o Drupal 7 e simplesmente querem mais tempo para tomar uma decisão.
O projeto Drupal 7 publicou cronogramas de suporte a longo prazo (LTS) até 2021. O suporte aos módulos que integram o Drupal 7 ao Apigee Edge não é afetado por este anúncio de hospedagem. No entanto, qualquer cliente de nuvem que queira continuar usando o Drupal 7 precisa assumir a responsabilidade direta da conta com o provedor de hospedagem até 31 de maio de 2020.
Como faço para exportar meus dados (clientes do Cloud)?
Para exportar seus dados do Drupal, consulte o processo de exportação do Pantheon ou da Acquia.
O que vai acontecer se eu não fizer as ações necessárias?
Após 31 de maio de 2020, o D7P não estará mais disponível para você e seus clientes. Não será possível administrar ou desenvolver no D7P, e seus clientes não poderão fazer login no portal do D7P. Todos os portais D7P hospedados pela Apigee serão desativados após 31 de maio de 2020.
Com quem posso entrar em contato para receber mais informações ou ajuda?
Para solicitar mais detalhes sobre o encerramento da hospedagem do D7P, registre um tíquete no Portal de suporte da Apigee com o assunto "Portal do desenvolvedor baseado no Drupal 7: hospedagem".
Há ferramentas ou suporte disponíveis para ajudar na migração do D7P para o D8P?
Embora a Apigee não ofereça suporte direto ao Drupal, o representante da conta da Apigee pode conectar você a especialistas em Drupal que podem ajudar na migração e no desenvolvimento personalizado.
Há ferramentas ou suporte disponíveis para ajudar na migração do D7P para portais integrados?
Para orientações sobre como planejar e executar a migração dos recursos do portal do Drupal 7 para o portal integrado, consulte Como migrar seu portal do Drupal 7 para o portal integrado.
Embora não haja ferramentas disponíveis para migrar do Drupal para o portal gerenciado pela Apigee, a Apigee pode ajudar na migração. Os melhores candidatos são aqueles que não investiram muito em desenvolvimentos personalizados que podem não ser transferidos bem, como fluxos de trabalho específicos ou ferramentas de aprovação. Entre em contato com o representante da sua conta da Apigee para mais informações.
Quais mudanças foram feitas no SmartDocs?
As seções a seguir descrevem as mudanças feitas nos novos SmartDocs no Drupal 8 em comparação com o Drupal 7.
Como o novo recurso do SmartDocs se compara à versão baseada no Drupal 7?
Talvez você já conheça o SmartDocs usado com os portais do desenvolvedor do Drupal 7. Consulte Como usar o SmartDocs para documentar APIs.
O SmartDocs no Drupal 8 oferece muitos dos recursos que você espera na documentação de referência da API e agora é executado diretamente em uma especificação da OpenAPI. Para saber mais, consulte Documentar suas APIs.
O SmartDocs oferece suporte à especificação OpenAPI 3.0.x?
A especificação OpenAPI 3.0.x é compatível com o novo SmartDocs disponível no portal do Drupal 8. No futuro, haverá suporte aprimorado para os novos recursos da especificação.
Quais tipos de autenticação são aceitos pelo SmartDocs?
O painel "Testar esta API" no SmartDocs funciona com endpoints não seguros ou protegidos usando a autenticação básica, a chave de API ou a OAuth, com base no método de segurança definido na especificação OpenAPI. Para OAuth, os seguintes fluxos são compatíveis: código de autorização, implícito, senha e credenciais do cliente.
O SmartDocs é minha única opção para documentação de API?
O SmartDocs é a solução pronta da Apigee para documentação de API orientada por uma especificação da OpenAPI, mas a Apigee reconhece que é bom ter opções. Para portais do Drupal 8, o módulo catálogo de APIs oferece suporte a outras soluções de renderização, como o formatador de campos da interface Swagger.