Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
A partir de 31 de maio de 2020, a Apigee não patrocinará mais a hospedagem de portais de desenvolvedores baseados no Drupal 7 (D7P). Antes disso, a partir de 31 de maio de 2019, os clientes precisavam fazer o provisionamento automático de qualquer novo portal baseado no Drupal.
Quais mudanças estão sendo feitas?
Em abril de 2019, anunciamos o lançamento de equipes de desenvolvedores e públicos-alvo para o portal de desenvolvedores integrado da Apigee. Em maio de 2019, anunciamos a prontidão para produção dos portais baseados no Drupal 8 (D8P), que fornecem uma nova alternativa de portal gerenciado pelo cliente ao portal integrado gerenciado pela Apigee e inclui o novo SmartDocs. Simultaneamente ao anúncio do D8P, anunciamos o fim da hospedagem do D7P em 12 meses. Além disso, os scripts de instalação e upgrade da nuvem privada D7P serão removidos na versão 20.06.
Por que a hospedagem patrocinada pela Apigee para portais de desenvolvedores baseados no Drupal 7 está terminando?
A hospedagem patrocinada pela Apigee para 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 para quem quer permanecer na pista do Drupal. Embora a 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 do desenvolvedor autogerenciado.
O que eu preciso fazer?
Os clientes da Apigee D7P precisam avaliar as alternativas disponíveis e estabelecer uma relação direta com um provedor de hospedagem preferido, 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:
- Migre para os portais integrados da Apigee.
- Migre para o Drupal 8.
- Permaneça no Drupal 7 e assuma a responsabilidade pela hospedagem até 31 de maio de 2020.
Os clientes de nuvem privada que usam D7P têm duas opções:
- Migre para o Drupal 8.
- Permaneça no Drupal 7 por enquanto.
Cada uma dessas opções é discutida com 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 uma quantidade mínima de personalização ou aqueles que preferem uma solução completa mais orientada à configuração com um custo total de propriedade menor.
O portal do desenvolvedor integrado diretamente ao Apigee Edge inclui um catálogo avançado de APIs e um sistema atraente de gerenciamento de conteúdo baseado em Markdown com ferramentas robustas de gerenciamento de público. Para determinar se o portal integrado é adequado para seu programa de APIs, entre em contato com o representante da conta da Apigee.
Para saber como planejar e executar a migração dos recursos do portal do Drupal 7 para o portal integrado, consulte Como migrar o 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 o desenvolvedor.
Devido às grandes 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ê prevê a necessidade de envolver os especialistas do Drupal 8, o representante da conta da Apigee pode recomendar parceiros especializados em desenvolvimento do Drupal para você. Embora a Apigee não forneça hospedagem para D8P, a Pantheon e a Acquia têm experiência nessa hospedagem 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 querem mais tempo para tomar uma decisão.
O projeto Drupal 7 publicou cronogramas para suporte de longo prazo (LTS) até 2021. O suporte dos módulos que integram o Drupal 7 ao Apigee Edge não é afetado por este anúncio de hospedagem. No entanto, qualquer cliente da nuvem que quiser permanecer no Drupal 7 precisará 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 da nuvem)?
Para exportar os dados do Drupal, consulte o processo de exportação do Pantheon ou do Acquia.
O que vai acontecer se eu não realizar as ações necessárias?
Após 31 de maio de 2020, o D7P ficará indisponí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 falar para conseguir mais informações ou ajuda?
Para solicitar mais detalhes sobre o fim da hospedagem do D7P, registre um tíquete no Portal de suporte da Apigee com o assunto "Portal do desenvolvedor baseado em Drupal 7: hospedagem".
Existe alguma ferramenta ou suporte disponível para ajudar na migração do D7P para o D8P?
Embora a Apigee não forneça suporte direto para o Drupal, o representante da conta da Apigee pode conectar você aos especialistas do Drupal que podem ajudar na migração e no desenvolvimento personalizado.
Existe alguma ferramenta ou suporte disponível para ajudar na migração do D7P para portais integrados?
Para saber como planejar e executar a migração dos recursos do portal do Drupal 7 para o portal integrado, consulte Como migrar o 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 no desenvolvimento personalizado que podem não ser bem transferidos, como fluxos de trabalho específicos ou ferramentas de aprovação. Entre em contato com seu representante da conta da Apigee para mais informações.
Quais alterações foram feitas no SmartDocs?
As seções a seguir descrevem as mudanças que foram feitas nos novos SmartDocs do Drupal 8 em comparação com o 7.
Como o novo recurso SmartDocs se compara à versão baseada no Drupal 7?
Talvez você já conheça o SmartDocs usado com os portais de desenvolvedores do Drupal 7. Consulte Como usar o SmartDocs para documentar APIs.
O SmartDocs no Drupal 8 oferece muitos dos recursos que você pode esperar na documentação de referência da API e agora é executado diretamente de uma especificação OpenAPI. Para mais informações, consulte Documentar suas APIs.
A especificação OpenAPI 3.0.x é compatível com o SmartDocs?
A especificação OpenAPI 3.0.x (link em inglês) é compatível com os novos SmartDocs disponíveis no portal Drupal 8. Espera-se um suporte aprimorado para os novos recursos da especificação no futuro.
Que tipos de autenticação são compatíveis com o SmartDocs?
O painel "Testar esta API" no SmartDocs funciona com endpoints não seguros ou protegidos que usam a autenticação básica, de chave de API ou 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 da API?
O SmartDocs é a solução pronta para uso da Apigee para documentação de APIs orientada por uma especificação OpenAPI, mas a Apigee reconhece que é bom ter opções. Para portais do Drupal 8, o módulo do catálogo de APIs oferece suporte a outras soluções de renderização, como o Formatador de campos da IU do Swagger (em inglês).