您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
自 2020 年 5 月 31 日起,Apigee 将不再赞助基于 Drupal 7 的开发者门户 (D7P)。在此之前,自 2019 年 5 月 31 日起,客户必须自行配置所有基于 Drupal 的新门户。
会进行哪些更改?
2019 年 4 月,我们宣布为 Apigee 集成式开发者门户推出 开发者团队和受众群体。2019 年 5 月,我们宣布基于 Drupal 8 的门户 (D8P) 已进入生产就绪状态,此门户为 Apigee 管理的集成门户提供了新的客户管理门户替代方案,并且包含新的 SmartDocs。在发布 D8P 的同时,我们还宣布将在 12 个月内停止托管 D7P,并从 20.06 版本中移除私有云 D7P 的安装和升级脚本。
为什么 Apigee 对基于 Drupal 7 的开发者门户的托管方式将终止?
Apigee 赞助的 D7P 托管将于 2020 年 5 月结束,原因有两个:
- Apigee 的 集成式门户具有高级功能和更低的总拥有成本,已成为客户极具吸引力的选择。
- Drupal 8 代表希望留在 Drupal 轨道上的用户不断前行。虽然从 D7P 迁移到 D8P 的过程非常重要,但对于更喜欢自行管理开发者门户的客户,D8P 提供了一个更好的发展轨迹。
您需要采取什么行动?
Apigee D7P 客户应评估可用的替代方案,并与首选托管服务提供商(如 Pantheon 或 Acquia)建立直接关系,或考虑其他托管方案。
有哪些可选方案可供考虑?
使用 D7P 的云客户有以下三种选择:
- 迁移到 Apigee 的集成式门户。
- 迁移到 Drupal 8。
- 在 2020 年 5 月 31 日之前继续使用 Drupal 7,并承担托管责任。
使用 D7P 的私有云客户有两种选择:
- 迁移到 Drupal 8。
- 现在继续使用 Drupal 7。
下文将更详细地介绍上述各个选项。
方案 1:迁移到 Apigee 集成式门户
哪些人应考虑这一点?
以下 API 提供商使用 Drupal 7 实现了尽可能少的自定义,或者更喜欢一体化解决方案(更注重配置且总拥有成本更低)。
直接集成到 Apigee Edge 中的开发者门户包括一个强大的 API 目录、一个极具吸引力的基于 Markdown 的内容管理系统,以及强大的受众群体管理工具。如需确定集成式门户是否适合您的 API 计划,请与您的 Apigee 客户代表联系。
如需了解如何规划和执行将 Drupal 7 门户资源迁移到集成式门户的指导,请参阅将 Drupal 7 门户迁移到集成式门户。
方案 2:迁移到 Drupal 8
哪些人应考虑这一点?
API 提供方:充分利用 Drupal 7 的功能,并高度定制化并投入资源打造特定的开发者体验。
由于 Drupal 7 和 Drupal 8(例如页面呈现引擎)之间存在重大差异,因此重新创建类似的自定义设置可能需要进行大量自定义工作。 如果您预计需要聘请 Drupal 8 专家,您的 Apigee 客户代表可以为您推荐专业的 Drupal 开发合作伙伴。虽然 Apigee 不提供 D8P 托管,但 Pantheon 和 Acquia 拥有为 Apigee 客户托管 D8P 的经验。
选项 3:继续使用 Drupal 7
哪些人应考虑这一点?
已经在使用 Drupal 7 的 API 提供方,只是希望有更多时间来做出决定。
Drupal 7 项目已发布涵盖 2021 年长期支持 (LTS) 的时间表。对将 Drupal 7 与 Apigee Edge 集成的模块的支持不受此托管公告的影响。但请注意,任何希望继续使用 Drupal 7 的云客户都必须在 2020 年 5 月 31 日之前向托管服务提供商直接承担帐号责任。
如何导出我的数据(云客户)?
如需导出您的 Drupal 数据,请参阅 Pupal 数据或 Acquia 导出流程。
如果我没有采取必要的措施,会出现什么情况?
2020 年 5 月 31 日之后,您和您的客户将无法再使用 D7P。您将无法管理 D7P 或开发 D7P,并且您的客户将无法登录您的 D7P 门户。Apigee 托管的所有 D7P 门户将于 2020 年 5 月 31 日之后停用。
我应该与谁联系以获取更多信息或帮助?
如需请求有关终止 D7P 托管的其他详细信息,请在 Apigee 支持门户中提交一个主题为“基于 Drupal 7 的开发者门户 - 托管”的工单。
是否有任何工具或支持可以帮助您从 D7P 迁移到 D8P?
虽然 Apigee 不直接为 Drupal 提供支持,但您的 Apigee 客户代表可以为您转接 Drupal 专家,他们可以协助您进行迁移和自定义开发。
是否有任何工具或支持可帮助您将 D7P 迁移到集成门户?
如需了解如何规划和执行将 Drupal 7 门户资源迁移到集成式门户的指导,请参阅将 Drupal 7 门户迁移到集成式门户。
虽然没有工具可以从 Drupal 迁移到由 Apigee 管理的门户,但 Apigee 或许能够帮助您完成迁移。最佳候选对象是未在自定义开发(例如特定工作流或审批工具)方面投入大量资金、但可能无法顺利迁移的应用。如需了解详情,请与您的 Apigee 客户代表联系。
SmartDocs 有哪些变化?
以下部分介绍了与 Drupal 7 相比,Drupal 8 中的新版 SmartDocs 有哪些变化。
新的 SmartDocs 功能与基于 Drupal 7 的版本相比如何?
您可能比较熟悉与 Drupal 7 开发者门户搭配使用的 SmartDocs。请参阅使用 SmartDocs 记录 API。
Drupal 8 中的 SmartDocs 提供了 API 参考文档中提供的许多功能,现在可直接从 OpenAPI 规范中运行。如需了解详情,请参阅记录 API。
SmartDocs 是否支持 OpenAPI 规范 3.0.x?
Drupal 8 门户中提供的新 SmartDocs 支持 OpenAPI 规范 3.0.x。我们希望未来能够更好地支持该规范的新功能。
SmartDocs 支持哪些类型的身份验证?
根据您的 OpenAPI 规范中定义的安全方法,SmartDocs 中的“试用此 API”面板支持使用基本身份验证、API 密钥或 OAuth 身份验证的不安全端点或受保护的端点。对于 OAuth,支持以下流程:授权代码、隐式、密码和客户端凭据。
SmartDocs 是我获取 API 文档的唯一选项吗?
SmartDocs 是 Apigee 针对由 OpenAPI 规范驱动的 API 文档推出的开箱即用解决方案,但 Apigee 认识到,选择该选项是不错的选择。 对于 Drupal 8 门户,API 目录模块支持其他渲染解决方案,例如 Swagger 界面字段格式设置工具。